自动补全和会话价格

请选择平台: Android iOS JavaScript 网络服务

Google 建议您使用会话和地点自动补全功能。会话有助于简化定价,并提供与地点自动补全功能搭配使用的一致定价模式。

会话定价从第一个包含会话令牌的“地点自动补全”请求开始,接着执行每个后续的“地点自动补全”请求,然后向使用该会话令牌的地点详情请求终止。

会话终止后,如果对“地点自动补全”和“地点详情(新)”的任何使用已过期的会话令牌调用,系统会按照没有会话令牌的情况进行结算。

未完成的会话(即并非因发出的“地点详情”请求而终止的会话)只需为使用 SKU:自动补全请求的“自动补全”请求付费。

以下是三种最常见的价格方案:

  • 自动补全位置数据
  • 自动补全地点发现
  • 自动补全结账和送货信息

自动补全位置数据

在此场景中,您希望使用自动补全和地点详情(新)来获取地点的相关位置信息。例如,从自动补全功能中选择一条建议,然后使用地点详情来获取地点的经纬度坐标,以在地图上显示该地点。

位置信息可能包括地点:

  • 地址
  • 位置(以经纬度坐标表示)
  • Plus Code
  • 类型
  • 视口

此会话由一个对“地点详情”的请求终止,该请求请求了 SKU:地点详情(仅限位置)定义的任何字段。

然后,您需要按以下方式支付费用:

  • 每个“地点自动补全”请求,最多 12 个请求,使用 SKU:自动补全请求
    • 费用为每 1,000 次请求和 10 万次请求 $2.83
    • 按每 1,000 个请求(最多 50 万个请求)$2.27 计费
  • 当您处于活跃会话期间,“地点自动补全”请求 13 及更高版本将按 SKU:自动补全会话用量计费,这意味着这些请求是免费的。
  • 使用 SKU:地点详情(仅限位置)的一个“地点详情”请求:
    • 按每 1,000 个请求(不超过 10 万个请求)$5.00 计费
    • 按每 1,000 个请求(不超过 50 万个请求)$4.00 计费

自动补全地点发现

在“自动补全地点发现”场景中,您有兴趣获取的不仅仅是关于地点的位置数据。例如,您可以请求执行以下任一操作:

  • 无障碍选项
  • 当前营业时间
  • 停车选项
  • 评价
  • 评分

在这种情况下,您的会话将通过向“地点详情(新)”发出的请求而终止,该请求会请求“地点详情”的基本高级首选 SKU 中包含的任何字段

然后,您需要按以下方式支付费用:

价格示例

下表显示了三种主要会话场景的价格示例。此表还列出了您的对账单中显示的每种场景的 SKU。

场景 请求示例 结算的 SKU 每 1000 个请求的价格
位置数据
  • 5 次针对地点自动补全的请求按 $2.83 计费(会话中上限为 12 次请求)
  • 1 个针对地点详情的请求按 $5 结算
地点发现
  • 5 项地点自动补全请求不收费
  • 1 项地点详情请求费用为 25 美元
结账和送餐
  • 5 项针对地点自动补全的请求
  • 1 个地址验证请求
  • 针对“地点自动补全”的 5 次请求免费计费
  • 1 个地址验证首选请求费用为 25 美元

不含会话的价格示例

如果您不使用会话,则使用 SKU:自动补全请求,您需要按请求为地点自动补全服务付费,价格为每 1000 个请求 $2.83。

未完成或已放弃的会话的后备价格

如果会话被放弃,即未通过对“地点详情(新)”的调用而终止,“地点自动补全”请求将还原为采用基于请求的价格模式,并按 SKU:自动补全请求的定义,按每 1000 个请求 2.83 美元计费。