为何要使用 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 | 获取地点的照片 | “地点照片”服务可让您访问存储在“地点”中的数百万张照片 数据库。使用地点照片(新) 或地点详情 访问某个地点的照片。 |