HTML5 的 Geolocation API 讓網頁得以取得使用者當前的位置資訊。前提是瀏覽器支援、且裝置具備定位能力;在行動裝置上,這組 API 幾乎是各類「附近店家」「配送範圍」功能的起點。
HTML5 在 window.navigator 上新增了 geolocation 屬性,底下有三個方法:getCurrentPosition、watchPosition 與 clearWatch。
getCurrentPosition(onSuccess, onError, options);
三個參數中,第一個是成功時的回呼函數,會收到一個 position 物件:
navigator.geolocation.getCurrentPosition(function (position) {
// 定位成功,position 為地理位置物件
});
第二個參數是失敗時的回呼函數,用來把錯誤訊息呈現給使用者:
navigator.geolocation.getCurrentPosition(function (position) {
// 定位成功
}, function (error) {
// 定位失敗
});
這個 error 物件有兩個屬性。code 有三種可能值:1 代表使用者拒絕了位置服務、2 代表無法取得位置、3 代表逾時。message 則是一段可讀的錯誤描述字串。
把兩者合起來,就能取出實際座標與精度:
navigator.geolocation.getCurrentPosition(function (position) {
var coords = position.coords;
console.log(coords.latitude); // 緯度
console.log(coords.longitude); // 經度
console.log(coords.accuracy); // 經緯度精度,單位為公尺
}, function (error) {
var errorTypes = {
1: '位置服務被拒絕',
2: '無法取得位置資訊',
3: '取得資訊逾時'
};
alert(errorTypes[error.code]);
});
這個參數可以省略,但用好它往往比反覆重試更有效。
enableHighAccuracy:是否要求高精度的位置。精度越高越耗電、也越慢,在行動裝置上必須與電量、場景一併權衡。多數情況保留預設值即可,只有在導航類應用才真的需要打開。
timeout:這次定位作業的逾時上限(毫秒)。超過就回傳錯誤,避免使用者對著轉圈的畫面乾等。
maximumAge:位置的快取有效期(毫秒)。例如設為 120000,代表兩分鐘內重複呼叫會直接回傳快取值,不再重新定位。設為 0 則無條件重新取得。
需要隨時掌握位置變化時(例如跑步記錄、外送進度),用 watchPosition 取代單次取得:
watchPosition(onSuccess, onError, options);
三個參數的意義與 getCurrentPosition 完全相同,差別在於它會定期自動重新定位,並回傳一個 id。這個 id 的用法與 setInterval 的回傳值類似,交給 clearWatch 即可停止追蹤:
clearWatch(watchId);
成功回呼收到的 position,其中 coords 帶有這些欄位:
latitude:目前位置的緯度。
longitude:目前位置的經度。
altitude:海拔高度,取不到時為 null。
accuracy:經緯度的精度,單位為公尺。
altitudeAccuracy:海拔高度的精度,單位為公尺。
speed:裝置移動速度,單位為公尺/秒,取不到時為 null。
timestamp:取得這筆位置資訊的時間。
注意 accuracy 是「半徑」的概念:它代表以回傳座標為圓心、真實位置有某個機率落在這個範圍內。數字越大代表越不準,介面上若要畫一個藍點與光圈,光圈半徑通常就取自這個值。
把上述元素組起來,加上瀏覽器支援偵測與錯誤分支,就是一份可直接使用的程式:
function get_location() {
if (navigator.geolocation) {
navigator.geolocation.getCurrentPosition(function (position) {
var longitude = position.coords.longitude,
latitude = position.coords.latitude;
showObject(position.coords, 0);
}, function (err) {
switch (err.code) {
case 1:
alert('位置服務被拒絕。');
break;
case 2:
alert('暫時無法取得位置資訊。');
break;
case 3:
alert('取得資訊逾時。');
break;
default:
alert('未知錯誤。');
break;
}
}, {
enableHighAccuracy: true,
maximumAge: 100
});
} else {
alert('你的瀏覽器不支援以 HTML5 取得地理位置資訊。');
}
}
get_location();
執行後會像下圖這樣把 coords 的內容逐一列出:

第一,這組 API 一律需要使用者明確授權,且只在 HTTPS(或 localhost)環境下可用,明文 HTTP 頁面會直接被瀏覽器擋掉。
第二,永遠要寫好失敗分支。使用者拒絕、室內訊號差、裝置沒有 GPS,都是日常會發生的事,功能應該優雅降級而不是卡死。
第三,位置屬於敏感資料。只取用你真正需要的精度,別在背景持續追蹤,也别把座標留存得比業務需求更久。