這幾年最熱的一類服務莫過於 LBS(Location-Based Service,基於位置的服務)。它的邏輯很直白:以某個座標點(例如使用者目前所在的位置)為圓心,提供周邊區域的相關資訊,地圖類應用就是最典型的代表。HTML5 內建的地理位置 API(Geolocation API),正是用來取得並分享位置資料的標準工具。
要把物理位置送到遠端伺服器,隱私永遠是第一個要處理的問題。因此地理位置 API 設計了明確的授權流程:網頁必須先取得使用者同意,才能讀取位置資訊。首次造訪會請求位置的頁面時,瀏覽器會在上方顯示通知列,詢問是否允許該網站存取你的位置,按下允許即可。
若使用者拒絕授權,瀏覽器不會提供任何位置資料,成功回呼函式也不會被觸發。這一層設計確保了位置資料始終掌握在使用者手上。
地理位置 API 在主流瀏覽器的新版中都有支援,但為了照顧舊環境,實作時仍應做一次能力偵測。若 API 不可用,window.navigator.geolocation 會是 null:
function show_islocationenabled() {
var str = "No, geolocation is not supported.";
if (window.navigator.geolocation) {
str = "Yes, geolocation is supported.";
}
alert(str);
}
這個 API 掛在 navigator 這個全域物件上,而 navigator 本身就提供了不少關於使用者瀏覽器與系統的資訊。位置的取得方式其實有許多種:基地台三角定位、Wi-Fi 與 IP 的資料庫比對,或者 GPS。不同來源精度差異很大,一般來說 GPS 最準(行動裝置多依賴 GPS,PC 端則多半靠網路資料推算)。在某些環境下,你也可能拿到精度很差的讀數,甚至完全取不到資料,因此錯誤處理絕對不能省。
使用 navigator.geolocation.getCurrentPosition() 取得使用者當下的位置,這個方法只回報一次結果。呼叫時,瀏覽器會以非同步(asynchronous)方式嘗試取得裝置位置,因此你不會被卡住等待。
方法簽名: getCurrentPosition(geolocationSuccessCallback, [geolocationErrorCallback, geolocationOptions]); 1. geolocationSuccessCallback:定位成功後的回呼(必要) 2. geolocationErrorCallback:發生錯誤時的回呼(選填) 3. geolocationOptions:定位相關的設定選項(選填)
定位成功後,位置資料會被包裝成一個 Position 物件,並作為參數傳入成功回呼。Position 有兩個屬性:timestamp 表示資料產生時間,coords 則承載實際座標資訊,內含七個欄位:
coords.latitude // 緯度 coords.longitude // 經度 coords.altitude // 高度 coords.accuracy // 經緯度估計的精確度(公尺) coords.altitudeAccuracy// 高度估計的精確度(公尺) coords.heading // 裝置移動方向,相對於正北順時針計算 coords.speed // 對地速度(公尺/秒)
實務上,通常只有 latitude、Longitude 與 accuracy 三項是有保證的,其餘欄位可能回傳 null,取決於裝置能力與後端定位服務。而 heading 與 speed 則可以依據先前位置推算得出。
若定位過程中發生錯誤,瀏覽器會把一個 PositionError 物件傳給錯誤回呼。實務上建議針對不同錯誤碼給出不同提示:
function showError(error) {
switch (error.code) {
case error.PERMISSION_DENIED:
x.innerHTML = "使用者拒絕了定位請求。";
break;
case error.POSITION_UNAVAILABLE:
x.innerHTML = "無法取得位置資訊。";
break;
case error.TIMEOUT:
x.innerHTML = "定位請求逾時。";
break;
case error.UNKNOWN_ERROR:
x.innerHTML = "發生未知錯誤。";
break;
}
}
第三個參數 geolocationOptions 有三個可調欄位:
enableHighAccuracy:裝置支援時,是否啟用高精度模式(更準但更耗電、更慢) timeout :查詢的逾時時間(毫秒) maximumAge :可接受快取位置的存活時間,在此時間內可直接使用快取值
<!DOCTYPE Html>
<Html>
<body>
<p id="demo">點擊按鈕取得你的位置:</p>
<button onclick="getLocation()">Try It</button>
<div id="mapholder"></div>
<script>
var x = document.getElementById("demo");
function getLocation() {
if (navigator.geolocation) {
navigator.geolocation.getCurrentPosition(showPosition, showError);
} else {
x.innerHTML = "此瀏覽器不支援 Geolocation。";
}
}
function showPosition(position) {
var latlon = position.coords.latitude + "," + position.coords.longitude;
var img_url = "https://maps.googleapis.com/maps/api/staticmap?center=" +
latlon + "&zoom=9&size=400x300&sensor=false";
document.getElementById("mapholder").innerHTML =
"<img src='" + img_url + "' />";
}
</script>
</body>
</Html>
這個範例會取得裝置所在座標,並以靜態地圖圖片呈現出來。若要把服務落地到中文環境,也可以用百度地圖的靜態圖 API 改寫同一段邏輯。
如果情境需要「隨時掌握」而非「查詢一次」,例如行車導航或運動記錄,就該改用 watchPosition()。它會週期性輪詢位置變化,參數與 getCurrentPosition() 完全相同(成功回呼、失敗回呼、選項),但多了個回傳值 watchID,作為後續取消監聽的憑證。
要停止監聽,呼叫 clearWatch(watchID) 即可,它只接受一個參數。
<script type="text/Javascript">
var nav = null;
var watchID;
function listenForPositionUpdates() {
if (nav == null) { nav = window.navigator; }
if (nav != null) {
var geoloc = nav.geolocation;
if (geoloc != null) {
watchID = geoloc.watchPosition(successCallback);
} else {
alert("不支援 geolocation");
}
} else {
alert("找不到 navigator");
}
}
function clearWatch(watchID) {
window.navigator.geolocation.clearWatch(watchID);
}
function successCallback(position) {
setText(position.coords.latitude, "latitude");
setText(position.coords.longitude, "longitude");
}
</script>
實作時有兩個實務提醒:一是持續定位相當耗電,用完記得立刻 clearWatch;二是若使用者長時間沒有動作,可搭配 maximumAge 減少不必要的重新定位。
W3Schools 官方教學:https://www.w3schools.com/html5/html5_geolocation.asp
微軟說明文件:https://msdn.microsoft.com/zh-cn/library/gg589502(v=vs.85)
百度地圖 API:https://dev.baidu.com/wiki/static/index.htm