一切就绪!

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

激活 Google Places API Web Service

为帮助您起步,我们将引导您在 Google 开发者控制台中先完成几项任务:

  1. 创建或选择项目
  2. 激活 Google Places API Web Service
  3. 创建相应密钥
继续

获取 Google Places API Web Service 的密钥

Google Places API Web Service 使用 API 密钥识别您的应用。 通过在请求中加入密钥,您可以在 Google API Console 中监控应用的 API 使用情况,能够获得大量的每日免费配额,并确保 Google 可以在必要时就应用的相关事宜与您联系。

如需了解详细信息,请参阅 Google API Console 帮助

  • 标准 API 客户需要一个在您所选择的项目中设置的 API 密钥

  • 用于 Premium Plan 许可的 Google Places API 客户需要在 Google Maps Premium 项目(在您订购 Google Maps APIs Premium Plan 时为您创建的项目)中设置 API 密钥

如果您还没有购买该 API 的访问权限,请联系销售人员

获取 API 密钥

如果您使用的是标准 Google Places API Web Service

要开始使用 Google Places API Web Service,请点击下面的按钮,系统将指导您完成激活 Google Places API Web Service 和获取 API 密钥的流程。

获取密钥

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

  1. 转到 Google API Console
  2. 创建或选择一个项目。
  3. 点击 Continue 启用 API。
  4. Credentials 页面上,获取 API 密钥(并设置 API 密钥限制)。

注:如果已有不受限的 API 密钥或拥有存在服务器限制的密钥,可以使用该密钥。

  1. 为了防止配额盗用,请确保您的 API 密钥遵循这些最佳做法
  2. (可选)启用计费。 请参阅 使用限制和收费 了解更多信息。

请不要在服务器代码外使用此密钥。 例如,请不要将其嵌入网页或移动应用中。

注:Google Places API Web Service 无法使用具有 Android 或 iOS 限制的 API 密钥。

如果您已购买 Google Maps APIs Premium Plan

要开始使用具有 Google Maps APIs Premium Plan 的 Google Places API Web Service,请点击下面的按钮,系统将指导您完成获取 API 密钥的流程。

注: 要访问您所有的 Premium Plan 权益(包括使用限制),在项目下拉菜单中,请务必选择您在购买 Google Maps APIs Premium Plan 时,系统为您创建的项目。*

获取密钥

或者,请按照下列步骤获取与 Premium Plan 搭配使用的 API 密钥:

  1. 转到 Google API Console
  2. 从项目下拉菜单中,选择 Google Maps Premium 项目。*
  3. 点击 Continue

  4. Credentials 页面上,获取 API 密钥(并设置 API 密钥限制)。

注:如果已有不受限的 API 密钥或拥有存在服务器限制的密钥,可以使用该密钥。

  1. 为了防止配额盗用,请确保您的 API 密钥遵循这些最佳做法

您也可以<a class="gc-analytics-event"

  data-category="lookUpExistingKey"
  data-action="linkClick"
  data-label="body"
  href="https://console.developers.google.com/project/_/apiui/credential" target="_blank">
  在 Google API Console 中查找现有密钥</a>。

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

API 密钥限制的类型

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

在您的请求中指定密钥

您的密钥必须作为 key 参数值的形式随每个请求一起传递。

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

不带密钥的请求将失败。

限制 IP 地址

要防止其他应用使用您的密钥和消耗您的配额,您可以限制能够使用您的 API 密钥发送请求的 IP 地址:

  1. 转到 Google API Console
  2. 选择在您注册时为您创建的项目。
  3. API keys 列表中,选择您正在使用的密钥。
  4. Restrictions 部分中,选择 IP addresses (web servers, cron jobs, etc.)

  5. Accept requests from these server IP addresses 下,输入允许其使用您的密钥的 IP 地址,每个地址一行。 您也可以使用 CIDR 表示法输入子网(例如,

192.168.0.0/22)。

无论您使用的是标准计划还是高级计划,都可以使用这些步骤。 如需了解详细信息,请参阅定价和计划

发送以下问题的反馈:

此网页
location_on
Google Places API Web Service