Google 建议您使用会话和地点自动补全功能。会话有助于简化定价,并提供与地点自动补全功能搭配使用的一致定价模式。
会话定价从第一个包含会话令牌的“地点自动补全”请求开始,接着执行每个后续的“地点自动补全”请求,然后向使用该会话令牌的地点详情请求终止。
会话终止后,如果对“地点自动补全”和“地点详情(新)”的任何使用已过期的会话令牌调用,系统会按照没有会话令牌的情况进行结算。
未完成的会话(即并非因发出的“地点详情”请求而终止的会话)只需为使用 SKU:自动补全请求的“自动补全”请求付费。
以下是三种最常见的价格方案:
- 自动补全位置数据
- 自动补全地点发现
- 自动补全结账和送货信息
自动补全位置数据
在此场景中,您希望使用自动补全和地点详情(新)来获取地点的相关位置信息。例如,从自动补全功能中选择一条建议,然后使用地点详情来获取地点的经纬度坐标,以在地图上显示该地点。
位置信息可能包括地点:
- 地址
- 位置(以经纬度坐标表示)
- Plus Code
- 类型
- 视口
此会话由一个对“地点详情”的请求终止,该请求请求了 SKU:地点详情(仅限位置)定义的任何字段。
然后,您需要按以下方式支付费用:
- 每个“地点自动补全”请求,最多 12 个请求,使用 SKU:自动补全请求。
- 费用为每 1,000 次请求和 10 万次请求 $2.83
- 按每 1,000 个请求(最多 50 万个请求)$2.27 计费
- 当您处于活跃会话期间,“地点自动补全”请求 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 计费
价格示例
下表显示了三种主要会话场景的价格示例。此表还列出了您的对账单中显示的每种场景的 SKU。
场景 | 请求示例 | 结算的 SKU | 每 1000 个请求的价格 |
---|---|---|---|
位置数据 |
|
|
|
地点发现 |
|
|
|
结账和送餐 |
|
|
不含会话的价格示例
如果您不使用会话,则使用 SKU:自动补全请求,您需要按请求为地点自动补全服务付费,价格为每 1000 个请求 $2.83。
未完成或已放弃的会话的后备价格
如果会话被放弃,即未通过对“地点详情(新)”的调用而终止,“地点自动补全”请求将还原为采用基于请求的价格模式,并按 SKU:自动补全请求的定义,按每 1000 个请求 2.83 美元计费。