自动补全和会话定价

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

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

按会话定价从包含会话令牌的第一个地点自动补全请求开始，并持续到每个后续地点自动补全请求，然后由使用会话令牌的地点详情请求终止。

会话终止后，如果使用过期的会话令牌调用地点自动补全、地点详情（新），则会像没有会话令牌一样计费。

对于未完成的会话（即未因地点详情请求而终止的会话），系统仅会使用 SKU：自动补全请求 对自动补全请求进行计费。

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

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

位置数据自动补全

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

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

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

此会话会因对地点详情发出单次请求而终止，该请求请求 SKU：地点详情（仅位置信息）定义的任何字段。

则计费方式如下：

  • 每次地点自动补全请求（最多 12 次请求），使用 SKU：自动补全请求。
    • 按每 1,000 个请求 2.83 美元收费，最多 10 万个请求
    • 每 1,000 个请求 2.27 美元，最多 50 万个请求
  • 在您处于活跃会话期间，如果地点自动补全请求数量达到 13 个或更多，系统会按 SKU：自动补全会话使用进行计费，这意味着这些请求不会产生费用。
  • 使用 SKU：地点详情（仅位置信息） 发出的一个地点详情请求：
    • 按每 1,000 个请求 5.00 美元收费，最多 10 万个请求
    • 每 1,000 个请求 4.00 美元，最多 50 万个请求

地点发现功能的自动补全

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

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

对于这种情况，您的会话会因“地点详情（新）”请求而终止，该请求会请求“地点详情”基本、高级或首选 SKU 中包含的任何字段。

则计费方式如下：

  • 所有地点自动补全请求均按 SKU：自动补全会话使用进行计费，这意味着您无需为这些请求付费。
  • 一个 SKU：地点详情（首选）请求：
    • 按每 1,000 个请求 25.00 美元收费，最多 10 万个请求
    • 每 1,000 个请求 20.00 美元，最多 500,000 个请求

价格示例

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

场景 请求示例 结算的 SKU 价格
位置数据
  • 5 次“地点自动补全”请求，费用为 0.00283 美元（每个会话的请求次数上限为 12 次）
  • 1 次地点详情请求，费用为 0.005 美元
地点发现
  • 5 次地点自动补全请求，费用为 0 美元
  • 1 次“地点详情”请求，费用为 0.025 美元
结账和配送
  • 5 次地点自动补全请求
  • 1 项地址验证请求
  • 5 次“地点自动补全”请求，费用为 0 美元
  • 1 次地址验证首选服务请求，费用为 0.025 美元

不含会话的价格示例

如果您不使用会话，系统会按“地点自动补全”请求向您收费，具体费用为 SKU：自动补全请求，费率为每 1, 000 次请求 2.83 美元。

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

如果会话被放弃（即未通过对“地点详情（新）”的调用终止），地点自动补全请求会恢复为按请求付费的定价模式，并按 SKU：自动补全请求中所定义的费率（每 1,000 次请求 2.83 美元）计费。