|
再拿百度地圖API來說，如果開發(fā)者想創(chuàng)建一個(gè)簡單的地圖，他需要了解如下內(nèi)容：
如何引用API（加載JavaScript）。
地圖坐標(biāo)和級(jí)別的概念。
知道通過BMap.Map類創(chuàng)建地圖實(shí)例，并且通過centerAndZoom方法進(jìn)行初始化。
知道通過BMap.Point類創(chuàng)建坐標(biāo)實(shí)例。
可以看出，地圖API的學(xué)習(xí)風(fēng)格接近于第一種，屬于漸進(jìn)式的。開發(fā)者僅需要了解少量的接口和一些概念就能完成任務(wù)了。
不同的開發(fā)者可能喜歡不同的學(xué)習(xí)方式，比如有些人喜歡漸進(jìn)式的，希望編寫少量代碼就能立刻看到成果，在此基礎(chǔ)上逐步學(xué)習(xí)API中的其他接口。
另外一些開發(fā)人員希望在使用API之前能從一個(gè)較高的層次上了解其架構(gòu)，喜歡從整體把握，接著再尋找解決任務(wù)的最佳方案。
在一套API中，兩種不同的學(xué)習(xí)風(fēng)格可以共存
Working Framework
What is the size of the conceptual chunk needed to work effectively.
該維度描述了開發(fā)者在使用API的過程中需要了解（keep track of）的信息量有多少，即開發(fā)者使用API時(shí)的工作框架是什么樣的比如，在通過BMap.Map類創(chuàng)建一個(gè)地圖實(shí)例時(shí)，開發(fā)者可以指定地圖所使用的坐標(biāo)系統(tǒng)是經(jīng)緯度還是墨卡托，一旦確定下來并創(chuàng)建地圖后。這個(gè)坐標(biāo)系統(tǒng)就是開發(fā)者需要了解的信息。
如果在后續(xù)開發(fā)中，需要添加一些標(biāo)注、折線到地圖上，開發(fā)者就要保證標(biāo)注、折線的坐標(biāo)與地圖當(dāng)前的坐標(biāo)系統(tǒng)一致，否則程序就會(huì)出問題。
在API中，working framework的形式主要有以下三種：
如果信息可通過API本身來表示，那么工作框架是本地（Local）式的。
如果信息不通直接通過API來表示，但是可通過開發(fā)者的代碼結(jié)構(gòu)體現(xiàn)，這時(shí)工作框架是全局（global）式的。
如果信息既不能通過API本身來表示，也不能在代碼結(jié)構(gòu)中體現(xiàn)，那么工作框架是系統(tǒng)（system）式的。
不同的開發(fā)者可以適應(yīng)不同的工作框架模式，只要在他們的可接受范圍內(nèi)就行
Work Step Unit How much of a programming task must/can be completed in a single step.
這個(gè)維度描述了開發(fā)者完成特定任務(wù)所需要的步驟有多少，可以簡稱為工作單元
比如用戶想在地圖上添加自定義的標(biāo)注，這個(gè)任務(wù)可通過以下三個(gè)步驟（不包含地圖創(chuàng)建過程）完成：
創(chuàng)建一個(gè)圖標(biāo)對象。
創(chuàng)建一個(gè)標(biāo)注，并設(shè)置其圖標(biāo)。
向地圖添加標(biāo)注
下面我們將詳細(xì)描述每一個(gè)步驟開發(fā)者需要做哪些事情。這些事情包括一個(gè)代碼塊的編寫或者創(chuàng)建了多少個(gè)類以及一些其他相關(guān)的工作。對于上面的例子，我們可進(jìn)行如下描述：
步驟 工作內(nèi)容
創(chuàng)建一個(gè)圖標(biāo)對象 創(chuàng)建一個(gè)BMap.Icon實(shí)例。傳遞一個(gè)圖片路徑、指定圖片的寬和高、指定圖片的錨點(diǎn)位置（即哪個(gè)點(diǎn)對應(yīng)實(shí)際的坐標(biāo)點(diǎn)）。
相關(guān)工作都是和BMap.Icon相關(guān)的，沒有涉及其他內(nèi)容，這里僅需要一行代碼。
創(chuàng)建一個(gè)標(biāo)注，并設(shè)置其圖標(biāo) 創(chuàng)建一個(gè)BMap.Marker實(shí)例。傳遞一個(gè)坐標(biāo)點(diǎn)，并指定使用的圖標(biāo)對象。僅需要一行代碼 向地圖添加標(biāo)注 調(diào)用Map.addOverlay方法，將標(biāo)注實(shí)例作為參數(shù)，添加到地圖上。
出處：百度泛用戶體驗(yàn)
責(zé)任編輯：bluehearts
上一頁 認(rèn)知維度與API的可用性評估 [3] 下一頁 認(rèn)知維度與API的可用性評估 [5]
◎進(jìn)入論壇網(wǎng)頁制作、WEB標(biāo)準(zhǔn)化版塊參加討論，我還想發(fā)表評論。
|
第 1 頁 
第 4 頁 認(rèn)知維度與API的可用性評估 [4]
