要加载 Maps JavaScript API 的 JavaScript 代码,您需要在网页上添加格式为 https://maps.googleapis.com/maps/api/js 的引导程序网址。此引导程序请求会加载所有供在 Maps JavaScript API 中使用的主要 JavaScript 对象和符号。此外,明确请求时才会加载的自包含库中也提供了一些 API 功能。将辅助组件分解成库可使主 API 快速加载(和解析)。您只会产生在必要时加载和解析库的额外开销。

您可以通过在引导程序请求中指定 libraries 参数并提供一个或多个库的名称来加载其他库。您可以采用逗号分隔列表的形式指定多个库,然后通过 google.maps.libraryName 命名空间访问这些库。

提供的库如下:

  • drawing,提供一个图形界面,以供用户在地图上绘制多边形、矩形、折线、圆形和标记。如需了解详情,请参阅绘图库文档
  • geometry,包含实用函数,用于计算地球表面的标量几何值(例如距离和面积)。如需了解详情,请参阅几何图形库文档
  • journeySharing(仅限 Beta 渠道),为 Google Maps Platform 交通运输和物流解决方案提供支持。
  • localContext,向用户显示指定位置附近的主要景点。如需了解详情,请参阅 Local Context 库文档
  • marker 可让您向地图添加可定制、高性能的高级标记。如需了解详情,请参阅高级标记文档
  • places,让您的应用能够在指定的区域内搜索场所、地理位置或著名地图注点等地点。如需了解详情,请参阅地点库文档
  • visualization,提供热图,用于直观呈现数据。如需了解详情,请参阅可视化库文档

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