为何使用 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
以下步骤介绍了使用 Places API 服务的典型用例场景。在构建解决方案时,您可以使用其他端点,例如“附近搜索(新)”和“地点照片(新)”。1 | 开始设置 | 首先设置 Google Cloud 项目,然后完成后续的设置说明,最后了解如何使用 API 密钥。 |
2 | 尝试进行基本文本搜索 | 使用文本搜索(新)发出文本搜索。 |
3 | 使用地点 ID 获取更多详细信息 | 许多 Google Maps Platform API 都会在响应中返回地点 ID。使用地点 ID 获取地点详情(新)。 |
4 | 获取某个地点的照片 | 借助地点照片(新)服务,您可以访问存储在地点数据库中的数百万张照片。使用地点照片(新)可访问地点的照片。 |