使用会话令牌

请选择平台： Android iOS Web 服务

会话令牌将用户自动补全搜索的查询和选择阶段归入不同的会话，以便进行结算。

创建会话令牌

用户负责为每个会话生成唯一的会话令牌。 Google 建议使用版本 4 UUID。

示例

当用户输入查询内容时，系统会每隔几次击键（而不是每次击键）调用一次自动补全请求，并返回一个可能的结果列表。当用户从结果列表中进行选择时，该选择会被视为一个请求，并且搜索期间的所有请求都会捆绑在一起并计为一个请求。如果用户选择某个地点，则搜索查询是免费的，只有地点数据请求需要付费。如果用户在会话开始后的几分钟内未做出选择，则仅收取搜索查询的费用。

我们从应用的角度来分析一下此事件流。

  1. 用户开始输入查询内容，以搜索“法国巴黎”。
  2. 检测到用户输入后，应用会创建一个新的会话令牌“令牌 A”。
  3. 随着用户输入，API 每隔几个字符就会发出一次自动补全请求，并针对每个字符显示新的潜在结果列表：
    “P”
    “Par”
    “Paris”
    “Paris, Fr”
  4. 当用户做出选择时：
    • 由查询产生的所有请求都会被分组并作为单个请求添加到由“令牌 A”表示的会话中。
    • 用户的选择会被计为“地点详情”请求，并添加到由“令牌 A”表示的会话中。
  5. 会话结束，应用舍弃“令牌 A”。

如需详细了解自动补全请求的结算方式，请参阅用量和结算。