迁移到地点详情(新)

Places API 支持现有的 地点详情。 如果您熟悉现有的 Places API, 新版“地点详情” 进行以下更改:

  • 必须选择字段遮盖。您必须指定要返回的字段 。没有返回字段的默认列表。如果省略 那么这些方法会返回错误。如需了解详情,请参阅 FieldMask 的子类。
  • 新版“地点详情”支持 API 密钥OAuth 作为身份验证机制。
  • 新的响应格式仅支持 JSON 地点详情。
  • 地点详情的 JSON 响应格式(新) API 的格式已更改。有关详情,请参阅 迁移 Places API 响应

下表列出了现有 已重命名或修改的地点详情 新的“地点详情”或不再包含 支持。

当前参数 新增参数 备注
place_id places/PLACE_ID 字符串 places/PLACE_ID 也称为 地点的资源名称。在地点详情(新)的响应中: 附近搜索(新)和文本搜索(新) 请求,此字符串包含在响应的 name 字段中。 独立地点 ID 包含在响应的 id 字段中。
language languageCode
region regionCode

示例请求

以下示例 GET 请求使用现有的 地点详情。在此示例中,您将请求一个 JSON 响应包含有关地点 ID 的信息,并将所有参数作为网址传递 参数。此示例还使用了 fields,因此响应仅包含 地点的显示名称和设置了格式的地址:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'

对于“地点详情(新)”,您可以发出 GET 请求并 将网址参数和标头中的所有参数作为请求的一部分进行传递。这个 示例还使用了字段掩码,因此该响应仅包含显示名称 及采用特定格式的地址:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,formattedAddress" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

字符串 places/PLACE_ID 也称为地点 资源名称。在“地点详情”的响应中 (新)、附近搜索(新)和 文本搜索(新)请求中,此字符串包含在 响应的 name 字段。单独的地点 ID 包含在 响应的 id 字段。