Method: places.get

根据地点的资源名称获取其详情,资源名称是 places/{placeId} 格式的字符串。

HTTP 请求

GET https://places.googleapis.com/v1/{name=places/*}

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。地点的资源名称,采用 places/{placeId} 格式。

查询参数

参数
languageCode

string

可选。系统会用首选语言(如果有)显示地点详情。

当前支持的语言列表:https://developers.google.com/maps/faq#languagesupport

regionCode

string

可选。请求来源位置的 Unicode 国家/地区代码 (CLDR)。此参数用于显示地点详情,例如特定于区域的地点名称(如果有)。该参数可能会影响根据适用法律的结果。如需了解详情,请参阅 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html

请注意,目前不支持 3 位数的区域代码。

sessionToken

string

可选。用于标识用于结算的自动补全会话的字符串。必须是网址和文件名安全 base64 字符串,长度最多为 36 个 ASCII 字符。否则,系统将返回 INVALID_ARGUMENT 错误。

会话在用户开始输入查询内容时开始,在用户选择地点并调用“地点详情”或“地址验证”时结束。每个会话可以有多个查询,后面紧跟一个“地点详情”或“地址验证”请求。会话中的每个请求使用的凭据必须属于同一个 Google Cloud 控制台项目。会话结束后,令牌将失效;您的应用必须为每个会话生成一个新的令牌。如果省略 sessionToken 参数,或您重复使用会话令牌,系统会按照未提供会话令牌的情况收取相应会话的费用(每个请求均单独计费)。

我们建议您遵循以下准则:

  • 对所有地点自动补全调用使用会话令牌。
  • 为每个会话生成一个新的令牌。建议使用版本 4 UUID。
  • 确保会话内所有“地点自动补全”请求、“地点详情”请求和地址验证请求所使用的凭据都属于同一个 Cloud 控制台项目。
  • 请务必为每个新会话传递唯一的会话令牌。在多个会话中使用同一令牌会导致每个请求分别计费。

请求正文

请求正文必须为空。

响应正文

如果成功,则响应正文包含一个 Place 实例。