DIV CSS 佈局教程網

Google Maps 的 Map() 建構式:語法、方法、屬性與事件完整整理
編輯:關於JavaScript     

建立一張地圖

<html>
<head>
<script src="https://maps.googleapis.com/maps/api/js?key=AIzaSyDY0kkJiTPVd2U7aTOAwhc9ySH6oHxOIYM&sensor=false"></script>
<script>
function initialize() {
 var mapOpt = {
 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"), mapOpt);
}
google.maps.event.addDomListener(window, 'load', initialize);
</script>
</head>
<body>
<div id="googleMap" style="width:500px;height:380px;"></div>
</body>
</html>

語法與參數

new google.maps.Map(HTMLElement, MapOptions)

HTMLElement:地圖要掛在哪個 HTML 元素上,通常是一個 div。
MapOptions:帶著所有初始化設定的物件。

常用方法

視角與範圍
・fitBounds(LatLngBounds):調整視口以包含指定範圍。
・panBy(x, y):以像素為單位平移中心。
・panTo(LatLng):把中心移到指定座標(帶平滑動畫)。
・panToBounds(LatLngBounds):以最小移動量平移,使指定範圍進入視野。

讀取狀態
・getBounds():回傳目前視口的西南角與東北角座標。
・getCenter():回傳地圖中心的經緯度。
・getDiv():回傳承載地圖的 DOM 節點。
・getZoom():回傳目前的縮放層級。
・getMapTypeId():回傳目前的地圖型別。
・getProjection():回傳目前的投影方式。
・getHeading():回傳航拍影像的羅盤方位角(僅 SATELLITE 與 HYBRID 支援)。
・getTilt():回傳航拍影像的傾斜角度(同上)。
・getStreetView():回傳綁定於這張地圖的預設街景物件。

設定狀態
・setCenter(LatLng):設定中心座標。
・setZoom(number):設定縮放層級。
・setMapTypeId(MapTypeId):切換地圖型別。
・setHeading(number):設定羅盤方位,以度為單位,正北為基準。
・setTilt(number):設定傾斜角度。
・setOptions(MapOptions):批次套用多項設定。
・setStreetView(StreetViewPanorama):綁定街景物件。

三個屬性

controls(Array<MVCArray<Node>>):要附加到地圖上的額外控件節點。
mapTypes(MapTypeRegistry):以字串 ID 為索引的地圖型別註冊表。
overlayMapTypes(MVCArray<MapType>):要疊加上去的額外地圖型別。

事件清單

視角變化類
・bounds_changed:可視範圍變動時。
・center_changed:中心屬性變動時。
・zoom_changed:縮放屬性變動時。
・heading_changed:方位屬性變動時。
・tilt_changed:傾斜屬性變動時。
・maptypeid_changed:地圖型別屬性變動時。
・projection_changed:投影方式變動時。

滑鼠互動類(回傳 MouseEvent)
・click:點擊地圖(不含標記與資訊視窗)。
・dblclick:雙擊,注意它會在 click 之後才觸發。
・rightclick:右鍵點擊。
・mousemove:滑鼠在地圖容器上移動。
・mouseover / mouseout:滑鼠進入/離開地圖容器。

拖曳類
・dragstart:開始拖曳。
・drag:拖曳過程中反覆觸發。
・dragend:結束拖曳。

載入與尺寸
・tilesloaded:可視圖磚全部載入完成,常用來關閉 loading 遮罩。
・resize:地圖容器尺寸改變時。
・idle:平移或縮放結束、地圖進入閒置狀態時。

一個實務提醒

當你的地圖放在可伸縮的容器中(例如手風琴、分頁、響應式版面),容器尺寸改變後地圖不會自動重繪,畫面會出現灰白空白。這時要監聽 resize 事件,並呼叫 google.maps.event.trigger(map, 'resize') 加上重新設定中心,才能讓它正確填滿。

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