HTML5 的 Geolocation API 讓網頁能取得使用者的經緯度,找附近的店、顯示區域天氣、記錄運動路線都靠它。API 本身非常精簡,一個方法就能拿到座標。
<!DOCTYPE HTML>
<html>
<head>
<meta charset="UTF-8">
<title>取得座標</title>
</head>
<body>
<div id="demo">點擊下面的按鈕,取得您的座標:</div>
<button onclick="getLocation()">試一下</button>
<script type="text/javascript">
var x = document.getElementById("demo");
function getLocation() {
if (navigator.geolocation) {
navigator.geolocation.getCurrentPosition(showPosition);
} else {
x.innerHTML = "瀏覽器不支援此功能!";
}
}
function showPosition(position) {
x.innerHTML = "Latitude: " + position.coords.latitude +
"<br/>Longitude: " + position.coords.longitude;
}
</script>
</body>
</html>
先判斷 navigator.geolocation 是否存在,不支援就給一段提示——這一步不能省,因為在不支援的瀏覽器上直接呼叫會丟出錯誤。
接著呼叫 getCurrentPosition(showPosition)。注意它是非同步的:瀏覽器需要時間向定位服務詢問,所以結果會透過回呼函式 showPosition 回傳,而不是直接 return。這也是為什麼很多人寫完程式發現 position 是 undefined——他們試著用同步的方式取值。
position.coords.latitude // 緯度
position.coords.longitude // 經度
position.coords.accuracy // 精確度(公尺)
position.coords.altitude // 海拔,可能為 null
position.coords.altitudeAccuracy // 海拔精確度
position.coords.heading // 行进方向,0~360 度
position.coords.speed // 速度(公尺/秒)
position.timestamp // 這筆定位的時間
實務上 accuracy 一定要拿出來用。它代表這個座標可能的誤差範圍,若數字達到數千公尺,代表只定位到基地台或 IP 等級,拿來標記在地圖上會偏得很離,此時應該提示使用者或改用其他方式。
navigator.geolocation.getCurrentPosition(
onSuccess,
onError,
{
enableHighAccuracy: true, // 要求更高精度(更耗電、更慢)
timeout: 10000, // 最多等 10 秒
maximumAge: 60000 // 可接受 60 秒內的快取結果
}
);
onError 會收到一個錯誤碼:1 代表使用者拒絕授權、2 代表無法取得位置、3 代表逾時。做產品時這三種情況都該有對應的 UI 回饋,尤其是第一種——使用者按了「不允許」之後,就必須引導他們到瀏覽器設定裡手動開啟。
在 IE9、Firefox、Chrome、Opera 上都能成功取得座標,Safari 5.x 則無法回傳。成功的幾個瀏覽器中,Chrome 反應最快,接著是 Opera、IE9,Firefox 反而最慢。
補充一點背景:定位速度差異這麼大,通常不是瀏覽器本身的問題,而是背後使用的定位服務不同。桌面環境多半靠 Wi-Fi 基地台資料庫比對,速度取決於該服務的資料完整度;Firefox 早期使用 Google 的定位服務,後來改為自有方案,不同時間點測出來的快慢會不一樣。行動裝置則多半直接走 GPS 或融合定位,表現又是另一回事。
第一,一定要在 HTTPS 下使用。現代瀏覽器已把 Geolocation 列為需要安全內容的功能,在 http 頁面上呼叫會直接被拒絕,這與程式碼寫得對不對無關。
第二,若需要持續追蹤(例如跑步記錄),改用 watchPosition(),它會在位置改變時反覆呼叫回呼;用完記得呼叫 clearWatch() 取消,否則會一直耗電。