概览

请选择平台： Android iOS JavaScript 网络服务
Places API 服务可通过各种方法接受 HTTP 请求获取位置数据。它返回有关场所、地理位置或著名地图注点的格式化位置数据和图像。

为何使用 Places API

创建位置感知功能，让用户能够轻松获取详细的位置数据。 Places API 提供的数据是基于真实、准确、最新且全面的地点模型构建的。下面是一些应用用例示例：

  • 在主要大都市地区展示公寓租赁，并专门展示面向各个城市的结果。
  • 在自提或配送状态更新中包含地点详情。
  • 显示某个区域内的公园列表，以及用户提交的照片和评价。
  • 为计划行程的用户提供沿途设施的联系方式、评价和价格水平。

Places API 的用途

您可以使用 Places API 在应用中包含以下功能：

  • 提供来自不同类型用户查询的地点搜索结果，例如文本输入、附近的地理位置，以及模糊或分类的用户查询。
  • 为不同的搜索类型（特定文本查询或分类查询）启用自动补全功能。
  • 优化地点的相关详情类型，例如营业时间、摘要、用户评价和照片。
  • 为您的应用提供的营业地点添加高品质的照片。

Places API 的运作方式

Places API 接受将请求作为包含特定服务端点（例如 /place 或 /photo）的标准网址。端点还接受请求中指定的格式类型（JSON 或 XML）。最后，服务请求会使用与该特定端点相关的参数来优化返回的数据。 例如，以下针对地址组成部分的地点详情请求的工作原理如下（假设返回 JSON 格式）：

https://maps.googleapis.com/maps/api/place/details/json
  ?place_id=ChIJrTLr-GyuEmsRBfy61i59si0
  &fields=address_components
  &key=YOUR_API_KEY

在这种情况下，该服务会使用提供的地点 ID 来查找请求的地点，并以 JSON 格式返回地址组成部分。

资源

下表汇总了 Places API 提供的资源及其返回的数据。

数据资源 返回的数据 返回格式
地点搜索 根据设备位置或搜索字符串返回地点列表。

请参阅地点搜索响应、附近搜索响应和文本搜索响应的详细信息。

  • JSON
  • XML
地点详情 返回特定地点的更多详细信息，包括用户评价。

如需了解详情，请参阅地点详情响应。

  • JSON
  • XML
地点照片 访问存储在 Google 地点数据库中的数百万张地点相关照片。

请参阅地点照片响应的详细信息。

  • JSON
  • XML
地点自动补全 在用户输入内容时自动填写地点的名称和/或地址。

请参阅地点自动补全响应的详细信息。

  • JSON
  • XML
查询自动补全 用于提供基于文本的地理位置搜索的查询预测服务，在用户输入内容时返回建议的查询。

请参阅查询自动补全响应的详细信息。

  • JSON
  • XML

如何使用 Places API

以下步骤介绍了在 Places API 服务中使用三个端点的典型使用场景。构建解决方案时，您可以使用其他端点，例如附近搜索、地点照片和查询自动补全。
1 开始设置 请先设置您的 Google Cloud 项目并完成以下设置说明，然后再了解如何使用 API 密钥。
2 尝试基本的文字搜索 获得 API 密钥后，请按照文本搜索指南中的基本文本搜索示例中的说明进行简单的文本搜索。
3 使用“查找地点”请求 “查找地点”请求会返回地点 ID 以及您请求的数据字段，例如营业时间、地址和照片。请参阅查找地点示例 ，并尝试更相关的用例。
4 了解“查找地点”响应基础知识 探索“查找地点”响应返回的数据。如需了解详情，请参阅查找地点响应。
5 使用地点 ID 了解详情 “查找地点”响应不提供特定地点的所有数据。您可以使用从“查找地点”响应返回的地点 ID 来获取有关地点的更多详细信息。请参阅地点详情。

可用的客户端库

通过以下某个客户端库使用您选择的语言调用此 API：

适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库，并且根据 Apache 2.0 许可开放源代码。 请从 GitHub 下载这些客户端库，并在那里找到安装说明和示例代码。

后续步骤