Google Places Autocomplete的sessiontoken有效性及计费规则咨询

SessionToken 官方说明 #

sessiontoken 是用于标识自动补全会话、实现计费逻辑的随机字符串，核心规则如下：

• 会话启动：用户开始输入查询内容时
• 会话结束：用户选择地点并调用Place Details接口时
• 会话限制：一个会话可包含多次Autocomplete查询，但仅能对应一次Place Details调用；会话内所有请求必须使用同一Google Cloud Console项目下的API密钥
• 令牌失效：会话结束后，该token立即失效，必须为新会话生成全新token
• 计费规则：若省略token或重复使用已失效/未结束会话的token，所有请求将按单独请求计费，无法享受会话打包计费优惠

问题解答 #

1. sessiontoken何时失效？
   有两个明确的失效触发场景：

   • 当用户完成地点选择并调用Place Details接口后，会话正式结束，对应的sessiontoken立即失效
   • 若会话未触发Place Details调用，当会话处于闲置状态达到Google设定的隐性时长阈值后，token也会失效（官方未公开具体时长）

2. 若不调用Place Details接口，可发起多少次Autocomplete查询，或该令牌是否存在过期时间限制？
   官方未明确规定不调用Place Details时的查询次数上限，但存在会话过期机制：

   • 只要会话未因闲置过期，可在同一会话内发起多次Autocomplete查询，此时所有请求会按单个会话计费
   • 当会话闲置超时后，sessiontoken失效，后续使用该token的请求会被当作无token的单独请求，每个请求单独计费

3. 若持续传递相同的sessiontoken值，令牌过期后是否会被视为新会话令牌重新生效？
   不会。sessiontoken一旦过期就彻底失效，重复传递该值不会被系统识别为新的会话令牌，后续请求会被判定为未提供sessiontoken的情况，每个请求单独计费。必须生成全新的随机字符串作为新的sessiontoken来开启新的会话。

内容的提问来源于stack exchange，提问作者Praveen Ahirwar