迁移到地点详情（新）

欧洲经济区 (EEA) 开发者

简介

Places API 支持地点详情（旧版）。如果您熟悉 Places API（旧版），地点详情（新）会进行以下更改：

  • 必须进行字段遮盖。您必须指定要在响应中返回哪些字段。没有默认的返回字段列表。如果您省略此列表，这些方法会返回错误。如需了解详情，请参阅 FieldMask。
  • 地点详情（新）支持使用 API 密钥和 OAuth 令牌作为身份验证机制。
  • 在地点详情（新）中，仅支持 JSON 作为响应格式。
  • Places API（新）的 JSON 响应格式已从旧版 API 的格式更改为新格式。如需了解详情，请参阅迁移 Places API 响应。

下表列出了“地点详情（旧版）”中已重命名或修改为“地点详情（新版）”的参数，以及不再支持的参数。

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

示例请求

以下示例 GET 请求使用“地点详情”（旧版）。在此示例中，您请求包含地点 ID 相关信息的 JSON 响应，并将所有参数作为网址参数传递。此示例还使用了 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 字段中。