Places API 支持现有的地点详情。如果您熟悉现有的 Places API，新版“地点详情”将会进行以下更改：
- 必须遮盖字段。您必须指定您希望在响应中返回哪些字段。没有默认的已返回字段列表。如果省略此列表，这些方法会返回错误。如需了解详情，请参阅 FieldMask。
- 新的“地点详情”支持将 API 密钥和 OAuth 令牌作为身份验证机制。
- 新的“地点详情”中仅支持使用 JSON 作为响应格式。
- 地点详情（新）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 字段中。