Google 建议您将会话与 自动补全(新)搭配使用。 会话有助于简化定价,并为自动补全(新)提供一致的定价模式。
会话以第一个包含会话令牌的自动补全(新)请求开始, 持续到每个后续的自动补全(新)请求,然后由使用会话令牌的地点详情(新)或地址验证请求终止。
会话终止后,任何使用已过期会话令牌的自动补全(新)、地点详情(新)或地址 验证调用都将按没有会话令牌的情况计费。
不完整的会话(即未由地点详情(新)或地址验证请求终止的会话)仅针对使用 SKU: 自动补全请求的自动补全(新)请求计费。
会话结算
会话在地点详情(新)Essentials 请求中终止
对于在请求中使用 SKU:Places API 地点详情 Essentials中的字段终止的自动补全(新)会话:
- 前 12 个自动补全(新)请求:您需要为每个自动补全(新)请求支付 SKU:自动补全请求费用,最多 12 个请求。
- 对于同一会话中的第 13 个及后续自动补全(新)请求:您需要支付 SKU:自动补全会话使用情况费用,这意味着这些请求不收费。
- 地点详情(新)Essentials:您还需要为终止请求支付 SKU:Places API 地点详情 Essentials 费用。
会话在地址验证或地点详情(新)(非 Essentials)请求中终止
对于在地址验证请求或使用地点详情 Pro、 Enterprise、 或 Enterprise + Atmosphere中的字段的地点详情(新)请求中终止的自动补全(新)会话:
- 自动补全(新)请求:所有自动补全(新)请求都将按 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:自动补全请求计费。