DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
HTML5 定位實作:用 Geolocation 取得座標並轉成地址
編輯:HTML5詳解     

HTML5 的 Geolocation API 讓瀏覽器能取得使用者目前的位置。典型應用是表單上的「使用目前位置」按鈕,使用者點一下就不用手打地址。下面的範例不只取得經緯度,還進一步呼叫地圖服務做反向地理編碼,把座標還原成「省市區」的文字地址填進欄位。

/**
 * 取得地理位置
 */
function getLocation() {
  // 檢查瀏覽器是否支援地理位置
  if (navigator.geolocation) {
    // 支援則呼叫 showPosition(),失敗時呼叫 showError
    var config = {
      enableHighAccuracy: true,   // 盡量取得高精度位置
      timeout: 5000,              // 5 秒逾時
      maximumAge: 30000           // 30 秒內的暫存位置可接受
    };
    navigator.geolocation.getCurrentPosition(showPosition, showError, config);
  } else {
    alert("此瀏覽器不支援定位功能");
  }
}

/**
 * 定位成功:取得經緯度後做反向地理編碼
 */
function showPosition(position) {
  var x = position.coords.latitude;    // 緯度
  var y = position.coords.longitude;   // 經度

  // 呼叫地圖服務的逆地理編碼 API
  var url = "https://api.map.baidu.com/geocoder/v2/?ak=YOUR_AK"
          + "&callback=renderReverse"
          + "&location=" + x + "," + y
          + "&output=json"
          + "&pois=0";

  $.ajax({
    type: "GET",
    dataType: "jsonp",
    url: url,
    success: function (json) {
      if (json == null || typeof (json) == "undefined") return;
      if (json.status != "0") return;
      setAddress(json.result.addressComponent);
    },
    error: function (XMLHttpRequest, textStatus, errorThrown) {
      alert("[" + x + ", " + y + "] 地址解析失敗,請手動選擇地址");
    }
  });
}

/**
 * 定位失敗的錯誤處理
 */
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 setAddress(json) {
  var position = document.getElementById("txtPosition");
  var province = json.province;   // 省
  var city     = json.city;       // 市
  var district = json.district;   // 區
  province = province.replace('市', '');
  position.value = province + "," + city + "," + district;
  position.style.color = 'black';
}

三個設定參數怎麼挑

enableHighAccuracy:設為 true 會要求瀏覽器盡量使用 GPS 等高精度來源,定位較準但更耗電、也更慢。表單填地址時值得開啟;只是想知道大約在哪個城市時可以設 false。

timeout:等待定位結果的最長毫秒數。設太短容易在正常情況下就逾時,設太長則使用者會覺得卡住,5000~10000 是常見範圍。

maximumAge:允許使用多久以內的快取值。設大一點可以讓連續呼叫時回應更快、更省電,代價是位置可能不是即時的。

四種錯誤別忘了處理

PERMISSION_DENIED 代表使用者按了「不要」,這是線上最常見的一種,此時應該改用讓使用者手動選擇的降級方案;POSITION_UNAVAILABLE 通常是訊號或硬體問題;TIMEOUT 表示逾時;UNKNOWN_ERROR 是其他未知狀況。把這四種情況都寫清楚,比只寫一個 alert 友善得多。

上線前必須調整的地方

這份程式碼有幾處需要處理才能正式使用。第一,必須在 HTTPS 環境下執行,現代瀏覽器已全面禁止在 HTTP 明文網頁中呼叫定位 API。第二,API 的 ak(金鑰)請自行申請並更換,範例中的字串只是佔位,請勿沿用他人金鑰,也要注意後端限定網域以免被盜用。第三,該服務的接口位址與參數規格可能已有變動,建議對照官方最新文件調整。第四,取得座標後記得提醒使用者確認——定位可能有幾十公尺的誤差,直接自動帶入然後送出訂單風險不小。最後,記得在隱私政策中說明你如何使用位置資訊,多地法規(包括歐盟 GDPR)都要求事先告知並取得同意。

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