用相對簡單的 JavaScript,就能做出能取得使用者地理位置的 Web 應用,包含經緯度甚至海拔。有些應用甚至能追蹤位置隨時間的變化來提供導航,並整合 Google Maps 這類地圖服務。本文示範如何取得座標,再進一步換算成人看得懂的地址。
定位功能(Geolocation)是 HTML5 的新特性,只能在支援 HTML5 的現代瀏覽器上執行,行動裝置(如 iPhone)上的精度通常更高。使用前必須先偵測瀏覽器是否支援,支援才呼叫定位。
隱私是關鍵:這個特性涉及使用者隱私,除非使用者明確同意,否則位置資訊不可取得。所以頁面會跳出「是否允許定位」的提示,必須使用者按下允許才會繼續。
function getLocation() {
if (navigator.geolocation) {
navigator.geolocation.getCurrentPosition(showPosition, showError);
} else {
alert("瀏覽器不支援地理定位。");
}
}
getCurrentPosition() 的第一個參數是成功時呼叫的函式,會收到一個 coordinates 物件;第二個參數是失敗時呼叫的錯誤處理函式。
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;
}
}
實務上 PERMISSION_DENIED 是最常見的,尤其在 iframe 內或使用者曾經按過「封鎖」之後。這時應引導使用者到瀏覽器設定中手動開放,而不是只跳一個 alert 就結束。
function showPosition(position) {
var lat = position.coords.latitude; // 緯度
var lag = position.coords.longitude; // 經度
alert('緯度:' + lat + ',經度:' + lag);
}
經緯度對使用者沒有意義,我們需要把它換成「臺北市○○區○○路」這樣的可讀資訊。幸運的是各家地圖服務都提供了逆地理編碼(reverse geocoding)接口,只要把座標傳過去,就會回傳省市區甚至街道門牌的資訊。
先在頁面準備兩個展示用的容器:
<div id="baidu_geo"></div>
<div id="google_geo"></div>
function showPosition(position) {
var latlon = position.coords.latitude + ',' + position.coords.longitude;
// baidu
var url = "https://api.map.baidu.com/geocoder/v2/?ak=YOUR_AK&callback=renderReverse"
+ "&location=" + latlon + "&output=json&pois=0";
$.ajax({
type: "GET",
dataType: "jsonp",
url: url,
beforeSend: function () {
$("#baidu_geo").html('正在定位...');
},
success: function (json) {
if (json.status == 0) {
$("#baidu_geo").html(json.result.formatted_address);
}
},
error: function (XMLHttpRequest, textStatus, errorThrown) {
$("#baidu_geo").html(latlon + " 地址位置獲取失敗");
}
});
}
百度回傳的是 JSONP 格式的資料,可依需求取出省市區街道等欄位。這裡用到 jQuery,記得先載入。
function showPosition(position) {
var latlon = position.coords.latitude + ',' + position.coords.longitude;
// google
var url = 'https://maps.google.cn/maps/api/geocode/json?latlng=' + latlon + '&language=CN';
$.ajax({
type: "GET",
url: url,
beforeSend: function () {
$("#google_geo").html('正在定位...');
},
success: function (json) {
if (json.status == 'OK') {
var results = json.results;
$.each(results, function (index, array) {
if (index == 0) {
$("#google_geo").html(array['formatted_address']);
}
});
}
},
error: function (XMLHttpRequest, textStatus, errorThrown) {
$("#google_geo").html(latlon + " 地址位置獲取失敗");
}
});
}
Google 回傳的也是 JSON,而且資訊比百度更細緻,results 陣列的第一項通常就是最完整的格式化地址。
api.map.baidu.com/reverse_geocoding 並要求 ak 與伺服器端簽名;Google 的 maps.google.cn 網域也已調整,現行應使用 maps.googleapis.com/maps/api/geocode/json 並搭配 API key。請勿直接把範例中的 key 拿去用。getCurrentPosition(ok, fail, { timeout: 8000, maximumAge: 60000, enableHighAccuracy: false }),並準備讓使用者手動輸入地址的後路。watchPosition 持續追蹤,並在使用者離開時用 clearWatch 停止,這既是隱私要求也是電量考量。這個例子可以延伸出很多應用:附近店家、到店服務、天氣查詢、區域內容推薦。但記得把「取得位置」當成一個需要正當理由的敏感操作來對待,清楚的說明與合理的降級,比技術實作本身更影響使用者信任。