Google 建议您使用包含自动补全(新)的会话。 会话有助于简化定价,并提供一致的定价模式,以便与自动补全(新)功能搭配使用。
会话定价从包含会话令牌的第一个“自动补全(新)”请求开始,一直持续到后续的每个“自动补全(新)”请求,然后因使用该会话令牌的“地点详情(新)”或“地址验证”请求而终止。
会话终止后,任何使用过期会话令牌对“自动补全(新)”“地点详情(新)”或“地址验证”的调用都将按没有会话令牌的情况计费。
不完整的会话(即未因“地点详情 [新]”或“地址验证”请求而终止的会话)仅针对自动补全请求按 SKU:自动补全请求计费。
以下是三种最常见的定价方案:
- 位置数据自动补全
- 地点发现自动补全
- 自动补全结账和送货信息
位置数据自动补全
在此场景中,您希望使用自动补全和地点详情(新)来获取有关某个地点的地理位置信息。例如,您从自动补全功能中选择一个建议,然后使用 Place Details (New) 获取该地点的纬度和经度坐标,以便在地图上显示该地点。
位置信息可能包括地点的以下信息:
- 地址
- 以纬度和经度坐标表示的位置
- Plus Code
- 类型
- 视口
当单个“地点详情(新)”请求请求由 SKU:地点详情基础定义的任何字段时,此会话即会终止。
会话从包含会话令牌的第一个“自动补全(新)”请求开始,一直持续到每个后续的“自动补全(新)”请求,然后因使用该会话令牌的“地点详情(新)”或“地址验证”请求而终止。对于自动补全(新)会话,结算方式如下:
- 前 12 个“自动补全(新)”请求:您需要为每个“自动补全(新)”请求支付费用,最多支付 12 个请求的费用,费用按“SKU:自动补全请求”计算。
- 对于同一会话中的第 13 个及后续“自动补全(新)”请求:您需要支付“SKU:自动补全会话使用量”费用,这意味着这些请求无需付费。
- “地点详情”或“地址验证”请求:您还需要按这些 SKU 为结束请求付费。
地点发现自动补全
在地点发现的自动补全场景中,您感兴趣的不仅仅是地点的地理位置数据。例如,您可以提出以下任一请求:
- 无障碍选项
- 当前营业时间
- 停车选项
- 评价
- 评分
在此场景中,您的会话因对“地点详情(新)”发出请求而终止,该请求请求了“地点详情(新)”任何字段,包括“地点详情(新)”Pro、企业版或企业版 + 氛围数据 SKU 中包含的字段。
则计费方式如下:
- 所有“自动补全(新)”请求均按 SKU:自动补全会话使用情况计费,这意味着这些请求无需付费。
自动补全结账和送货信息
Address Validation API 是一项接受地址的服务。它会识别地址组成部分并验证这些组成部分。它还会对地址进行标准化处理以方便邮寄,并找到地址的最优纬度和经度坐标。
在结账和送货场景的自动补全功能中,您可以通过向 Address Validation API 发出请求来终止会话,以验证所选地址。然后,您需要支付的费用如下:
- 所有“自动补全(新)”请求均按 SKU:自动补全会话使用情况计费,这意味着这些请求无需付费。
- 可选的 SKU:“地点详情精简版”请求。
- 一个 SKU:地址验证企业版请求。
价格示例
下表显示了三种主要会话场景的价格示例。此表还列出了每种情形下结算单中显示的 SKU。
场景 | 请求示例 | 结算的 SKU | 已结算的请求 |
---|---|---|---|
位置数据 |
|
|
|
地点发现 |
|
|
|
结账和配送 |
|
|
不含会话的价格示例
如果您不使用会话,则系统会根据您向“自动补全(新)”发出的请求次数,使用 SKU:自动补全请求进行结算。
针对不完整或已放弃的会话的后备价格
如果会话被放弃(即未通过调用“地点详情(新)”或“地址验证”来终止),“自动补全(新)”请求将恢复为按请求结算的定价模式,并按 SKU:自动补全请求计费。