身份验证与授权

此页面仅适用于拥有旧版 Maps APIs for Work 或 Maps API for Business 许可的客户。此页面不适用于拥有新版 Google Maps APIs Premium Plan2016 年 1 月上市发售)的客户。

客户端 ID

向 Google Maps JavaScript API 验证 Google Maps APIs for Work 客户的身份需要结合使用唯一的客户端 ID 和网址注册。

获取客户端 ID

要获取 Google Maps APIs for Work 的特殊功能,您在获取任意 API 内容库或服务时必须提供客户端 ID。注册 Google Maps APIs for Work 时,您将从 Google Cloud Support Portal 接收此客户端 ID。所有客户端 ID 都以 gme- 前缀开头。

此客户端 ID 不是密钥。它仅在您授权的网址中发挥作用,因此,您不需要担心它的安全性。

在加载 API 时指定客户端 ID

在加载 Google Maps JavaScript API 时以 client 参数值的形式指定您的客户端 ID:

<script async defer src="https://maps.googleapis.com/maps/api/js?client=YOUR_CLIENT_ID &v=3.26&callback=initMap"></script>

如上面的示例所示,您必须通过附加一个 v=3.26 参数来指定发布版本(也称为功能稳定版本)或一个较早的版本。使用实验性版本的应用不在 Google Maps APIs for Work SLA 的涵盖范围内。

注册您已经授权的网址

要防止第三方在他们自己的网站上使用您的客户端 ID,客户端 ID 的使用范围被限制为您专门授权的网址列表。

要查看您已经授权的网址或者授权更多网址,请执行以下操作:

  1. 登录 Google Cloud Support Portal
  2. 在左侧菜单中,点击 Maps:Manage Client ID

您一次最多可以添加 100 个网址,总共可添加 3000 个网址。如果您需要更高的限额,请联系支持

下面的注意事项适用于已获授权的相关网址:

域名或 IP 地址不必设置为可公开访问。
例如,http://myintranethttp://192.168.1.1 均是有效输入项。
指定域名的所有子域名也将获得授权。
例如,如果 http://example.com 获得授权,http://www.example.com 也将获得授权。反之则不成立:如果 http://www.example.com 获得授权,http://example.com 不一定会获得授权。
已获授权的路径的所有子路径也将获得授权。
例如,如果 http://example.com 获得授权,http://example.com/foo 也将获得授权。此外,由于指定域名的子域名也会获得授权,http://sub.example.com/bar 将获得授权。
路径区分大小写。
例如,http://www.example.com/ThisPath/http://www.example.com/thispath/ 不同。
您可以将有效网址限制为使用特定端口的网址。
例如,如果指定 http://example.com:8080/foohttp://example.com 将不会获得授权。
HTTP 和 HTTPS 协议被视为不同的网址。
例如,如果 https://example.com 获得授权,http://example.com 不一定会获得授权。如果您想要同时授权这两个网址,可以添加一个不使用协议的域名:example.com/

上面的所有规则将应用到每个授权,因此,您应仔细规划授权。例如,由于所有子域名和指定路径的所有子路径都会获得授权,您可能会向计划之外的页面授权。例如:

http://example.com/ 也会授权 http://sub.example.com/path

如需了解详细信息,请参阅排查 Google Maps APIs for Work 实现的授权问题