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