Google Maps 基礎


建立一個簡單的 Google 地圖

現在讓我們建立一個簡單的 Google 地圖。

以下是顯示了英國倫敦的 Google 地圖:

範例

<!DOCTYPE html> <html> <head> <script src="https://maps.googleapis.com/maps/api/js?key=AIzaSyDJW4jsPlNKgv6jFm3B5Edp5ywgdqLWdmc&callback=initMap" async defer></script> <script> function initialize() { var mapProp = { center:new google.maps.LatLng(51.508742,-0.120850), zoom:5, mapTypeId:google.maps.MapTypeId.ROADMAP }; var map=new google.maps.Map(document.getElementById("googleMap"), mapProp); } google.maps.event.addDomListener(window, 'load', initialize); </script> </head> <body> <div id="googleMap" style="width:500px;height:380px;"></div> </body> </html>

線上執行 ?


範例解析

我們以以上例項來解析 Google 地圖的建立過程。

應用為什麼要宣告 HTML5?

<!DOCTYPE html>

大多數瀏覽器使用 "標準模式" 的 HTML5 檔案渲染頁面,這就意味著你的應用是相容各大瀏覽器的。

另外,如果沒有DOCTYPE標籤,瀏覽器則使用混雜模式 (quirks mode)進行渲染頁面內容。

提示: 應該注意的是一些"混雜模式 "中的CSS並不能使用於標準模式中。在具體的應用中,所有基於百分比的大小都必須從父塊元素繼承 。如果在父模組中沒有指定大小,預設值為 0 x 0 畫素。如果你想使用百分比,可以在<style> 標籤中宣告,如下所示:

<style type="text/css">
html {height:100%}
body {height:100%;margin:0;padding:0}
#googleMap {height:100%}
</style>

這個樣式宣告表明地圖模組的(GoogleMap)應 HTML高度為100%。


新增 Google 地圖 API Key

在以下例項中第一個<script> 標籤中必須包含 Google 地圖 API:

<script src="http://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&sensor=TRUE_OR_FALSE"></script>

將google生成的 API key 放置於 key 引數中(key=YOUR_API_KEY)

The sensor 引數是必須的,該引數用於指明應用程式是否使用一個感測器 (類似 GPS 導覽) 來定位使用者的位置。引數值可以設定為 true 或者 false。

HTTPS

如果你的應用是安全的HTTP(HTTPS:HTTP Secure)應用,你可以使用 HTTPS 來載入 Google 地圖 API:

<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&sensor=TRUE_OR_FALSE"></script>

非同步載入

同樣我們也可以在頁面完全載入後再載入 Google 地圖 API。

以下例項使用了 window.onload 來實現頁面完全載入後載入 Google 地圖 。 loadScript() 函式建立了載入 Google 地圖 API <script> 標籤。此外在標籤的末尾新增了 callback=initialize 引數, initialize()作為回呼函式會在API完全載入後執行:

範例

function loadScript() { var script = document.createElement("script"); script.type = "text/javascript"; script.src = "https://maps.googleapis.com/maps/api/js?key=AIzaSyBzE9xAESye6Kde-3hT-6B90nfwUkcS8Yw&sensor=false&callback=initialize"; document.body.appendChild(script); } window.onload = loadScript;

線上執行 ?


定義地圖屬性

在初始化地圖前,我們需要先建立一個 Map 屬性物件來定義一些地圖的屬性:

var mapProp = {
  center:new google.maps.LatLng(51.508742,-0.120850),
  zoom:7,
  mapTypeId: google.maps.MapTypeId.ROADMAP
};

center(中心點)

中心屬性指定了地圖的中心,該中心透過坐標(緯度,經度)在地圖上建立一個中心點。

Zoom(縮放級數)

zoom 屬性指定了地圖的 縮放級數。zoom: 0 顯示了整個地球地圖的完全縮放。

MapTypeId(地圖的初始型別)

mapTypeId 屬性指定了地圖的初始型別。

mapTypeId包括如下四種型別:

  • google.maps.MapTypeId.HYBRID:顯示衛星影象的主要街道透明層
  • google.maps.MapTypeId.ROADMAP:顯示普通的街道地圖
  • google.maps.MapTypeId.SATELLITE:顯示衛星影象
  • google.maps.MapTypeId.TERRAIN:顯示帶有自然特徵(如地形和植被)的地圖

在哪裡顯示 Google 地圖

通常 Google 地圖使用於 <div> 元素中:

<div id="googleMap" style="width:500px;height:380px;"></div>

注意: 地圖將以div中設定的大小來顯示地圖的大小,所以我們可以在 <div> 元素中設定地圖的大小。


建立一個 Map 物件

var map=new google.maps.Map(document.getElementById("googleMap")
,mapProp);

以上程式碼使用引數(mapProp)在<div> 元素 (id為googleMap) 建立了一個新的地圖。

提示:如果想在頁面中建立多個地圖,你只需要新增新的地圖物件即可。

以下例項定義了四個地圖例項 (四個地圖使用了不同的地圖型別):

範例

var map = new google.maps.Map(document.getElementById("googleMap"),mapProp); var map2 = new google.maps.Map(document.getElementById("googleMap2"),mapProp2); var map3 = new google.maps.Map(document.getElementById("googleMap3"),mapProp3); var map4 = new google.maps.Map(document.getElementById("googleMap4"),mapProp4);

線上執行 ?


載入地圖

視窗載入後透過執行 initialize() 函式來初始化 Map 物件,這樣可以確保在頁面完全載入後再載入 Google 地圖:

google.maps.event.addDomListener(window, 'load', initialize);