Google 建议您使用支持自动补全(新)的会话。会话有助于简化定价,并提供与自动补全(新)搭配使用的一致定价模式。
会话定价从第一个包含会话令牌的“自动补全(新)”请求开始,接着执行每个后续的“自动补全(新)”请求,然后向使用会话令牌的“地点详情(新)”或“地址验证”请求终止。
会话终止后,如果对“自动补全(新)”“地点详情(新)”或“地址验证”调用使用过期的会话令牌,系统会按照没有会话令牌的情况进行结算。
未完成的会话是指未通过“地点详情(新)”或“地址验证”请求而终止的会话,只需为使用 SKU:自动补全请求的“自动补全”请求付费。
以下是三种最常见的价格方案:
- 自动补全位置数据
- 自动补全地点发现
- 自动补全结账和送货信息
自动补全位置数据
在此场景中,您希望使用自动补全和地点详情(新)来获取地点的相关位置信息。例如,您可以从自动补全功能中选择建议,然后使用“地点详情(新)”来获取地点的纬度和经度坐标,从而在地图上显示该地点。
位置信息可能包括地点:
- 地址
- 位置(以经纬度坐标表示)
- Plus Code
- 类型
- 视口
该会话由对“地点详情(新)”的单个请求终止,该请求请求了 SKU:地点详情(仅限位置)定义的任何字段。
然后,您需要按以下方式支付费用:
- 每个“自动补全(新)”请求,最多 12 个请求,使用 SKU:自动补全请求。
- 费用为每 1,000 次请求和 10 万次请求 $2.83
- 按每 1,000 个请求 $2.27 计费(至 50 万个请求)
- 当您处于活跃会话时,“自动补全(新)”请求 13 及更高版本将按 SKU:自动补全会话用量计费,这意味着这些请求是免费的。
- 使用 SKU:地点详情(仅限位置)的一个“地点详情”请求:
- 按每 1,000 个请求(不超过 10 万个请求)$5.00 计费
- 按每 1,000 个请求(不超过 50 万个请求)$4.00 计费
自动补全地点发现
在地点发现场景中,您希望获取的不仅仅是某个地点的位置数据。例如,您可以请求执行以下任一操作:
- 无障碍选项
- 当前营业时间
- 停车选项
- 评价
- 评分
在这种情况下,您的会话将通过向“地点详情(新)”发出的请求而终止,该请求会请求“地点详情(新)”基本、高级或首选 SKU 中包含的任何字段。
然后,您需要按以下方式支付费用:
- 所有“自动补全(新)”请求均按 SKU:自动补全会话使用情况计费,这意味着这些请求是免费的。
- 一个 SKU:地点详情(首选)请求:
- 费用为每 1000 个请求 $25.00,最多 10 万个请求
- 按每 1,000 个请求(不超过 50 万个请求)$20.00 计费
自动补全结账和送货信息
Address Validation API 是一项接受地址的服务。它可识别地址组成部分并对其进行验证。它还会对邮寄地址进行标准化,并为该地址查找最已知的经纬度坐标。
在“自动补全结账和配送”场景中,您需要终止会话,并向 Address Validation API 发出请求,以验证所选地址。然后,您需要按以下方式支付费用:
- 所有“自动补全(新)”请求均按 SKU:自动补全会话使用情况计费,这意味着这些请求是免费的。
- 一个 SKU:首选地址验证请求:
- 费用为每 1000 个请求 $25.00,最多 10 万个请求
- 按每 1,000 个请求(不超过 50 万个请求)$20.00 计费
价格示例
下表显示了三种主要会话场景的价格示例。此表还针对每种场景列出了您的对账单中显示的 SKU。
场景 | 请求示例 | 结算的 SKU | 每 1000 个请求的价格 |
---|---|---|---|
位置数据 |
|
|
|
地点发现 |
|
|
|
结账和送餐 |
|
|
不含会话的价格示例
如果您不使用会话,则需使用 SKU:自动补全请求,按请求向“自动补全(新)”付费,价格为每 1, 000 个请求 $2.83。
未完成或已放弃的会话的后备价格
如果会话被放弃,即未通过调用“地点详情(新)”或“地址验证”来终止,“自动补全(新)”请求将还原为采用基于请求的价格模式,并按 SKU:自动补全请求的定义,按每 1,000 个请求 2.83 美元计费。