使用会话令牌

请选择平台: Android iOS Web 服务

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

创建会话令牌

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

示例

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

接下来,我们从应用的角度来了解此事件流。

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

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