DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
HTML5 教學(七):Geolocation 搭配 Google Maps 做一個定位小應用
編輯:HTML5詳解     

這次我們把 HTML5 的 geolocation 結合 Google Maps,做一個能標出自己位置的小應用。Google Maps 官方文件:https://developers.google.com/maps/documentation/javascript/?hl=zh-TW 。

引入 Google Maps

要使用 Google Maps,先在頁面中加上 script 標籤:

<script type="text/javascript"
  src="https://maps.google.com/maps/api/js"></script>

早期版本還需要帶一個 sensor 參數,用來宣告你的應用是否使用 GPS 等感測器來判斷使用者位置——若使用就必須設為 true,行動裝置上尤其重要。要注意這個參數後來已被官方標示為不必要,現在的寫法改為帶上自己的 API key,因此建議直接省略 sensor。

HTML 部分

結構很簡單,準備一個 div 當容器就好:

<body>
  <div id="map" style="width: 100%; height: 500px;"></div>
</body>

提醒一下,Google Maps 需要容器有明確的高度,否則地圖不會顯示。

JS 骨架

<script type="text/javascript">
var map;
var browserSupport = false;
var attempts = 0;

$(document).ready(function () {
  InitMap();        // 初始化地圖
  getLocation();    // 取得目前位置
  watchLocation();  // 持續追蹤位置
});

function InitMap() { }
function getLocation() { }
function watchLocation() { }

// 把位置畫到地圖上並縮放過去
function plotLocation(position) { }

// 統一在這裡回報錯誤
function reportProblem(e) { }
</script>

初始化地圖

InitMap 負責呼叫 Google Maps API 建立地圖,重點是那份 options 設定物件:

function InitMap() {
  var options = {
    zoom: 4,
    center: new google.maps.LatLng(38.6201, -90.2003),
    mapTypeId: google.maps.MapTypeId.ROADMAP,

    mapTypeControl: true,
    mapTypeControlOptions: {
      style: google.maps.MapTypeControlStyle.HORIZONTAL_BAR,
      position: google.maps.ControlPosition.BOTTOM_CENTER
    },

    panControl: true,
    panControlOptions: {
      position: google.maps.ControlPosition.TOP_RIGHT
    },

    zoomControl: true,
    zoomControlOptions: {
      style: google.maps.ZoomControlStyle.LARGE,
      position: google.maps.ControlPosition.LEFT_CENTER
    },

    scaleControl: true,
    scaleControlOptions: {
      position: google.maps.ControlPosition.BOTTOM_LEFT
    },

    streetViewControl: true,
    streetViewControlOptions: {
      position: google.maps.ControlPosition.LEFT_TOP
    }
  };

  map = new google.maps.Map($('#map')[0], options);
}

這裡把各種控制元件(地圖型別、平移、縮放、比例尺、街景)逐一開啟並指定位置,就是為了示範 options 可以控制到多細。實務上如果沒有特別需求,只留 zoom、center、mapTypeId 三項也能跑。

取得定位資訊

function getLocation() {
  // 檢查瀏覽器是否支援 W3C Geolocation API
  if (navigator.geolocation) {
    browserSupport = true;
    navigator.geolocation.getCurrentPosition(
      plotLocation, reportProblem, { timeout: 45000 }
    );
  } else {
    reportProblem();
  }
}

function watchLocation() {
  if (navigator.geolocation) {
    browserSupport = true;
    navigator.geolocation.watchPosition(
      plotLocation, reportProblem, { timeout: 45000 }
    );
  } else {
    reportProblem();
  }
}

兩者的差別是:getCurrentPosition 只取一次位置,watchPosition 則會持續回報位置變化,適合需要即時追蹤的場景(例如運動 App 的路線記錄)。在一般頁面上同時呼叫兩者其實是重複的,實作時挑一個就好。

把位置畫到地圖上

成功取得座標後,交給 plotLocation 在 Google Maps 上標記並置中:

function plotLocation(position) {
  attempts = 0;

  var point = new google.maps.LatLng(
    position.coords.latitude,
    position.coords.longitude
  );

  var marker = new google.maps.Marker({
    position: point,
    map: map
  });

  map.setCenter(point);
  map.setZoom(15);
}

Demo 下載:googleMapGeolocation.rar

實務上會遇到的兩件事

第一,Geolocation 涉及隱私,瀏覽器一定會先跳出詢問,使用者按下「允許」才會回傳座標;若被拒絕,reportProblem 收到的錯誤碼會是 PERMISSION_DENIED。請務必在版面設計上預留這個情境,不要假設定位一定會成功。

第二,定位精度取決於裝置與環境:桌機多半靠 IP 推估,可能只對到城市等級;手機有 GPS 時可達數公尺。所以把 setZoom 寫死成 15 未必合適,可以參考回傳的 position.coords.accuracy 動態調整縮放層級。

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