這段程式示範如何用 Google Maps JavaScript API 在同一張地圖上放多個標記、用折線把它們依序連接、加上精度圈,並在滑過標記時顯示資訊窗。算是拋磚引玉,需要提醒的是:由於服務供應狀況變動,Google 地圖在部分地區的可用性受限,實際導入前請先確認 API 金鑰申請與區域支援情況。
<!DOCTYPE html>
<html>
<head>
<title>GeoLocation</title>
<meta name="viewport" content="initial-scale=1.0, user-scalable=no">
<meta charset="utf-8">
<style>
html, body, #map-canvas { margin: 0; padding: 0; height: 100%; }
</style>
<script src="https://maps.googleapis.com/maps/api/js?v=3.exp&sensor=false"></script>
<script>
var map;
var poly;
function initialize() {
var myLatlng = new google.maps.LatLng(31.1937077, 121.4158436);
// 每筆資料: [標題, 緯度, 經度, 精度半徑(公尺)]
var locations = [
['test1, accuracy: 150m', 31.1937077, 121.4158436, 100],
['test2, accuracy: 150m', 31.2937077, 121.4158436, 100],
['test3, accuracy: 150m', 31.0937077, 121.2158436, 100],
['test4, accuracy: 150m', 31.3937077, 120.4158436, 100],
['test5, accuracy: 150m', 31.1637077, 120.4858436, 100],
['test6, accuracy: 150m', 31.1037077, 121.5158436, 100]
];
var mapOptions = {
zoom: 13,
center: myLatlng,
mapTypeId: google.maps.MapTypeId.ROADMAP
};
map = new google.maps.Map(document.getElementById('map-canvas'), mapOptions);
// 折線樣式
var polyOptions = {
strokeColor: '#00ff00', // 顏色
strokeOpacity: 1.0, // 不透明度
strokeWeight: 4 // 線寬
};
poly = new google.maps.Polyline(polyOptions);
poly.setMap(map);
var marker, i, circle;
var iwarray = [];
var infoWindow;
var latlngbounds = new google.maps.LatLngBounds();
var iconYellow = new google.maps.MarkerImage(
"https://maps.google.com/mapfiles/ms/icons/yellow-dot.png");
for (i = 0; i < locations.length; i++) {
var loc = [locations[i][1], locations[i][2]];
// 把座標推進折線的路徑
var path = poly.getPath();
path.push(new google.maps.LatLng(loc[0], loc[1]));
var latlng = new google.maps.LatLng(locations[i][1], locations[i][2]);
latlngbounds.extend(latlng);
// 依標題前綴決定要用哪種圖示與文字顏色
if (locations[i][0].indexOf("[Cached") == 0) {
marker = new google.maps.Marker({
position: latlng,
map: map,
icon: iconYellow
});
var iw = '<div style="font-size:12px;word-wrap:break-word;">'
+ '<strong><font color="#FF0000">' + locations[i][0]
+ '</font></strong></div>';
} else {
marker = new google.maps.Marker({ position: latlng, map: map });
var iw = '<div style="font-size:12px;word-wrap:break-word;">'
+ '<strong><font color="#000000">' + locations[i][0]
+ '</font></strong></div>';
}
iwarray[i] = iw;
// 滑過顯示資訊窗。用 IIFE 鎖定目前的 marker 與 i
google.maps.event.addListener(marker, 'mouseover', (function (marker, i) {
return function () {
infoWindow = new google.maps.InfoWindow({
content: iwarray[i],
maxWidth: 200,
pixelOffset: new google.maps.Size(0, 0)
});
infoWindow.open(map, marker);
};
})(marker, i));
google.maps.event.addListener(marker, 'mouseout', function () {
infoWindow.close();
});
// 精度圈:中心綁定到 marker 的座標,兩者一起移動
circle = new google.maps.Circle({
map: map,
radius: locations[i][3],
fillColor: '#0000AA',
fillOpacity: 0.01,
strokeWeight: 1,
strokeColor: '#0000CC',
strokeOpacity: 0.8
});
circle.bindTo('center', marker, 'position');
}
// 縮放到恰好包含所有標記,並限制最大層級避免過度放大
map.fitBounds(latlngbounds);
google.maps.event.addListenerOnce(map, "idle", function () {
var zoomLevel = parseInt(map.getZoom());
if (zoomLevel > 13) { map.setZoom(13); }
});
}
google.maps.event.addDomListener(window, 'load', initialize);
</script>
</head>
<body>
<div id="map-canvas"></div>
</body>
</html>
折線是「共享路徑」而非每個 marker 各自一條:關鍵在 poly.getPath() 拿到的是同一個路徑物件,每次迴圈 push 一個座標,最後就自動連成一條線。若改成每次 new 一個 Polyline,就會變成好幾段互不相連的線。
閉包取值陷阱:mouseover 回呼裡若直接用迴圈變數 i,所有標記都會拿到最後一次的值。這裡用 IIFE 把 marker 與 i 當參數傳入,各自有一份獨立參照,這才看得到對應的資訊窗。
bindTo 讓精度圈跟著跑:circle.bindTo('center', marker, 'position') 把圓心與 marker 的座標綁在一起,之後若要拖曳標記,圓圈會自動跟隨,不必手動同步。
fitBounds 之後要限縮放:fitBounds 會自動找出最合適的層級,但若標記很集中,地圖可能放大到街區尺度。這裡用 addListenerOnce('idle') 在初次定位完成後把層級壓回 13 以下。
這份程式寫於 Google Maps API v3 早期,有幾處已不建議使用:sensor 參數早已作廢;google.maps.MarkerImage 已被 icon: { url: ... } 取代;新版 API 必須附上有效的 API 金鑰,並在 Google Cloud 專案啟用 Maps JavaScript API 與綁定帳單。另外 v3 的 Marker 也已進入淘汰路徑,官方建議改用 AdvancedMarkerElement。
若你要在多個標記間畫線,也可以考慮 Data 層搭配 GeoJSON,把座標資料與樣式分離,資料量大時維護起來清爽得多。