自动补全(新)和会话价格

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

Google 建议您将会话与自动补全(新)搭配使用。会话有助于简化定价,并提供一致的定价模式,以便与自动补全功能搭配使用(新)。

按会话定价的起始点是包含会话令牌的第一个“自动补全(新)”请求,并会持续到每个后续的“自动补全(新)”请求,然后在使用会话令牌的“地点详情(新)”或“地址验证”请求发出时结束。

会话终止后,如果使用已过期的会话令牌调用“自动补全(新)”“地点详情(新)”或“地址验证”API,系统会按没有会话令牌时的费率进行计费。

对于未完成的会话(即未因“地点详情(新)”或“地址验证”请求而终止的会话),系统仅会使用 SKU:自动补全请求 对自动补全请求进行计费。

最常见的三种定价场景如下:

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

位置数据自动补全

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

位置信息可能包括地点的以下信息:

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

此会话会因对“地点详情(新)”发出单次请求而终止,该请求请求 SKU:地点详情基本信息定义的任何字段。

会话从包含会话令牌的第一个“自动补全(新)”请求开始,并持续到每个后续的“自动补全(新)”请求,然后由使用会话令牌的“地点详情(新)”或“地址验证”请求终止。对于“自动补全(新)”会话,系统会按以下方式向您收费:

  • 前 12 次“自动补全(新)”请求:系统会使用 SKU:自动补全请求 按每次“自动补全(新)”请求向您收费,最多 12 次。
  • 对于同一会话中的 13 个及更高级别的“自动补全(新)”请求:系统会按 SKU:自动补全会话使用量计费,这意味着您无需为这些请求付费。
  • 地点详情或地址验证请求:系统还会针对使用这些 SKU 的结束请求向您收费。

地点发现功能的自动补全

在用于地点发现的自动补全场景中,您不仅希望获取地点的位置数据,例如,您可以请求以下任一内容:

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

对于这种情况,如果“地点详情(新版)”请求请求“地点详情(新版)”Pro企业版企业版 + 氛围数据 SKU 中包含的任何字段,您的会话就会终止。

则计费方式如下:

结账和送货信息自动补全

Address Validation API 是一项接受地址的服务。它会识别地址组成部分并对其进行验证。它还会对邮寄地址进行标准化处理,并为其查找最佳已知纬度和经度坐标。

在结账和配送场景的自动补全中,您可以通过向 Address Validation API 发出请求来终止会话,以验证所选地址。具体计费方式如下:

价格示例

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

场景 请求示例 结算的 SKU 结算的请求
位置数据
  • 5 次自动补全请求(新)(每个会话最多 12 次请求)
  • 1 次“地点详情(新)”请求
地点发现
  • 5 次自动补全(新)请求
  • 1 次“地点详情(新)”请求
结账和配送
  • 5 次自动补全(新)请求
  • 1 项地址验证请求
  • 5 次自动补全(新)请求
  • 1 个 Address Validation Enterprise 请求

不含会话的价格示例

如果您不使用会话,系统会按“自动补全(新)”请求使用 SKU:自动补全请求 向您收费。

针对未完成或已放弃的会话的回退价格

如果会话被放弃(即未通过对“地点详情(新)”或“地址验证”的调用终止),则“自动补全(新)”请求会恢复为按请求的定价模式,并按 SKU:自动补全请求进行计费。