简介
Places API 是一项服务，可通过多种方法接受针对位置数据的 HTTP 请求。它会返回有关场所、地理位置或受关注的地图注点的格式化位置数据和图像。为何要使用 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（新）接受以标准网址形式发送的请求，其中包含特定服务端点（例如 /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 服务的典型应用场景。在构建解决方案时，您可以使用其他端点，例如“附近搜索（新）”和“地点照片（新）”。| 1 | 开始设置 | 设置结算功能，启用 Places API（新），并发出您的第一个请求。 |
| 2 | 尝试基本文字搜索 | 使用文本搜索（新）发出文本搜索请求。 |
| 3 | 使用地点 ID 获取更多详情 | 许多 Google Maps Platform API 都会在响应中返回地点 ID。使用地点 ID 获取地点详情（新）。 |
| 4 | 获取地点的照片 | Place Photos（新）让您可以访问存储在地点数据库中的数百万张照片。使用 Place Photos（新）可访问某个地点的照片。 |