此功能要求您启用新一代 Places API，即 Places API（新）。如需了解详情，请参阅启用 API。

请选择平台： Android iOS JavaScript 网络服务

会话令牌

会话令牌是用户生成的字符串（或对象），用于将自动补全（新）调用跟踪为会话。自动补全（新）使用会话令牌将用户自动补全搜索的查询和选择阶段归入不同的会话，以便进行结算。

用户负责为每个会话创建会话令牌。会话令牌必须是可在网址和文件名中安全使用的 base64 字符串。用户可以以任何方式生成会话令牌，不过 Google 建议使用版本 4 通用唯一标识符 (UUID) 作为会话令牌。

会话以对“自动补全（新）”的调用开始，以对地点详情（新）或地址验证的调用结束。在每个会话中，用户可以输入多项“自动补全（新）”查询内容，并最终向“地点详情（新）”或“地址验证”服务发送一个请求。会话中每个请求所用的 API 密钥必须属于同一 Google Cloud 控制台项目。

注意：会话令牌无法在 Places API（旧版）端点与 Places API（新版）或地址验证端点之间交换。例如，地点自动补全（旧版）请求可以在同一会话中后跟地点详情（旧版）请求，但不能在同一会话中后跟地点详情（新版）请求或地址验证请求。

会话令牌会以以下方式终止：

• 调用地点详情（新）。
• 调用地址验证。
• 会话被放弃。

注意：您可以选择在请求中省略自动补全（新）会话令牌。如果省略会话令牌，系统会单独结算每个请求，并收取 SKU：自动补全请求费用。

会话结束后，令牌将失效；您的应用必须为每个新会话生成一个新的令牌。如果您省略 sessionToken 参数或重复使用会话令牌，系统会按未提供会话令牌的情况为新会话计费（每个请求均单独结算）。

如需详细了解“自动补全（新）”请求的结算方式，请参阅“自动补全（新）”和会话价格。