HTML5 的 Geolocation API 讓瀏覽器能取得使用者座標,再搭配地圖服務的逆地理編碼,就能把經緯度還原成「某省某市某區某街」這樣的可讀地址。以下是一個可直接執行的完整範例。
<!DOCTYPE html>
<html>
<body>
<p id="demo">點擊這個按鈕,獲得您的位置:</p>
<button onclick="getLocation()">試一下</button>
<script src="https://api.map.baidu.com/api?v=1.4" type="text/javascript"></script>
<script>
var x = document.getElementById("demo");
function getLocation(){
if (navigator.geolocation) {
navigator.geolocation.getCurrentPosition(showPosition);
} else {
alert("您的瀏覽器不支持地理定位");
}
}
function showPosition(position){
var lat = position.coords.latitude;
var lon = position.coords.longitude;
// 建立座標點(百度地圖使用 BD-09 座標系統)
var point = new BMap.Point(lon, lat);
// 逆地理編碼:座標 → 地址描述
var gc = new BMap.Geocoder();
gc.getLocation(point, function(rs){
var addComp = rs.addressComponents;
alert(addComp.province + ", " + addComp.city + ", "
+ addComp.district + ", " + addComp.street);
});
}
</script>
</body>
</html>
第一步:檢查支援。navigator.geolocation 存在與否決定能否繼續,這個判斷不可省略。
第二步:取得座標。getCurrentPosition 是非同步的,成功後會呼叫 showPosition 並傳入 position 物件,其中 coords.latitude 與 coords.longitude 就是經緯度。
第三步:逆地理編碼。BMap.Geocoder 的 getLocation 把座標轉為結構化地址,addressComponents 中分別有 province、city、district、street 等欄位。
這是最容易踩到的坑。HTML5 Geolocation 回報的是 WGS-84 座標(GPS 原始座標),而百度地圖使用 BD-09,兩者之间存在偏移。直接把 WGS-84 的經緯度丟進 BMap.Point,結果會有明顯的位置落差,在中國境內可能偏差數百公尺。
正確做法是先轉換座標系統:WGS-84 → GCJ-02 → BD-09。百度地圖 API 提供了 BMap.Convertor 做這件事:
var convertor = new BMap.Convertor();
convertor.translate(point, 1, 5, function (data){
if (data.status === 0) {
var bdPoint = data.points[0]; // 已轉為 BD-09
// 後續以 bdPoint 進行逆地理編碼
}
});
實際專案中應傳入選項物件並處理錯誤:
navigator.geolocation.getCurrentPosition(
showPosition,
function(err){
switch (err.code) {
case err.PERMISSION_DENIED: alert("使用者拒絕了定位請求"); break;
case err.POSITION_UNAVAILABLE: alert("無法取得位置資訊"); break;
case err.TIMEOUT: alert("定位逾時"); break;
}
},
{ enableHighAccuracy: true, timeout: 10000, maximumAge: 60000 }
);
一、需要 HTTPS。現代瀏覽器只允許在安全環境(HTTPS 或 localhost)中呼叫 Geolocation,用 http 存取會直接被拒。
二、需要使用者同意。瀏覽器會跳出權限提示,使用者按下拒絕就取不到位置。因此務必設計好拒絕後的替代流程,例如讓使用者手動輸入地址。
此外,若只是要顯示地圖而不需要精確定位,考慮到隱私與使用者體驗,讓使用者自行輸入位置往往是更好的選擇。