
HTML5 的 navigator.geolocation 讓網頁能取得使用者的經緯度。瀏覽器只負責回報座標,若要知道「這是哪個縣市哪個鄉鎮」,還需要搭配地圖服務的反向地理編碼 API。以下範例用百度地圖的 Geocoding 介面把座標換算成行政區。
/**
* 取得地理位置
*/
function getLocation() {
// 檢查瀏覽器是否支援地理位置
if (navigator.geolocation) {
var config = { enableHighAccuracy: true, timeout: 5000, maximumAge: 30000 };
// 成功呼叫 showPosition,失敗呼叫 showError
navigator.geolocation.getCurrentPosition(showPosition, showError, config);
} else {
alert("此瀏覽器不支援定位,或使用者已停用位置權限");
}
}
/**
* 定位成功
*/
function showPosition(position) {
var x = position.coords.latitude;
var y = position.coords.longitude;
// 呼叫地圖服務做反向地理編碼
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 () {
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';
}
一定要用 HTTPS。現代瀏覽器已把 Geolocation 列為需要安全內容的 API,在 http 頁面呼叫會直接被拒絕。這段範例寫於當時,現在必須加上這個前提。
務必處理使用者拒絕的情況。定位屬於隱私敏感功能,使用者按下「不要」是很正常的。程式中 PERMISSION_DENIED 的分支不是裝飾,而是主要的失敗路徑,應該提供手動輸入或選擇的替代方案。
三個設定參數的意義:enableHighAccuracy 為 true 時會要求更高精度(可能改用 GPS,較耗電也較慢);timeout 是等待上限;maximumAge 允許回傳幾毫秒以內的快取值,設大一點能加快回應但精度較舊。
API Key 要自己申請。範例中的 ak 參數必須向地圖服務商申請,不能直接沿用他人金鑰;正式環境建議把這類呼叫放到自己的後端代理,避免金鑰曝光在客戶端。
注意座標系統差異。不同地圖服務使用的座標系(WGS84、GCJ-02、BD-09)並不相同,混用會導致數百公尺的偏移,跨服務整合時需要轉換。