DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
HTML5 地理位置 API 實作指南:getCurrentPosition 與 watchPosition
編輯:HTML5詳解     

HTML5 的 Geolocation API 讓網頁得以取得使用者當前的位置資訊。前提是瀏覽器支援、且裝置具備定位能力;在行動裝置上,這組 API 幾乎是各類「附近店家」「配送範圍」功能的起點。

HTML5 在 window.navigator 上新增了 geolocation 屬性,底下有三個方法:getCurrentPosition、watchPosition 與 clearWatch。

getCurrentPosition:取得一次目前位置

getCurrentPosition(onSuccess, onError, options);

三個參數中,第一個是成功時的回呼函數,會收到一個 position 物件:

navigator.geolocation.getCurrentPosition(function (position) {
  // 定位成功,position 為地理位置物件
});

第二個參數是失敗時的回呼函數,用來把錯誤訊息呈現給使用者:

navigator.geolocation.getCurrentPosition(function (position) {
  // 定位成功
}, function (error) {
  // 定位失敗
});

這個 error 物件有兩個屬性。code 有三種可能值:1 代表使用者拒絕了位置服務、2 代表無法取得位置、3 代表逾時。message 則是一段可讀的錯誤描述字串。

把兩者合起來,就能取出實際座標與精度:

navigator.geolocation.getCurrentPosition(function (position) {
  var coords = position.coords;
  console.log(coords.latitude);   // 緯度
  console.log(coords.longitude);  // 經度
  console.log(coords.accuracy);   // 經緯度精度,單位為公尺
}, function (error) {
  var errorTypes = {
    1: '位置服務被拒絕',
    2: '無法取得位置資訊',
    3: '取得資訊逾時'
  };
  alert(errorTypes[error.code]);
});

第三個參數:可選的 options

這個參數可以省略,但用好它往往比反覆重試更有效。

enableHighAccuracy:是否要求高精度的位置。精度越高越耗電、也越慢,在行動裝置上必須與電量、場景一併權衡。多數情況保留預設值即可,只有在導航類應用才真的需要打開。

timeout:這次定位作業的逾時上限(毫秒)。超過就回傳錯誤,避免使用者對著轉圈的畫面乾等。

maximumAge:位置的快取有效期(毫秒)。例如設為 120000,代表兩分鐘內重複呼叫會直接回傳快取值,不再重新定位。設為 0 則無條件重新取得。

watchPosition 與 clearWatch:持續追蹤

需要隨時掌握位置變化時(例如跑步記錄、外送進度),用 watchPosition 取代單次取得:

watchPosition(onSuccess, onError, options);

三個參數的意義與 getCurrentPosition 完全相同,差別在於它會定期自動重新定位,並回傳一個 id。這個 id 的用法與 setInterval 的回傳值類似,交給 clearWatch 即可停止追蹤:

clearWatch(watchId);

position 物件的屬性

成功回呼收到的 position,其中 coords 帶有這些欄位:

latitude:目前位置的緯度。
longitude:目前位置的經度。
altitude:海拔高度,取不到時為 null。
accuracy:經緯度的精度,單位為公尺。
altitudeAccuracy:海拔高度的精度,單位為公尺。
speed:裝置移動速度,單位為公尺/秒,取不到時為 null。
timestamp:取得這筆位置資訊的時間。

注意 accuracy 是「半徑」的概念:它代表以回傳座標為圓心、真實位置有某個機率落在這個範圍內。數字越大代表越不準,介面上若要畫一個藍點與光圈,光圈半徑通常就取自這個值。

完整範例

把上述元素組起來,加上瀏覽器支援偵測與錯誤分支,就是一份可直接使用的程式:

function get_location() {
  if (navigator.geolocation) {
    navigator.geolocation.getCurrentPosition(function (position) {
      var longitude = position.coords.longitude,
          latitude = position.coords.latitude;
      showObject(position.coords, 0);
    }, function (err) {
      switch (err.code) {
        case 1:
          alert('位置服務被拒絕。');
          break;
        case 2:
          alert('暫時無法取得位置資訊。');
          break;
        case 3:
          alert('取得資訊逾時。');
          break;
        default:
          alert('未知錯誤。');
          break;
      }
    }, {
      enableHighAccuracy: true,
      maximumAge: 100
    });
  } else {
    alert('你的瀏覽器不支援以 HTML5 取得地理位置資訊。');
  }
}
get_location();

執行後會像下圖這樣把 coords 的內容逐一列出:

實務上別忽略的三件事

第一,這組 API 一律需要使用者明確授權,且只在 HTTPS(或 localhost)環境下可用,明文 HTTP 頁面會直接被瀏覽器擋掉。

第二,永遠要寫好失敗分支。使用者拒絕、室內訊號差、裝置沒有 GPS,都是日常會發生的事,功能應該優雅降級而不是卡死。

第三,位置屬於敏感資料。只取用你真正需要的精度,別在背景持續追蹤,也别把座標留存得比業務需求更久。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved