疊加層(Overlay)是綁定在經緯度座標上的物件,它會隨著你拖曳或縮放地圖而一起移動——這是它與單純的 DOM 元素最大的差別。
Google Maps API 提供的疊加層大致分為五類:
1. 標記(Marker):標示地圖上的單一位置,預設長得像大頭針,可自訂圖示。
2. 折線(Polyline):由一串座標點依序連成的線段。
3. 多邊形(Polygon)與圓形(Circle):用來標示區域範圍。多邊形首尾相連形成閉合區域,形狀任意;矩形與圓形則有專屬類別。
4. 圖磚疊加層(Tile Overlay):更底層的用法,可以替換地圖本身的圖磚,甚至打造自訂地圖型別。
5. 資訊視窗(Info Window):一種特殊的彈出式疊加層,同一張地圖同一時間只能有一個。
最基本的用法是建立 Marker 並掛到地圖上:
<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 });
marker.setMap(map);
}
google.maps.event.addDomListener(window, 'load', initialize);
</script>
</head>
<body>
<div id="googleMap" style="width:500px;height:380px;"></div>
</body>
</html>

標記天生就是互動型的,預設會接收 click 事件,最常見的用法就是在點擊時彈出資訊視窗。
加上 animation 屬性,標記就會持續上下跳動,通常用來強調「就是這裡」:
marker = new google.maps.Marker({
position: myCenter,
animation: google.maps.Animation.BOUNCE
});
marker.setMap(map);
用 icon 屬性指定圖片路徑即可取代預設樣式:
var marker = new google.maps.Marker({
position: myCenter,
icon: 'pinkball.png'
});
marker.setMap(map);
Polyline 由一連串座標構成,支援的屬性有:
・path:座標陣列
・strokeColor:線條顏色,十六進位如 "#0000FF"
・strokeOpacity:透明度,0.0 到 1.0
・strokeWeight:線寬,單位像素
・editable:使用者能否拖動編輯節點
<html>
<head>
<script src="https://maps.googleapis.com/maps/api/js?key=AIzaSyDY0kkJiTPVd2U7aTOAwhc9ySH6oHxOIYM&sensor=false"></script>
<script>
var stavanger = new google.maps.LatLng(58.983991, 5.734863);
var amsterdam = new google.maps.LatLng(52.395715, 4.888916);
var london = new google.maps.LatLng(51.508742, -0.120850);
function initialize() {
var mapProp = { center: amsterdam, zoom: 4, mapTypeId: google.maps.MapTypeId.ROADMAP };
var map = new google.maps.Map(document.getElementById("googleMap"), mapProp);
var myTrip = [stavanger, amsterdam, london];
var flightPath = new google.maps.Polyline({
path: myTrip,
strokeColor: "#0000FF",
strokeOpacity: 0.8,
strokeWeight: 2
});
flightPath.setMap(map);
}
google.maps.event.addDomListener(window, 'load', initialize);
</script>
</head>
<body>
<div id="googleMap" style="width:500px;height:380px;"></div>
</body>
</html>

Polygon 與 Polyline 很像,差別在於它是閉合的——最後一個座標通常等於第一個座標,如此才圍得出區域。除了線條樣式,它還多了填色相關屬性:
・fillColor:區域填充色
・fillOpacity:填充透明度
var myTrip = [stavanger, amsterdam, london, stavanger]; // 首尾相同
var flightPath = new google.maps.Polygon({
path: myTrip,
strokeColor: "#0000FF",
strokeOpacity: 0.8,
strokeWeight: 2,
fillColor: "#0000FF",
fillOpacity: 0.4
});
flightPath.setMap(map);

圓形用 Circle 類別,只要給中心點與半徑(單位是公尺),不必自己算座標:
var amsterdam = new google.maps.LatLng(52.395715, 4.888916);
function initialize() {
var mapProp = { center: amsterdam, zoom: 7, mapTypeId: google.maps.MapTypeId.ROADMAP };
var map = new google.maps.Map(document.getElementById("googleMap"), mapProp);
var myCity = new google.maps.Circle({
center: amsterdam,
radius: 20000,
strokeColor: "#0000FF",
strokeOpacity: 0.8,
strokeWeight: 2,
fillColor: "#0000FF",
fillOpacity: 0.4
});
myCity.setMap(map);
}
google.maps.event.addDomListener(window, 'load', initialize);

InfoWindow 用來顯示一段文字或 HTML,透過 open(map, marker) 指定它掛在哪張地圖、依附在哪個標記上:
var marker = new google.maps.Marker({ position: myCenter });
marker.setMap(map);
var infowindow = new google.maps.InfoWindow({ content: "Hello World!" });
infowindow.open(map, marker);

實務上通常不會直接呼叫 open,而是註冊標記的 click 事件,讓使用者點擊時才彈出——這屬於下一篇文章「事件」的範疇。