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 实例。