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