Google Maps JavaScript API 讓開發者能把 Google 地圖嵌入自己的網頁。使用前必須先到官方頁面申請一把 API key。本文以 jQuery 搭配 Google Maps API,示範如何一步步做出會移動、可縮放、能顯示座標資訊的互動地圖。
首先在 HTML 中建立一個承載地圖的 div(例如 id 為 map,設定好寬高與定位),再準備一個用來顯示訊息的 message 區塊。接著依序載入 Google Maps API 腳本、jQuery 以及自訂的 map.js。
在 map.js 中,先以 $(document).ready 確保 DOM 就緒,並用 GBrowserIsCompatible() 檢查瀏覽器相容性。若相容,便建立 GMap2 物件,透過 map.setCenter(new GLatLng(36.94, 106.08), 4) 把地圖中心設在中國座標並放大 4 級,再用 setMapType(G_SATELLITE_MAP) 切換成衛星地圖。別忘了在 $(window).unload 中呼叫 GUnload() 釋放資源。若不相容,則以 alert 提示使用者。
利用 window.setTimeout 設定 4 秒後呼叫 map.panTo(new GLatLng(...)),就能讓地圖中心平滑移動到新的座標位置,例如中國西部的某個地點。
透過 map.addControl(new GSmallMapControl()) 加入小型伸縮控制器,再用 map.addControl(new GMapTypeControl()) 加入地圖類型切換器。如此一來,地圖左上角會出現縮放控制、右上角則有類型選擇控制。
呼叫 map.enableScrollWheelZoom() 後,使用者就能以滑鼠滾輪放大或縮小地圖。再透過 GEvent.addListener(map, "moveend", function(){...}) 監聽地圖移動結束事件,在函式中以 map.getCenter() 取得中心座標,並用 $('#message').text(center.toString()) 把經緯度即時顯示在頁面上。如此一來,拖曳地圖後,座標資訊便會跟著更新。
執行前請務必確認 API key 與你輸入的網址或網域相符,否則地圖無法正常載入。