要加载 Maps JavaScript API 的 JavaScript 代码,您需要在网页上添加格式为 https://maps.googleapis.com/maps/api/js
的引导程序网址。此引导程序请求会加载可以在 Maps JavaScript API 中使用的所有主要 JavaScript 对象和符号。此外,明确请求时才会加载的自包含库中也提供了一些 API 功能。将辅助组件分解成库可使主 API 快速加载(和解析)。您只会产生在必要时加载和解析库的额外开销。
您可以通过在引导程序请求中指定 libraries
参数并提供一个或多个库的名称来加载其他库。您可以采用逗号分隔列表的形式来指定多个库,然后通过 google.maps.libraryName
命名空间访问这些库。
提供的库如下:
drawing
,提供一个图形界面,以供用户在地图上绘制多边形、矩形、折线、圆形和标记。如需了解详情,请参阅绘图库文档。geometry
,包含实用函数,用于计算地球表面的标量几何值(例如距离和面积)。如需了解详情,请参阅几何图形库文档。journeySharing
,为 Google Maps Platform 交通运输和物流解决方案提供支持。localContext
,向用户显示指定位置附近的主要景点。如需了解详情,请参阅 Local Context Library 文档。marker
,可让您向地图添加可灵活定制且性能出色的高级标记。如需了解详情,请参阅高级标记文档。places
,让您的应用能够在指定的区域内搜索场所、地理位置或受关注的地图注点等地点。如需了解详情,请参阅地点库文档。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
)
以下引导程序请求展示了如何请求 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>