HTML5 的 Geolocation API 讓瀏覽器能取得使用者目前的位置。典型應用是表單上的「使用目前位置」按鈕,使用者點一下就不用手打地址。下面的範例不只取得經緯度,還進一步呼叫地圖服務做反向地理編碼,把座標還原成「省市區」的文字地址填進欄位。
/**
* 取得地理位置
*/
function getLocation() {
// 檢查瀏覽器是否支援地理位置
if (navigator.geolocation) {
// 支援則呼叫 showPosition(),失敗時呼叫 showError
var config = {
enableHighAccuracy: true, // 盡量取得高精度位置
timeout: 5000, // 5 秒逾時
maximumAge: 30000 // 30 秒內的暫存位置可接受
};
navigator.geolocation.getCurrentPosition(showPosition, showError, config);
} else {
alert("此瀏覽器不支援定位功能");
}
}
/**
* 定位成功:取得經緯度後做反向地理編碼
*/
function showPosition(position) {
var x = position.coords.latitude; // 緯度
var y = position.coords.longitude; // 經度
// 呼叫地圖服務的逆地理編碼 API
var url = "https://api.map.baidu.com/geocoder/v2/?ak=YOUR_AK"
+ "&callback=renderReverse"
+ "&location=" + x + "," + y
+ "&output=json"
+ "&pois=0";
$.ajax({
type: "GET",
dataType: "jsonp",
url: url,
success: function (json) {
if (json == null || typeof (json) == "undefined") return;
if (json.status != "0") return;
setAddress(json.result.addressComponent);
},
error: function (XMLHttpRequest, textStatus, errorThrown) {
alert("[" + x + ", " + y + "] 地址解析失敗,請手動選擇地址");
}
});
}
/**
* 定位失敗的錯誤處理
*/
function showError(error) {
switch (error.code) {
case error.PERMISSION_DENIED:
alert("定位失敗:使用者拒絕了定位請求");
break;
case error.POSITION_UNAVAILABLE:
alert("定位失敗:位置資訊暫時無法取得");
break;
case error.TIMEOUT:
alert("定位失敗:取得位置的請求逾時");
break;
case error.UNKNOWN_ERROR:
alert("定位失敗:發生未知錯誤");
break;
}
}
/**
* 把解析出的行政區資料填進欄位
*/
function setAddress(json) {
var position = document.getElementById("txtPosition");
var province = json.province; // 省
var city = json.city; // 市
var district = json.district; // 區
province = province.replace('市', '');
position.value = province + "," + city + "," + district;
position.style.color = 'black';
}
enableHighAccuracy:設為 true 會要求瀏覽器盡量使用 GPS 等高精度來源,定位較準但更耗電、也更慢。表單填地址時值得開啟;只是想知道大約在哪個城市時可以設 false。
timeout:等待定位結果的最長毫秒數。設太短容易在正常情況下就逾時,設太長則使用者會覺得卡住,5000~10000 是常見範圍。
maximumAge:允許使用多久以內的快取值。設大一點可以讓連續呼叫時回應更快、更省電,代價是位置可能不是即時的。
PERMISSION_DENIED 代表使用者按了「不要」,這是線上最常見的一種,此時應該改用讓使用者手動選擇的降級方案;POSITION_UNAVAILABLE 通常是訊號或硬體問題;TIMEOUT 表示逾時;UNKNOWN_ERROR 是其他未知狀況。把這四種情況都寫清楚,比只寫一個 alert 友善得多。
這份程式碼有幾處需要處理才能正式使用。第一,必須在 HTTPS 環境下執行,現代瀏覽器已全面禁止在 HTTP 明文網頁中呼叫定位 API。第二,API 的 ak(金鑰)請自行申請並更換,範例中的字串只是佔位,請勿沿用他人金鑰,也要注意後端限定網域以免被盜用。第三,該服務的接口位址與參數規格可能已有變動,建議對照官方最新文件調整。第四,取得座標後記得提醒使用者確認——定位可能有幾十公尺的誤差,直接自動帶入然後送出訂單風險不小。最後,記得在隱私政策中說明你如何使用位置資訊,多地法規(包括歐盟 GDPR)都要求事先告知並取得同意。