发布前核对清单

在 Google Cloud Console 中的什么位置管理客户端 ID

您可以在 Cloud Console 中找到高级计划客户端 ID 管理功能,位于 Google Maps Platform“凭据”页面底部的客户端 ID 部分。

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

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

重要提示:Google Maps Platform 高级计划不再开放注册,也不再提供给新客户。

确保您的团队有权访问必要资源

使用 Google Cloud Console

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

在发布之前,请为负责应用维护的所有开发者提供 Cloud Console 的访问权限。如果您遇到技术问题,访问 Cloud Console 将带来双重好处:既可以让您团队的成员与支持团队联系,又能让我们的支持团队与贵组织中相应的利益相关者联系。例如,如果我们检测到异常流量或行为(最终可能会中断您的应用),支持团队可能需要与贵组织联系。确保我们能够与相应开发者联系,这样可以防止您的服务出现意外中断。

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

重要意义:为了确保您可以及时掌握各 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 Console 中滚动到客户端 ID 部分来查看已授权网域的列表。若要对结合使用客户端 API 与 SSL 网域时遇到的错误进行问题排查,请先检查页面上有无通过 HTTP 加载的元素。请参阅有关排查授权问题的指南。

选择正确的 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 执行负载测试,这种服务可以吸收大量请求并通过有效响应回复请求,而不会涉及 Google Maps Platform。示例:如果您的 Geocoding API 配额为 20 QPS(每秒查询次数),对应用进行负载测试应确保应用可以处理 600 QPS,而向 Geocoding API 发送的请求不超过 20 QPS。

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