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 控制台中配置 HTTP 引荐来源网址限制,以限制哪些网址可以使用特定的 API 密钥。默认情况下,这类限制可以配置为仅允许某些路径使用某个 API 密钥。如果同一网域或同一来源的任何网址都可以使用该 API 密钥,您可以在授权来自 Maps JavaScript API 的请求时设置 auth_referrer_policy=origin,以限制发送的数据量。此参数从版本 3.46 开始提供。如果指定了此参数并且在 Cloud 控制台中启用了 HTTP 引荐来源网址限制,则只有在 HTTP 引荐来源网址限制与当前网站的网域匹配(未指定路径)的情况下,Maps JavaScript API 才能加载。