Places API：获取 API 密钥

注意：Google Maps Platform 高级计划不再适用于注册客户或新客户。

如需使用 Places API，您必须拥有一个 API 密钥。API 密钥是唯一标识符，用于对与您的项目相关联的请求进行身份验证，以便您使用相关产品和执行结算。

使用 API 密钥对请求进行身份验证，您可以执行以下操作：

在 Google Cloud Platform Console 中管理您的所有 API。
在 Google Cloud Platform Console 中访问实时使用情况数据和 30 天的历史使用情况数据。
在 Google Cloud 支持门户中查看使用情况报告（包含 30 天以上的数据）。

如需了解详情，请参阅面向高级计划客户提供的报告。

创建 API 密钥

您必须至少有一个与您的项目相关联的 API 密钥。

要获取 API 密钥，请执行以下操作：

访问 Google Cloud Platform Console。
点击项目下拉菜单，选择在您购买高级计划时系统为您创建的项目。项目名称以 Google Maps API for Business 或 Google Maps for Work 或 Google Maps 开头。

注意：如需拥有对计划中的功能的完整访问权限，高级计划客户应使用与其高级计划帐号相关联的项目。购买许可时，您会收到如下格式的高级计划资产名称：gme-[company] & proj-[number] ([type])。为确保您访问的是正确的项目，请通过 console.cloud.google.com/project/number（将 number 替换为您的项目编号）以项目所有者身份登录控制台。您可以在欢迎邮件中找到项目所有者。

点击菜单按钮，然后依次选择 API 和服务 > 凭据。
在凭据页面上，依次点击创建凭据 > API 密钥。
已创建的 API 密钥对话框会显示您新创建的 API 密钥（一个加密字符串）。
点击关闭。
新的 API 密钥位于凭据页面的 API 密钥下。

向您的请求添加 API 密钥

您必须在每个 Places API 请求中添加 API 密钥。在以下示例中，将 YOUR_API_KEY 替换为您的 API 密钥。

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?location=-33.8670522,151.1957362
  &radius=500
  &types=food
  &name=harbour
  &key=YOUR_API_KEY

限制 API 密钥

通过限制 API 密钥，您可以确保只能使用您的 API 密钥发出已授权的请求，从而提高应用安全性。我们强烈建议您按照相关说明为您的 API 密钥设置限制。如需了解详情，请参阅 API 密钥最佳做法。

如需限制 API 密钥，请执行以下操作：

在 GCP Console 中，打开项目选择器页面，选择或创建要向其添加 API 密钥的 Google Cloud 项目。

转到项目选择器页面
依次转到 API 和服务 > 凭据页面。

转到“凭据”页面
选择您要设置限制的 API 密钥。系统随即会显示 API 密钥属性页面。
在密钥限制下，设置以下限制：

应用限制：

若要接受来自您提供的一系列网络服务器 IP 地址的请求，请从应用限制列表中选择 IP 地址（网络服务器、Cron 作业等）。
指定一个 IPv4 或 IPv6 地址，或采用 CIDR 表示法的子网（例如 192.168.0.0/22）。如果您需要输入其他条目，在您添加完上一个条目后，系统会显示一个新框。

API 限制：

点击限制密钥。
从选择 API 下拉列表中选择 Places API。
（如果 Places API 未列出，您需要启用它。）

点击保存以完成更改。

排查身份验证问题

如果您的请求格式不正确，或者提供的签名无效，Places API 会返回 HTTP 403 (Forbidden) 错误。

如需对各个网址进行问题排查，您可以使用网址签名调试程序。借助该调试程序，您可以快速验证网址和由您的应用生成的签名。

或者，高级计划客户也可以通过以下方式对各个网址进行问题排查：登录 Google Cloud 支持门户，然后依次选择 Resources > Google Maps Platform Premium Plan online tools > URL Signing Debugger for Web Service and Image APIs。