HTML5 的 Geolocation API 讓網頁得以知道使用者所在位置,天氣、外送、門市查詢這類應用都靠它。本文從特性檢測開始,示範如何抓取經緯度,再把這串抽象數字交給地圖服務的反向地理編碼介面,換成人看得懂的省市區與街道資訊。
第一,這是 HTML5 新增的能力,只有支援的瀏覽器才有;行動裝置(例如 iPhone)因為有 GPS 與基地台資料,定位精準度通常明顯優於桌機。
第二,定位屬於敏感資訊,規範要求必須取得使用者同意。頁面載入時瀏覽器會跳出詢問,使用者按下允許之前,你拿不到任何座標。此外,近年的瀏覽器已把定位功能限制在安全環境(HTTPS 或 localhost)中,用 http 開啟的頁面會直接被拒絕,這一點在部署時特別容易踩到。
function getLocation() {
if (navigator.geolocation) {
navigator.geolocation.getCurrentPosition(showPosition, showError, {
enableHighAccuracy: true, // 盡量取得高精度結果
timeout: 10000, // 逾時時間(毫秒)
maximumAge: 60000 // 允許使用幾毫秒前的快取值
});
} else {
alert('瀏覽器不支援地理定位。');
}
}
getCurrentPosition() 的第一個參數是成功回呼,會收到一個 position 物件;第二個參數是失敗回呼,用來處理各種錯誤碼。
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 showPosition(position) {
var lat = position.coords.latitude; // 緯度
var lng = position.coords.longitude; // 經度
alert('緯度:' + lat + ',經度:' + lng);
}
經緯度對使用者沒有意義,真正有用的是「台北市大安區……」。這件事交給地圖服務的反向地理編碼(reverse geocoding)介面即可:把座標丟過去,它會回傳一段 JSON,裡頭有省市區、街道甚至門牌號。
先在頁面準備兩個容器 #baidu_geo 與 #google_geo,接著改寫 showPosition()。以下範例使用 jQuery 發送請求,記得先載入 jQuery;由於跨網域限制,這類介面通常需以 JSONP 方式呼叫。另外,地圖服務的網址、參數與金鑰申請方式會隨版本調整,實作前請以官方文件為準。
function showPosition(position) {
var latlon = position.coords.latitude + ',' + position.coords.longitude;
var url = 'https://api.map.baidu.com/geocoder/v2/?ak=YOUR_AK&location='
+ latlon + '&output=json&pois=0';
$.ajax({
url: url,
dataType: 'jsonp',
beforeSend: function () {
$('#baidu_geo').html('正在定位...');
},
success: function (json) {
if (json.status == 0) {
$('#baidu_geo').html(json.result.formatted_address);
}
},
error: function () {
$('#baidu_geo').html(latlon + ' 地址位置獲取失敗');
}
});
}
Google 回傳的 JSON 欄位更細緻,可以依需求挑用;實務上通常直接取第一筆的 formatted_address。同樣提醒:這類服務現多需搭配 API 金鑰,且各地區可用性不同。
function showPosition(position) {
var latlon = position.coords.latitude + ',' + position.coords.longitude;
var url = 'https://maps.googleapis.com/maps/api/geocode/json?latlng='
+ latlon + '&language=zh-TW';
$.ajax({
type: 'GET',
url: url,
beforeSend: function () {
$('#google_geo').html('正在定位...');
},
success: function (json) {
if (json.status == 'OK') {
$.each(json.results, function (index, item) {
if (index == 0) {
$('#google_geo').html(item.formatted_address);
}
});
}
},
error: function () {
$('#google_geo').html(latlon + ' 地址位置獲取失敗');
}
});
}
整條流程其實只有三個環節:特性檢測 → getCurrentPosition() 取得座標 → 交給地圖介面換算地址。真正需要花心思的是細節:記得走 HTTPS、記得處理使用者拒絕與逾時、記得為定位失敗準備降級方案(例如讓使用者手動輸入地址),以及不要把定位結果在未告知的情況下送到第三方。