一切就绪!

着手开发前,请先阅读我们的开发者文档

激活 Google Maps JavaScript API

为帮助您起步,我们将引导您在 Google Developers Console 中先完成几项任务:

  1. 创建或选择项目
  2. 激活 Google Maps JavaScript API 及相关服务
  3. 创建相应密钥
继续

获取密钥/身份验证

所有 Google Maps JavaScript API 应用均需要身份验证。

  • 标准 API 用户:如果您通过标准计划使用 API,则必须在选择的项目中设置 API 密钥。请查看有关标准 API 的 API 密钥的详细信息。
  • Premium Plan 用户:如果您通过 Google Maps APIs Premium Plan 使用 API,则您有两种进行身份验证的选择:
    • 使用 Google Maps APIs Premium Plan 项目(系统在您购买 Premium Plan 时为您创建)中设置的 API 密钥
        或者
    • 使用您的客户端 ID 来替代 API 密钥。

    请查看下面的 Google Maps APIs Premium Plan 部分,了解有关选择最佳身份验证方法的信息。

标准 API 的身份验证 - API 密钥

要使用标准 API,您必须在加载 API 时加入 API 密钥。

使用 API 密钥的优势:

  • 借助 API 密钥,您可以在 Google API Console 中监控应用的 API 使用情况。如需了解详细信息,请参阅 Google API Console 帮助
  • 您可以使用密钥获取大量的每日免费配额,并可以通过选择启用按需付费来增加每日配额。
  • 注册 API 密钥,确保 Google 可以在必要时就应用相关事宜与您联系。

获取 API 密钥

要开始使用 Google Maps JavaScript API,请点击下面的按钮。系统将自动指导您完成激活 Google Maps JavaScript API 和任何相关服务的流程。

获取密钥

或者,请按照下列步骤获取 API 密钥:

  1. 转至 Google API Console
  2. 创建或选择一个项目。
  3. 点击 Continue,启用 API 和任何相关服务。
  4. Credentials 页面上,获取 API 密钥(并设置 API 密钥限制)。
    注:如果已有不受限的 API 密钥或有浏览器限制的密钥,可以使用该密钥。
  5. 为了防止配额盗用,请遵循这些最佳做法保护您的 API 密钥
  6. (可选)启用计费。如需了解详细信息,请参阅使用限制


在 Google API Console 中,您还可以查找现有密钥查看已启用的 API 的列表

如需了解有关使用 Google API Console 的详细信息,请参阅 API Console 帮助

API 密钥限制的类型

Google Maps API 可用于 Android 或 iOS 应用、网络浏览器,并可通过 HTTP 网络服务使用。任何平台上的 API 均可以使用通用(无限制的)API 密钥。您可以选择向 API 密钥添加限制(例如 HTTP 引荐来源网址)。受限后,密钥仅会在支持这一类型限制的平台上有效。详细了解密钥和凭据

加载 API 时指定密钥

如需指定密钥,请在加载 API 时将其作为 key 参数的值加入。

例如:

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

Google Maps APIs Premium Plan 客户的身份验证

本部分中的信息仅适用于 2016 年 1 月 6 日开始发售的新 Google Maps APIs Premium Plan。

拥有旧版 Maps APIs for Work 或 Maps API for Business 许可?请参阅我们的 Maps APIs for Work 许可指南。要确定您是否拥有旧版许可,请执行以下操作:在 Google Cloud Support Portal 中,点击左侧的 Maps:Usage Report。如果报告顶部的 ID 采用以下格式,则说明您拥有新版 Premium Plan:
gme-[company] & proj-[number] ([type])
。否则,您拥有的是旧版许可。

当通过 Google Maps APIs Premium Plan 许可使用 Google Maps JavaScript API 时,您必须使用 API 密钥或客户端 ID 对您的应用进行身份验证。:如果您拥有旧 Maps API for Business 许可,则您必须使用客户端 ID,而不是 API 密钥。

当决定要使用哪一种身份验证方法时,请考虑以下因素:

  • API 密钥(Google Maps APIs Premium Plan 客户可使用,但持有旧 Maps API for Business 许可的客户不可使用)- 通过使用 API 密钥来对请求进行身份验证,您可以:
  • 客户端 ID - 通过使用您的客户端 ID(而不是 API 密钥)来对请求进行身份验证,您可以:
    • 向请求添加 channel 参数,从而可以查看更详细的消耗报告
    • Google Cloud Support Portal 中查看使用情况报告(包含 30 天以上的数据使用情况)
    • 为 Maps JavaScript API 使用地图分析工具

获取有关 Premium Plan 客户可以使用的报告的详细信息。

使用 API 密钥

要使用 API 密钥对 Google Maps JavaScript API 进行身份验证,请点击下面的按钮。系统将指导您完成获取 API 密钥的流程。

重要说明:在项目下拉菜单中,请务必选择在您购买 Premium Plan 时,系统为您创建的项目。项目名称以 Google Maps APIs for Business 或 Google Maps for Work 或 Google Maps 开头。*

获取密钥

或者,请按照下列步骤获取 API 密钥:

  1. 转至 Google API Console
  2. 从项目下拉菜单中,选择 Google Maps Premium 项目。*
  3. 点击 Continue
  4. Credentials 页面上,获取 API 密钥(并设置 API 密钥限制)。
    注:如果已有不受限的 API 密钥或有浏览器限制的密钥,可以使用该密钥。
  5. 为了防止配额盗用,请遵循这些最佳做法保护您的 API 密钥

* 注:在项目下拉菜单中,您必须选择当您购买 Premium Plan 时为您创建的项目。项目名称以 Google Maps APIs for Business 或 Google Maps for Work 或 Google Maps 开头。重要说明:如果您拥有旧 Maps API for Business 许可,则您必须使用客户端 ID,而不是 API 密钥。


您也可以在 Google API Console 中查找现有密钥

如需了解有关使用 Google API Console 的详细信息,请参阅 API Console 帮助

加载 API 时指定密钥

如需指定密钥,请在加载 API 时将其作为 key 参数的值加入。

例如:

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

使用客户端 ID

使用客户端 ID(而不是 API 密钥)对 Google Maps JavaScript API 进行身份验证需要结合使用唯一的客户端 ID网址注册

如果您之前使用 API 密钥进行身份验证并转而使用客户端 ID,则您必须在加载 API 之前移除 key 参数。如果同时包含客户端 ID 和 API 密钥,API 将无法加载

您的客户端 ID

购买 Google Maps APIs Premium Plan 许可后,您将收到 Google 发送的一封欢迎电子邮件,其中包含您的客户端 ID。您的客户端 ID 用于访问 Google Maps APIs Premium Plan 的特殊功能。所有客户端 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 Premium Plan 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 Premium Plan 的授权问题

发送以下问题的反馈:

此网页
Google Maps JavaScript API
Google Maps JavaScript API
需要帮助?请访问我们的支持页面