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

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/maps-platform.places.details
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform