Google 建议您将会话与自动补全(新)搭配使用。会话有助于简化定价,并提供一致的定价模式,以便与自动补全(新)搭配使用。
按会话定价的计费时间从包含会话令牌的第一个“自动补全(新)”请求开始,并持续到每个后续的“自动补全(新)”请求,然后在使用会话令牌的“地点详情(新)”或“地址验证”请求发出时结束。
会话终止后,如果使用已过期的会话令牌对“自动补全(新)”“地点详情(新)”或“地址验证”进行调用,系统会按没有会话令牌的情况进行计费。
对于未完成的会话(即未因“地点详情(新)”或“地址验证”请求而终止的会话),系统仅会使用 SKU:自动补全请求对自动补全请求进行计费。
最常见的三种定价场景如下:
- 位置数据自动补全
- 地点发现功能的自动补全
- 结账和配送信息自动填充
位置数据自动补全
在此场景中,您有意使用“地点自动补全”和“地点详情(新)”来获取地点的位置信息。例如,您从自动补全功能中选择一条建议,然后使用“地点详情(新)”获取相应地点的纬度和经度坐标,以便在地图上显示该地点。
位置信息可能包括地点的以下信息:
- 地址
- 位置(纬度和经度坐标)
- Plus Code
- 类型
- 视口
此会话会因对“地点详情(新)”发出单次请求而终止,该请求请求 SKU:地点详情(仅限位置信息)定义的任何字段。
则计费方式如下:
- 每个“自动补全(新)”请求(最多 12 个请求),使用 SKU:自动补全请求。
- 按每 1,000 个请求 2.83 美元收费,最多 10 万个请求
- 每 1,000 个请求 2.27 美元,最多 50 万个请求
- 在您处于有效会话期间,系统会按 SKU:自动补全会话用量对 13 个及以上的“自动补全(新)”请求进行计费,这意味着系统不会对这些请求收费。
- 使用 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 个请求
结账和配送信息自动填充
Address Validation API 是一项接受地址的服务。它会识别地址组成部分并对其进行验证。它还会对邮寄地址进行标准化处理,并为其查找最知名的纬度和经度坐标。
在结账和配送场景的自动补全中,您可以通过向 Address Validation API 发出请求来终止会话,以验证所选地址。则计费方式如下:
- 所有“自动补全(新)”请求均按 SKU:自动补全会话使用进行计费,这意味着您无需为这些请求付费。
- 一个 SKU:地址验证(首选)请求:
- 按每 1,000 个请求 25.00 美元收费,最多 10 万个请求
- 每 1,000 个请求 20.00 美元,最多 500,000 个请求
价格示例
下表显示了三种主要会话场景的价格示例。此表还列出了每种情况下结算对账单中显示的 SKU。
场景 | 请求示例 | 结算的 SKU | 每 1,000 个请求的价格 |
---|---|---|---|
位置数据 |
|
|
|
地点发现 |
|
|
|
结账和配送 |
|
|
不含会话的价格示例
如果您不使用会话,系统会按“自动补全(新)”请求向您收费,具体费用为 SKU:自动补全请求,费率为每 1, 000 次请求 2.83 美元。
针对未完成或放弃的会话的回退价格
如果会话被放弃(即未因调用“地点详情(新)”或“地址验证”而终止),则“自动补全(新)”请求会恢复为按请求付费的定价模式,并按 SKU:自动补全请求中所定义的费率(每 1,000 个请求 2.83 美元)进行计费。