库

要加载 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) 提供以下库：

以下引导程序请求展示了如何请求 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>