DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
HTML5 Geolocation 實戰:取得經緯度並還原成實際地址
編輯:HTML5詳解     

HTML5 的 Geolocation API 讓網頁得以知道使用者所在位置,天氣、外送、門市查詢這類應用都靠它。本文從特性檢測開始,示範如何抓取經緯度,再把這串抽象數字交給地圖服務的反向地理編碼介面,換成人看得懂的省市區與街道資訊。

動手前先知道的兩件事

第一,這是 HTML5 新增的能力,只有支援的瀏覽器才有;行動裝置(例如 iPhone)因為有 GPS 與基地台資料,定位精準度通常明顯優於桌機。

第二,定位屬於敏感資訊,規範要求必須取得使用者同意。頁面載入時瀏覽器會跳出詢問,使用者按下允許之前,你拿不到任何座標。此外,近年的瀏覽器已把定位功能限制在安全環境(HTTPS 或 localhost)中,用 http 開啟的頁面會直接被拒絕,這一點在部署時特別容易踩到。

基本用法:getCurrentPosition

function getLocation() {
  if (navigator.geolocation) {
    navigator.geolocation.getCurrentPosition(showPosition, showError, {
      enableHighAccuracy: true, // 盡量取得高精度結果
      timeout: 10000,           // 逾時時間(毫秒)
      maximumAge: 60000         // 允許使用幾毫秒前的快取值
    });
  } else {
    alert('瀏覽器不支援地理定位。');
  }
}

getCurrentPosition() 的第一個參數是成功回呼,會收到一個 position 物件;第二個參數是失敗回呼,用來處理各種錯誤碼。

錯誤處理:showError

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;
  }
}

取出座標:showPosition

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 地圖

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、記得處理使用者拒絕與逾時、記得為定位失敗準備降級方案(例如讓使用者手動輸入地址),以及不要把定位結果在未告知的情況下送到第三方。

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