摘要

  • Google 官方定价文件写明:以 Place Details Essentials(IDs Only)结束的 Autocomplete(New)会话,最后的详情调用免费,但此前所有 Autocomplete 调用都按单次请求收费。
  • 如果以普通 Essentials 详情调用结束,前 12 次 Autocomplete 按次收费,第 13 次起进入不收费的会话使用 SKU;详情调用另行计费。只比较最后一步的标价会算错账。

免费的收据,收费的路程

用户在地图搜索框里输入地点,应用每打几个字就向 Google 请求候选结果。用户选中目标后,应用只要一个地点 ID,不要地址、电话或更多资料。开发者把 Place Details(New)的字段收紧到 IDs Only:响应更小,最后一次调用还免费。这个设计在代码审查里很容易赢得掌声。

账单却按另一套逻辑走。Google 的 Autocomplete 会话定价规则规定:只要以 Essentials(IDs Only)终止,之前每一次 Autocomplete 请求都按「Autocomplete Requests」逐次计费,就像没有使用会话一样。会话令牌仍把请求串起来,却不会为这条路径带来有些人以为的会话价格待遇。一个在结尾才选定的字段掩码,决定此前请求如何入账。

对照其他结尾,差别更加刺眼。普通 Essentials 结尾下,前 12 次补全请求单独收费,从第 13 次起归入不收费的「Autocomplete Session Usage」;详情调用本身另计。若以 Pro、Enterprise 详情或地址验证结束,Autocomplete 请求可全部归入不收费的会话使用 SKU,但结尾请求按其相应的较高等级收费。「免费 ID」与「整段流程便宜」不是同一句话。哪条路径成本更低,要看真实请求次数和各 SKU 的实际价格。

这是一种权限分离带来的预算盲区。工程团队有权决定字段,可能只盯响应大小;财务团队看到「会话数」,可能误以为令牌已锁定单一成本。真正的价格开关藏在最后的 API 请求里。Google 的公开文件没有任何客户的实际调用分布或发票,无法替具体部署宣布赢家。

令牌使用也要单独检查。Google 要求每个会话使用新令牌,同一会话的 API 密钥属于同一 Cloud 项目,旧版与新版请求不能混用。令牌缺失或复用会导致按次收费;未完成的会话同样如此。审计时必须区分「合法以 IDs Only 结束」与「令牌用错」:两者都可能出现逐次计费,修复动作却完全不同。

Google 把终点标为免费,却没有赠送到达终点的路。买方该追问的是:每种结尾之前发出了多少次请求,最终各自落在哪个计费 SKU?

来源