发布前核对清单

在 Google Cloud 控制台中的什么位置管理客户端 ID

您可以在 Cloud 控制台中找到专业版方案客户端 ID 管理功能,该功能位于 Google Maps Platform“凭据”页面底部的客户端 ID 部分。

“凭据”页面上新的“客户端 ID”区域

进一步的客户端 ID 管理任务(包括网址授权和客户端 ID 签名密钥管理)可在单独的“客户端 ID”页面上访问,只需点击客户端 ID 部分最右侧的 修改图标即可。

重要提示:Google Maps Platform 专业版方案不再开放注册,也不再提供给新客户。

确保您的团队能够访问必要资源

使用 Google Cloud 控制台

重要意义:您可以通过 Google Cloud 控制台获取用量报告新闻信息流和开发者资源等信息。更重要的是,如果您在开发或发布期间遇到任何技术问题,可以通过 Cloud 控制台向 Google Maps Platform 支持团队提交支持请求

在发布之前,请为负责应用维护的所有开发者提供 Cloud 控制台的访问权限。如果您遇到技术问题,只要访问 Cloud 控制台,您的团队成员就能与支持团队联系,我们的支持团队也能直接联系贵组织的相应人员。例如,如果我们检测到可能会使您的应用出现故障的异常流量或行为,支持团队可能需要与贵组织联系。请确保我们能够与相应开发者联系,这样可以防止您的服务意外中断。

订阅网上论坛的电子邮件通知

重要意义:为了确保您可以及时掌握各 Maps API 的最新开发和变更信息,我们建议您订阅以下一个或多个网上论坛的电子邮件通知:

优化应用

将防火墙配置为允许访问 Google Maps Platform 服务

重要意义:Google Maps Platform 服务使用多个网域,其中一些网域并不属于 *google.com 网域。如果您使用限制性防火墙,请务必允许访问每个 Maps API 服务所使用的网域。如果您的防火墙不允许访问这些网域,API 请求将失败,这可能会导致您的应用无法正常工作。请查看各 Maps API 所用网域的完整列表

我们不建议按 IP 地址管理防火墙限制,因为与这些网域关联的 IP 不是静态的。

注意:Google Maps Platform 服务分别为入站流量和出站流量使用端口 80 (http) 和 443 (https)。这些服务还需要 GET、POST、PUT、DELETE 和 HEAD 请求。请根据 API 和用例,将您的防火墙配置为允许通过这些端口传输流量和允许上述请求。

授权 SSL 网域,以便与 Maps JavaScript API 配合使用

重要意义:将 Maps JavaScript API 与 SSL 网域配合使用时,必须明确授权您的 HTTPS 网域,以确保您的请求不会被拒。请注意,授权 http://yourdomain.com 不会自动启用与其对应的 SSL 网域 https://yourdomain.com。您可以在 Cloud 控制台中向下滚动到客户端 ID 部分,查看已授权网域的列表。若要对结合使用客户端 API 与 SSL 网域时遇到的错误进行问题排查,请先检查页面上有无通过 HTTP 加载的元素。请参阅有关排查授权问题的指南。

选择正确的 API 版本

重要意义:在开发应用之前,请务必先了解哪些版本的 API 已弃用。采用非弃用的 API 版本来开发应用,就不必在已弃用的 API 停止提供时寻找替代版本,这有助于节省整体的开发时间和成本。

尤其要了解 Maps JavaScript API 使用的版本控制策略,以免在您的环境中意外使用错误版本的 API。

例如,尽管您的开发或测试环境可能适合使用实验性版本的 API,但是我们强烈建议不要在生产环境中使用实验性版本。我们的服务等级协议 (SLA) 仅适用于稳定版本的 API,因此,在生产环境中仅应使用稳定版本。

请参阅有关 Maps JavaScript API 版本的指南。

在客户端与服务器端设计方案之间进行选择

重要意义:选择客户端还是服务器端方法是关于架构的决策,对应用的稳定性和可伸缩性而言至关重要。总体来说,服务器端方法适用于对离线记录(即不在应用内的记录)进行预处理和后期处理。客户端方法则适用于处理应用与用户互动的部分(即实时处理用户提交的请求)。

在应使用客户端方法的情况下却部署了服务器端方法,这是导致超出配额并使得应用无法正常工作的首要原因。我们强烈建议您先查阅地理编码策略,然后再设计或发布依赖于服务器端调用的应用。

优化配额使用

重要意义:了解应用消耗配额(称为 Maps API 额度)的方式有助于您减少需要支付的费用。例如,如果您使用 Maps JavaScript API,对于每次地图加载,您的应用都会消耗 Maps API 额度。请参阅有关专业版方案使用费率和用量限额的指南。

管理您的网络服务配额使用

在发布服务之前,请务必了解与配额相关的各种错误(例如 OVER_QUERY_LIMITUser Rate Limit Exceeded),并在您的应用中设置正确的逻辑,以便在超出配额时响应此类错误。请先阅读用量限额常见问题解答。如需了解各个 API 返回的状态代码,请参阅相应 API 的开发者指南。例如,查看有关 Directions API 状态代码的指南。了解这些概念并采取相应做法,可以有效避免应用超出配额限制、被 Google 阻止和/或无法正常工作。

对您的应用执行负载测试

重要意义:对应用执行负载测试能够确保它可以处理大量请求,而不会超出您的 Maps API 配额。

虽然 Google Maps Platform 可以处理非常高的流量,但针对实时 Google 服务进行测试仍会导致您的应用超出其允许的配额,且可能会被 Google 阻止。此外,您还需要承担负载测试产生的使用费。

相反,对应用进行负载测试时,应确保应用可以应对大量的请求,而且不超出您的 Maps API 配额或被 Google 阻止。为了防止意外耗尽配额,应仅使用模拟 API 执行负载测试。模拟 API 可以接收大量请求并传回有效响应,不需要经由 Google Maps Platform 处理。示例:如果您的 Geocoding API 配额为 20 QPS(即每秒查询 20 次),对应用进行负载测试时,应确保应用可以处理 600 QPS,而向 Geocoding API 发送的请求不超过 20 QPS。

如果您打算执行大量负载测试,请与 Google 支持团队联系以获得相关指导,并确保 Google 了解您计划的测试。