DIV CSS 佈局教程網

在 Google 地圖上把多個標記用線條串起來
編輯:關於JavaScript     

這段程式示範如何用 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,把座標資料與樣式分離,資料量大時維護起來清爽得多。

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