做行動端網頁時常見的需求:進頁面就自動定位使用者,並在地圖正中央打一支圖釘。看似簡單,但直接拿 GPS 座標丟給百度地圖會發現位置偏掉幾百公尺。本文說明完整的三步流程與那個關鍵的中間步驟。
navigator.geolocation.getCurrentPosition(callback);
成功後會執行 callback,參數就是座標物件。
如果跳過這步,地圖會顯示在錯誤的位置。原因是我國使用的座標系統有多層轉換:GPS 原始值是 WGS-84,國你如果直接拿去疊在審圖後的地圖上,會因為加密偏移而出現可觀的誤差;百度使用的則是自家的 BD-09。百度 API 已內建轉換工具:
BMap.Convertor.translate(gpsPoint, 0, callback); // gpsPoint:轉換前座標 // 第二個參數 0 代表「GPS 座標 → 百度座標」 // callback:回呼函數,參數為轉換後的新座標點
單點轉換需引入 convertor.js;若要批次轉換大量座標,則改用 changeMore.js。這個範例只需要前者。
<!DOCTYPE Html>
<Html lang="zh-cn">
<head>
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<meta http-equiv="Content-Type" content="text/Html; charset=utf-8" />
<title>定位並顯示於地圖</title>
<style type="text/CSS">
* { height: 100%; } /* 一定要設,否則地圖會顯示不出來 */
</style>
<script type="text/Javascript"
src="https://api.map.baidu.com/api?v=2.0&ak=你的AK"></script>
<script type="text/Javascript"
src="https://developer.baidu.com/map/jsdemo/demo/convertor.JS"></script>
<script>
navigator.geolocation.getCurrentPosition(translatePoint); // 定位
function translatePoint(position) {
var currentLat = position.coords.latitude;
var currentLon = position.coords.longitude;
var gpsPoint = new BMap.Point(currentLon, currentLat); // 注意:先經度後緯度
BMap.Convertor.translate(gpsPoint, 0, initMap); // 轉換座標
}
function initMap(point) {
map = new BMap.Map("map");
map.addControl(new BMap.NavigationControl()); // 縮放滑桿
map.addControl(new BMap.ScaleControl()); // 比例尺
map.addControl(new BMap.OverviewMapControl()); // 小地圖
map.centerAndZoom(point, 15); // 15 級,最大 18 級
map.addOverlay(new BMap.Marker(point));
}
</script>
</head>
<body>
<div id="map"></div>
</body>
</Html>
高度必須明確設定。百度地圖的容器若沒有高度,地圖會完全顯示不出來。範例中的 * { height: 100% } 就是為此,實務上也可以只針對 html, body, #map 設定,並搭配 100vh 更省事。
BMap.Point 的參數順序是「經度、緯度」。這與直覺相反,也與 Geolocation 回傳物件中 latitude 在前的順序相反,很容易寫錯。
桌機定位常常失敗。開發過程中會發現電腦的定位速度慢,經常取不到座標導致地圖空白。建議直接用真實手機測試,速度與成功率都好得多——桌機多半只能靠 Wi-Fi 與 IP 比對,精度是公里級的。
AK 要申請,並綁定來源網域。在百度地圖開放平台申請的 key 需設定可使用的 referer,上線前請改成正式網域,並改用 https 的 API 位址。
範例中沒有引入 jQuery,這在行動端是對的——jQuery 體積偏大。若只需要一點 DOM 操作,用原生 document.getElementById 就夠了;若需要更完整的行動端元件,可考慮更輕量的框架。
另外,定位失敗時目前是靜默的。建議補上錯誤回呼與 timeout 設定,並在未授權時顯示手動選擇地區的備案:
navigator.geolocation.getCurrentPosition(translatePoint, function (err) {
alert('定位失敗,請確認已開啟定位權限');
}, { enableHighAccuracy: true, timeout: 8000, maximumAge: 0 });