Places API (New)

Places API 允许开发者访问各种用于搜索和检索地点的端点。

服务:places.googleapis.com

如要调用此服务,我们建议您使用 Maps JavaScript API 加载 Places 库,或使用 Google 提供的客户端库。如果您的应用需要使用您自己的库来调用此服务,则在发出 API 请求时应使用以下信息。

发现文档

发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档:

服务端点

服务端点是一个基础网址,指定了 API 服务的网络地址。一项服务可能有多个服务端点。此服务具有以下服务端点,下面的所有 URI 都与此服务端点相关:

  • https://places.googleapis.com

REST 资源:v1.places

方法
autocomplete POST /v1/places:autocomplete
返回指定输入的预测结果。
get GET /v1/{name=places/*}
根据地点的资源名称(格式为 places/{place_id} 的字符串)获取地点的详细信息。
searchNearby POST /v1/places:searchNearby
搜索位置附近的地点。
searchText POST /v1/places:searchText
基于文本查询的地点搜索。

REST 资源:v1.places.photos

方法
getMedia GET /v1/{name=places/*/photos/*/media}
获取具有照片引用字符串的照片媒体。