概览

为何使用 Places API

创建感知位置信息的功能，以便向用户提供详细的位置数据。 通过 Places API 提供的数据基于真实世界最准确、最新且全面的位置模型之一。以下是应用的示例用例：

• 展示大都市圈内的公寓出租信息，并将结果定位到特定城市。
• 在取件或送达状态更新中添加地点详细信息。
• 显示某个区域的公园列表，以及用户提交的照片和评价。
• 为规划行程的用户提供沿途商家的联系信息、评价和价格水平。

您可以使用 Places API 执行哪些操作

您可以使用 Places API 在应用中添加以下功能：

• 根据不同类型的用户查询（例如文本输入、附近地点以及模糊或分类用户查询）提供地点搜索结果。
• 为不同的搜索类型（特定文本查询或分类查询）启用自动补全功能。
• 优化返回的地点详细信息类型，例如营业时间、摘要、用户评价和照片。
• 为您的应用所提供的地点添加高质量照片。

许多 Google Maps Platform API 都支持地点 ID，地点 ID 可唯一标识 Google 地点数据库中和 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