为何要使用 Places API
创建位置感知功能，以便用户轻松获取详细的位置数据。 Places API 提供的数据建立在最准确、最新且最准确的基础之上， 全面的地点模型。以下是应用场景的示例：
- 显示主要大都市区的公寓租赁，以及专门针对城市的结果。
- 在自提或送货状态更新中添加地点详情。
- 显示某个区域内的公园列表，以及用户提交的照片和评价。
- 为规划行程的用户提供联系信息、评价以及沿途场所的价位。
您可以使用 Places API 执行哪些操作
您可以使用 Places API 在您的 应用：
- 提供来自不同类型用户查询（例如文本输入、 附近位置，以及含糊不清或分类的用户查询。
- 针对不同的搜索类型（特定文本查询）启用自动补全功能 即分类查询。
- 优化返回的地点详情类型，例如营业时间、摘要、 用户评价和照片。
- 向应用提供的营业地点添加高画质照片。
许多 Google Maps Platform API 支持 地点 ID，其中地点 ID 是唯一的 用于在 Google Places 数据库和 Google 地图上标识地点。您可通过多种方式获取地点 ID，包括通过 Places API 获取，也可以通过 Geocoding API、Routes API 和 Address Validation API 获取。
获得地点 ID 后，您可以使用 Places API 请求 特定场所或感兴趣的地点，例如其完整地址、电话号码 用户评分和评价
选择您的 Places API 版本
Places API 支持两个 API 版本： Places API 是 现有 API 和 Places API （新）是这些 API 的新一代版本。
随着 Places API（新）的发布，您的第一项任务是决定 一组 API。如果您是新客户或现有客户， 已在使用相应 API 的客户使用 本指南，了解 两个 API 之间的差异。
Places API 的运作方式
Places API（新）
Places API（新）以标准网址（带有特定
服务端点，例如 /places 或 places:searchText
并返回 JSON 响应。Places API（新）支持
API 密钥和 OAuth 令牌。
以下示例会发出“地点详情”请求，以返回
使用 API 密钥返回地点 ID：
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Places API 接受以具有特定
服务端点，例如 /place 或 /photo。端点还会
接受请求中指定的格式类型（JSON 或 XML）。服务
请求使用与该特定端点相关的参数来优化返回的数据。
以下示例会发出“地点详情”请求，以返回
JSON 格式的地点 ID：
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
在此实例中，服务使用提供的地点 ID 查找请求的地点，然后 以 JSON 格式返回地址组成部分。
资源
下表总结了 Places API。
| Places API | Places API（新） | 备注 |
|---|---|---|
| 查找地点 | 文本搜索（新） | 没有新版本的查找地点。 文本搜索（新）已将其取代。 |
| 附近搜索 | 附近搜索（新） | 所有使用现有 API 且包含文本查询的请求都应使用 文本搜索（新） 因为“附近搜索（新）”不支持文本输入。 |
| 文本搜索 | 文本搜索（新） | |
| 地点详情 | 地点详情（新） | |
| 地点照片 | 地点照片（新） | |
| 地点自动填充 | 自动补全（新） | |
| 查询自动补全 | 自动补全（新） | 自动补全功能中添加了一些功能（新增） |
如何使用 Places API
以下步骤涵盖了使用 Places API 服务的典型用例。在构建时 您可以使用其他端点，例如附近搜索和地点照片。| 1 | 开始设置 | 请先设置 Google Cloud 项目”，然后按照显示的设置说明进行操作，然后 了解如何使用您的 API 密钥。 对于 Places API（新），您还可以使用 OAuth 令牌。 |
| 2 | 尝试使用基本的文字搜索 | 使用文本搜索（新）或 文本搜索。 |
| 3 | 使用地点 ID 了解更多详情 | 许多 Google Maps Platform API 会在响应中返回地点 ID。使用 用于获取地点详情的地点 ID。 请参阅地点详情（新）和地点详情。 |
| 4 | 获取地点的照片 | “地点照片”服务可让您访问存储在“地点”中的数百万张照片 数据库。使用地点照片（新） 或地点详情 访问某个地点的照片。 |