地圖畫出來只是起點,真正讓它「活起來」的是事件。Google Maps API 的事件系統核心只有一個方法:addListener()——傳入一個物件、一個事件名稱、一個回呼函式,之後該事件每次發生時函式就會被呼叫。
<html>
<head>
<script src="https://maps.googleapis.com/maps/api/js?key=AIzaSyDY0kkJiTPVd2U7aTOAwhc9ySH6oHxOIYM&sensor=false"></script>
<script>
var myCenter = new google.maps.LatLng(51.508742, -0.120850);
function initialize() {
var mapProp = { center: myCenter, zoom: 5, mapTypeId: google.maps.MapTypeId.ROADMAP };
var map = new google.maps.Map(document.getElementById("googleMap"), mapProp);
var marker = new google.maps.Marker({ position: myCenter, title: 'Click to zoom' });
marker.setMap(map);
// 點擊標記時放大到 9 級,並把中心移到標記位置
google.maps.event.addListener(marker, 'click', function () {
map.setZoom(9);
map.setCenter(marker.getPosition());
});
}
google.maps.event.addDomListener(window, 'load', initialize);
</script>
</head>
<body>
<div id="googleMap" style="width:500px;height:380px;"></div>
</body>
</html>
title 屬性不只是給螢幕閱讀器用的替代文字,滑鼠停留時也會顯示為 tooltip,是個便宜又實用的提示手法。
這裡用 center_changed 事件——每當地圖中心改變時觸發。我們在它裡面掛一個計時器,三秒後把視角拉回標記:
google.maps.event.addListener(map, 'center_changed', function () {
// 中心變動後 3 秒,把視角移回標記
window.setTimeout(function () {
map.panTo(marker.getPosition());
}, 3000);
});
注意 panTo 與 setCenter 的差別:前者帶有平滑的平移動畫,後者是瞬間跳躍。做這類引導性互動時,panTo 的體驗明顯更好。
var marker = new google.maps.Marker({ position: myCenter });
marker.setMap(map);
var infowindow = new google.maps.InfoWindow({ content: "Hello World!" });
google.maps.event.addListener(marker, 'click', function () {
infowindow.open(map, marker);
});
把 InfoWindow 的開啟綁到 click 事件上,資訊 Retrieved 才不會一進頁面就佔住畫面。
地圖本身的 click 事件會帶一個 MouseEvent 物件,其中的 latLng 就是你點擊位置的座標:
<html>
<head>
<script src="https://maps.googleapis.com/maps/api/js?key=AIzaSyDY0kkJiTPVd2U7aTOAwhc9ySH6oHxOIYM&sensor=false"></script>
<script>
var map;
var myCenter = new google.maps.LatLng(51.508742, -0.120850);
function initialize() {
var mapProp = { center: myCenter, zoom: 5, mapTypeId: google.maps.MapTypeId.ROADMAP };
map = new google.maps.Map(document.getElementById("googleMap"), mapProp);
google.maps.event.addListener(map, 'click', function (event) {
placeMarker(event.latLng);
});
}
function placeMarker(location) {
var marker = new google.maps.Marker({ position: location, map: map });
var infowindow = new google.maps.InfoWindow({
content: 'Latitude: ' + location.lat() + '<br>Longitude: ' + location.lng()
});
infowindow.open(map, marker);
}
google.maps.event.addDomListener(window, 'load', initialize);
</script>
</head>
<body>
<div id="googleMap" style="width:500px;height:380px;"></div>
</body>
</html>
這裡有個小技巧:建立 Marker 時直接把 map: map 寫進 options,就省掉一次 setMap() 呼叫。另外注意 map 變數宣告在全域,因為 placeMarker 是獨立函式,需要存取到它。
・click / dblclick:地圖單擊、雙擊
・dragstart / drag / dragend:拖曳三階段
・center_changed、zoom_changed、bounds_changed:視角變化
・mousemove / mouseover / mouseout:滑鼠移動
・tilesloaded:圖磚載入完畢,常用來移除 loading 遮罩
・idle:地圖停止移動或縮放後進入閒置狀態