再拿百度地图API来说，如果开发者想创建一个简单的地图，他需要了解如下内容：
如何引用API（加载JavaScript）。

地图坐标和级别的概念。

知道通过BMap.Map类创建地图实例，并且通过centerAndZoom方法进行初始化。
知道通过BMap.Point类创建坐标实例。

可以看出，地图API的学习风格接近于第一种，属于渐进式的。开发者仅需要了解少量的接口和一些概念就能完成任务了。

不同的开发者可能喜欢不同的学习方式，比如有些人喜欢渐进式的，希望编写少量代码就能立刻看到成果，在此基础上逐步学习API中的其他接口。

另外一些开发人员希望在使用API之前能从一个较高的层次上了解其架构，喜欢从整体把握，接着再寻找解决任务的最佳方案。

在一套API中，两种不同的学习风格可以共存

Working Framework

What is the size of the conceptual chunk needed to work effectively.

该维度描述了开发者在使用API的过程中需要了解（keep track of）的信息量有多少，即开发者使用API时的工作框架是什么样的比如，在通过BMap.Map类创建一个地图实例时，开发者可以指定地图所使用的坐标系统是经纬度还是墨卡托，一旦确定下来并创建地图后。这个坐标系统就是开发者需要了解的信息。

如果在后续开发中，需要添加一些标注、折线到地图上，开发者就要保证标注、折线的坐标与地图当前的坐标系统一致，否则程序就会出问题。

在API中，working framework的形式主要有以下三种：

如果信息可通过API本身来表示，那么工作框架是本地（Local）式的。

如果信息不通直接通过API来表示，但是可通过开发者的代码结构体现，这时工作框架是全局（global）式的。

如果信息既不能通过API本身来表示，也不能在代码结构中体现，那么工作框架是系统（system）式的。

不同的开发者可以适应不同的工作框架模式，只要在他们的可接受范围内就行

Work Step Unit How much of a programming task must/can be completed in a single step.

这个维度描述了开发者完成特定任务所需要的步骤有多少，可以简称为工作单元
比如用户想在地图上添加自定义的标注，这个任务可通过以下三个步骤（不包含地图创建过程）完成：

创建一个图标对象。

创建一个标注，并设置其图标。

向地图添加标注

下面我们将详细描述每一个步骤开发者需要做哪些事情。这些事情包括一个代码块的编写或者创建了多少个类以及一些其他相关的工作。对于上面的例子，我们可进行如下描述：

步骤  工作内容 

创建一个图标对象 创建一个BMap.Icon实例。传递一个图片路径、指定图片的宽和高、指定图片的锚点位置（即哪个点对应实际的坐标点）。

相关工作都是和BMap.Icon相关的，没有涉及其他内容，这里仅需要一行代码。
创建一个标注，并设置其图标 创建一个BMap.Marker实例。传递一个坐标点，并指定使用的图标对象。仅需要一行代码 向地图添加标注 调用Map.addOverlay方法，将标注实例作为参数，添加到地图上。

出处：百度泛用户体验
责任编辑：bluehearts

上一页 认知维度与API的可用性评估 [3] 下一页 认知维度与API的可用性评估 [5]

◎进入论坛网页制作、WEB标准化版块参加讨论，我还想发表评论。