Maps JavaScript API 网址参数

本文档介绍了在加载 Maps JavaScript API 时,您可以在脚本加载网址的查询字符串中指定所有参数。有些参数是必填参数,而有些参数则是可选参数。根据网址的标准,所有参数均使用和号字符 (&) 进行分隔。

以下示例网址包含所有可能的参数的占位符:

https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY
&callback=FUNCTION_NAME
&v=VERSION
&libraries="LIBRARIES"
&language="LANGUAGE"
&region="REGION"
&solution_channel="SOLUTION_IDENTIFIER"
&auth_referrer_policy="AUTH_REFERRER_POLICY"

以下示例 script 标记中的网址会加载 Maps JavaScript API:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
</script>

必需参数

加载 Maps JavaScript API 时需要使用以下参数。

  • key:您的 API 密钥。除非指定了有效的 API 密钥,否则系统不会加载 Maps JavaScript API。

  • callback:Maps JavaScript API 完全加载后要调用的全局函数的名称。

可选参数

使用这些参数可以请求特定版本的 Maps JavaScript API、加载其他库、将地图本地化或指定 HTTP 引荐来源网址检查政策

  • v:要使用的 Maps JavaScript API 版本。

  • libraries:要加载的其他 Maps JavaScript API 的列表(以英文逗号分隔)。

  • language:要使用的语言。这会影响控件、版权通知、行车路线和控件标签的名称,以及对服务请求的响应。请参阅支持的语言列表

  • region:要使用的区域代码。这会基于特定的国家或地区更改地图的行为。

  • solution_channel:Google Maps Platform 提供了许多类型的示例代码,可帮助您快速上手。为了跟踪更复杂的代码示例的采用情况并提高解决方案质量,Google 在示例代码的 API 调用中添加了 solution_channel 查询参数。

  • auth_referrer_policy:Maps JS 客户可以在 Cloud Console 中配置 HTTP 引荐来源网址限制,以限制哪些网址可以使用特定的 API 密钥。默认情况下,这些限制可以配置为仅允许某些路径使用 API 密钥。如果同一网域或来源上的任何网址都可能会使用 API 密钥,您可以设置 auth_referrer_policy=origin 以限制在授权来自 Maps JavaScript API 的请求时发送的数据量。从版本 3.46 开始提供。 如果指定了此参数并且在 Cloud Console 上启用了 HTTP 引荐来源网址限制,那么只有在存在与当前网站网域匹配的 HTTP 引荐来源网址限制(未指定路径)的情况下,Maps JavaScript API 才能加载。