Method: places.get

string

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

string

可选。地点详情将以首选语言（如果有）显示。

受支持语言的最新列表：https://developers.google.com/maps/faq#languagesupport。

string

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

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

string

可选。用于标识“自动补全”会话以便进行结算的字符串。必须是网址和文件名安全 base64 字符串，长度不超过 36 个 ASCII 字符。否则，系统会返回 INVALID_ARGUMENT 错误。

会话在用户开始输入查询内容时开始，并在用户选择地点并执行对“地点详情”或“地址验证”的调用时结束。在每个会话中，用户可以输入多项查询内容，并最终发出一个地点详情或地址验证请求。一个会话内用于每个请求的凭据必须属于同一个 Google Cloud 控制台项目。会话结束后，令牌将失效；您的应用必须为每个会话生成一个新的令牌。如果您省略 sessionToken 参数或重复使用会话令牌，系统会按未提供会话令牌的情况为会话计费（每个请求均单独结算）。

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

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