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