迁移到地点详情(新)
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
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
字段。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-08-29。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u6700\u540e\u66f4\u65b0\u65f6\u95f4 (UTC)\uff1a2024-08-29\u3002"}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2024-08-29。"]]