如要載入 Maps JavaScript API 的 JavaScript 程式碼,您必須在網頁中加入「Bootstrap」網址,格式為 https://maps.googleapis.com/maps/api/js
。這項 Bootstrap 要求會載入要在 Maps JavaScript API 中使用的所有主要 JavaScript 物件和符號。獨立「程式庫」也會提供某些 API 功能,但除非您特別提出要求,否則系統不會載入這類程式庫。將補充元件分散到數個程式庫,有助於快速載入 (及剖析) 主要 API,這樣就只有在需要載入及剖析程式庫時,才會增加系統的額外負荷。
如要載入其他程式庫,您可以在 Bootstrap 要求中指定 libraries
參數,並提供一或多個程式庫的名稱。先在利用逗號分隔的清單上,指定多個程式庫;接著透過 google.maps.libraryName
命名空間即可存取程式庫。
可用的程式庫如下:
drawing
提供圖形介面,可讓使用者在地圖上繪製多邊形、矩形、折線、圓形和標記。詳情請參閱繪圖程式庫說明文件。geometry
內含公用函式,可用於計算地表上的純量幾何圖形值 (例如距離和區域)。詳情請參閱幾何圖形程式庫說明文件。journeySharing
為 Google 地圖平台 運輸與物流解決方案提供支援。localContext
會向使用者顯示指定地點附近的重要觀光景點。詳情請參閱當地特色資料庫說明文件。marker
可讓您在地圖中加入能靈活自訂且效能卓越的進階標記。詳情請參閱進階標記說明文件。places
可讓應用程式在定義的區域內,搜尋建築物、地理位置或重要搜尋點等地點。詳情請參閱 Places Library 說明文件。visualization
提供熱視圖,以視覺化方式呈現資料。詳情請參閱視覺化程式庫說明文件。
預先發布版:Beta 版 (v=beta
) 提供下列程式庫:
core
(google.maps.CoreLibrary
)maps
(google.maps.MapsLibrary
)places
(google.maps.PlacesLibrary
)geocoding
(google.maps.GeocodingLibrary
)routes
(google.maps.RoutesLibrary
)marker
(google.maps.MarkerLibrary
)geometry
(google.maps.GeometryLibrary
)elevation
(google.maps.ElevationLibrary
)streetView
(google.maps.StreetViewLibrary
)journeySharing
(google.maps.JourneySharingLibrary
)drawing
(google.maps.DrawingLibrary
)visualization
(google.maps.VisualizationLibrary
)
下列 Bootstrap 要求示範如何要求 Maps JavaScript API 的 google.maps.geometry
程式庫:
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=geometry&callback=initMap">
</script>
如要要求多個程式庫,請使用半形逗號隔開。
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=geometry,places&callback=initMap">
</script>