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 个请求)计费
价格示例
下表显示了三种主要会话场景的价格示例。此表格还列出了针对每种场景显示在对账单中的 SKU。
场景 | 请求示例 | 结算的 SKU | 每 1000 个请求的价格 |
---|---|---|---|
位置数据 |
|
|
|
地点发现 |
|
|
|
结账和送货 |
|
|
不含会话的价格示例
如果您不使用会话,则需要使用 SKU:自动补全请求按每 1000 次请求 $2.83 对地点自动补全请求进行结算。
未完成或已放弃的会话的后备价格
如果某个会话被放弃,即没有因调用“地点详情”(新功能)而终止,“地点自动补全”请求将还原为按请求结算的定价模式,按 SKU:自动补全请求定义的每 1000 次请求收取 2.83 美元的费用。