<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') 加上重新設定中心,才能讓它正確填滿。