想在網頁上放一張地圖,標幾個點。打開文件,幾十個功能、幾百個設定、一堆外掛。
不知道哪些是你真的會用到的。
我手上有 14 支上線的作品用到同一個地圖元件,從瑞士健行到台灣農地到物種分布都有。我把它們的原始碼全掃了一次,逐支列出實際呼叫到的功能。
結果跟文件給人的印象差很遠。
用到的功能 幾支在用 ────────────────────────────────── 地圖底圖 14 自動框住所有點 14 點一下跳說明 12 小圓點(大量點位) 12 圖釘 11 自己畫的圖示 10 連成線(路線) 10 ────────────────────────────────── 抓使用者位置 5 滑過去顯示標籤 4 點太多時自動聚合 2 面、圖層切換、疊圖 1
兩個功能就佔了全部
14 支裡,只有兩件事是每一支都做的:放一張底圖,然後自動把畫面框到剛好看得見所有的點。
第二件常被跳過,但它是使用者體驗差最多的一個。你如果手動寫死中心點和縮放級別,換一批資料就跑掉了。自動框住,資料換了也不用改。
七個功能蓋掉十三支
把清單往下拉到第七項——連成線——累積起來就涵蓋了 14 支裡的 13 支。
再往下的那些:抓使用者位置只有 5 支用(因為多數作品是在家裡規劃,不是在現場)、自動聚合只有 2 支用(點超過幾百個才需要)。
其餘的功能,我 14 支作品一次都沒用到。
真正不一樣的只有一支
面、圖層切換、疊圖這三個功能,全部只有 1 支在用——農地衛星監測那支。因為它要把衛星影像疊在地圖上、要畫出田區的形狀、要讓使用者切換不同月份的影像。
那是真的需要進階用法的場景。另外 13 支都不需要。
還有一個發現我沒預期到:日本、瑞士、多洛米蒂、奧地利那四支健行作品,用到的功能組合完全相同。四個不同國家、不同路線、不同資料,程式用的東西一模一樣。
那不是偷懶。那是找到模式之後就該做的事——第一支花最久,後面四支是把同一套骨架換上不同的資料。
可以拿去改的起點
如果你要做的是「把一批地點畫在地圖上」,你需要的就是這七個,其他先不用看:
1. 底圖 放一張世界地圖當背景 2. 自動框 把畫面調到剛好看得見所有點 3. 圖釘 標單一地點 4. 小圓點 標大量地點(比圖釘輕,幾百個也不卡) 5. 點擊說明 點下去跳出這個點的資訊 6. 自己畫的圖示 用顏色或形狀分類,不用做圖檔 7. 連成線 把一串座標接成路線 前兩個是必備。三到七看你的資料是點還是線。
底圖的來源也值得一提:13 支用的是同一個公開圖磚服務,只有兩支換過——日本那支加了當地官方的地形圖,農地那支加了衛星影像圖磚。換底圖是一行的事,但多數時候你不需要換。
站內延伸
來源: 掃描 14 支上線作品的原始碼,逐支比對實際呼叫的 API,2026-09-17。方法:對每支作品的 .html/.js 檔比對 15 種功能的呼叫特徵,並記下每一筆實際命中的字串供覆核。
看文件會以為要學一百個東西,清點自己真的寫過的程式碼,發現一直在用的只有七個。決定你要學什麼的不是文件的目錄,是你手上那批資料長什麼樣子。 資料是一堆點,你就只需要點的那幾個功能。