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