使用会话令牌

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

创建会话令牌

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

示例

在用户输入查询时,系统会每隔几个按键(不是按字符)调用一次“自动补全”请求,并返回可能的结果列表。当用户从结果列表中进行选择时,相应选择计为一个请求,搜索期间发出的所有请求都会捆绑并计为一个请求。如果用户选择某个地点,可免费使用搜索查询,并且只需对地点数据请求付费。如果用户在会话开始后的几分钟内未做出选择,则只需为搜索查询付费。

让我们从应用的角度来看一下这种事件流。

  1. 一位用户开始输入查询来搜索“法国巴黎”。
  2. 检测到用户输入时,应用会创建一个新的会话令牌,即“令牌 A”。
  3. 在用户输入内容时,API 会每隔几个字符发出一次自动补全请求,同时针对每个字符显示一个新的潜在结果列表:
    "P"
    “Par”
    “Paris,”
    “Paris, Fr”
  4. 当用户做出选择时:
    • 通过查询生成的所有请求都会组合起来,作为单个请求添加到由“令牌 A”表示的会话中。
    • 系统会将用户的选择计为“地点详情”请求,并将其添加到由“令牌 A”表示的会话中。
  5. 会话结束,并且应用舍弃“令牌 A”。

如需详细了解“自动补全”请求的结算方式,请参阅使用量和结算