DIV CSS 佈局教程網

Google Maps API 實作:以使用者目前位置為中心顯示地圖
編輯:關於JavaScript     

這個範例示範如何搭配瀏覽器的 geolocation API 取得使用者座標,再以該座標為中心開啟一張 Google 地圖,並在地圖上落下標記與資訊窗。在新版 Firefox 中測試可正常運作。

效果如下:

<!DOCTYPE>
<html>
<head>
<meta http-equiv="content-type" content="text/html;charset=utf-8">
<title>Google Map</title>
<script type="text/javascript"
        src="https://maps.google.com/maps/api/js?sensor=false"</script>
<script type="text/javascript">
function init() {
  // 取得目前位置
  navigator.geolocation.getCurrentPosition(function(position) {
    var coords = position.coords;
    // 以目前位置的經緯度作為地圖中心
    var latlng = new google.maps.LatLng(coords.latitude, coords.longitude);
    var myOptions = {
      zoom: 14,                                        // 放大倍數
      center: latlng,                                  // 中心座標
      mapTypeId: google.maps.MapTypeId.ROADMAP         // 地圖類型
    };
    var map1 = new google.maps.Map(document.getElementById('map'), myOptions);

    // 建立標記
    var marker = new google.maps.Marker({ position: latlng, map: map1 });

    // 設定資訊窗並附註解文字
    var infowindow = new google.maps.InfoWindow({ content: "當前位置" });
    infowindow.open(map1, marker);
  });
}
</script>
</head>
<body onload="init()">
  <div id="map"</div>
</body>
</html>

幾個實務上必須留意的重點:

一是 getCurrentPosition 需要使用者授權,且主流瀏覽器已要求頁面必須在 HTTPS(或 localhost)下才能使用;在純 HTTP 頁面呼叫會直接失敗。

二是這個 API 是「非同步」的,因此地圖的初始化必須寫在它的成功回呼裡,不能寫在後面等著同步執行,否則會拿到空值。同時建議傳入第二個參數處理錯誤與設定逾時:

navigator.geolocation.getCurrentPosition(onSuccess, onError, {
  enableHighAccuracy: true, timeout: 5000, maximumAge: 0
});

三是範例中的 API 網址寫成 https:// 且帶 sensor=false,這在今日已不適用:Google Maps JavaScript API 現已全面要求 HTTPS,且自 2018 年起必須搭配 API 金鑰(key=YOUR_KEY),並在 Google Cloud 啟用計費帳戶。金鑰請勿硬編碼在前端原始碼之外的地方誤用,務必在 Console 設定 HTTP referrer 白名單限制來源。

四是 google.maps.Marker 已被標示為不建議使用,新專案請改用 google.maps.marker.AdvancedMarkerElement;InfoWindow 也仍可用但 API 風格已有調整。

參考文件:

  • Google Maps JavaScript API v3:https://developers.google.com/maps/documentation/javascript/basics
  • 百度地圖 API:https://developer.baidu.com/map/jsmobile.htm

若主要服務中國市場,直接使用百度或高德的地圖 SDK 會省去許多可用性與合規上的困擾。

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