Places API 用量和结算

关于字段掩码

对于“地点详情(新)”“附近搜索(新)”和“文本搜索(新)”,请使用 API 请求中的 FieldMask 标头来指定要在响应中返回的字段列表。然后,我们会按适用于您请求的最高 SKU 进行结算。这意味着,如果您同时选择了基本功能版和专业版 SKU 中的字段,我们会根据专业版 SKU 进行结算。

使用字段遮盖是一种良好的设计做法,可确保您不会请求不必要的数据,这有助于避免产生不必要的处理时间和结算费用。

关于“自动补全(新)”会话

“自动补全(新)”会话包含一个或多个“自动补全(新)”请求,以及一个“地点详情(新)”请求或地址验证请求。系统会将同一个会话令牌传递给“自动补全(新)”请求,以及随后的“地点详情(新)”请求或地址验证请求。

会话从第一个“自动补全(新)”请求开始。在用户选择其中一条“自动补全(新)”建议后,系统会发出“地点详情(新)”请求或地址验证请求。如果会话被放弃(即未发出“地点详情(新)”请求或地址验证请求),系统会按未提供会话令牌的情况为“自动补全(新)”请求计费。

在用户选择地点(即系统发出“地点详情(新)”请求或地址验证请求)后,您必须使用新的会话令牌启动新会话。

会话令牌非常适合单个会话,但不能用于多个会话。如果您重复使用某个会话令牌,相应会话会被视为无效,并且系统会按未提供会话令牌的情况为请求计费。

Places API 的 SKU 详情和价格

下表显示了 Places API 的 SKU 详情和价格。

类别Places API(新)SKU 详情SKU 价格
基本功能版 SKU:自动补全请求 主要价格表
印度价格表
基本功能版 SKU:自动补全会话用量 主要价格表
印度价格表
基本功能版 SKU:地点详情基本功能版(仅 ID) 主要价格表
印度价格表
基本功能版 SKU:地点详情基本功能版 主要价格表
印度价格表
基本功能版 SKU:文本搜索要素(仅 ID) 主要价格表
印度价格表
Pro SKU:附近搜索专业版 主要价格表
印度价格表
Pro SKU:地点详情专业版 主要价格表
印度价格表
Pro SKU:文本搜索专业版 主要价格表
印度价格表
企业版 SKU:附近搜索企业版 主要价格表
印度价格表
企业版 SKU:附近搜索企业版 + 氛围 主要价格表
印度价格表
企业版 SKU:地点详情企业版 主要价格表
印度价格表
企业版 SKU:地点详情企业版 + 氛围 主要价格表
印度价格表
企业版 SKU:文本搜索企业版 主要价格表
印度价格表
企业版 SKU:文本搜索企业版 + 氛围 主要价格表
印度价格表
企业版 SKU:地点详情照片 主要价格表
印度价格表
类别Places API(旧版)SKU 详情SKU 价格
基本功能版 SKU:自动补全 - 按请求结算 主要价格表
印度价格表
基本功能版 SKU:自动补全(包含地点详情)- 按会话结算 主要价格表
印度价格表
基本功能版

SKU:基本数据

附加费用:

主要价格表
印度价格表
基本功能版 SKU:查找地点 - 仅返回 ID 主要价格表
印度价格表
基本功能版 SKU:地点详情基本功能版 - ID 刷新 主要价格表
印度价格表
基本功能版 SKU:查询自动补全 - 按请求结算 主要价格表
印度价格表
Pro SKU:自动补全(不含地点详情)- 按会话结算 主要价格表
印度价格表
Pro

SKU:查找地点

附加费用:

主要价格表
印度价格表
Pro

SKU:地点 - 附近搜索

附加费用:

主要价格表
印度价格表
Pro

SKU:地点 - 文本搜索

附加费用:

主要价格表
印度价格表
Pro

SKU:地点详情

附加费用:

主要价格表
印度价格表
企业版

SKU:氛围数据

附加费用:

主要价格表
印度价格表
企业版

SKU:联系人数据

附加费用:

主要价格表
印度价格表
企业版 SKU:地点照片 主要价格表
印度价格表

用量限额

如需查看和管理配额及用量限额,请参阅配额和配额 提醒

  • Places API(新):每个 项目的每种 API 方法的每分钟速率限制。这意味着每种 API 方法都有单独的配额。

  • Places API(旧版):每分钟速率限制的计算方式为,使用同一项目凭据的所有应用的客户端请求和服务器端请求的总和。

调整配额

配额限制定义了在给定时间范围内允许特定 API 或服务的请求数上限。当项目中的请求数达到配额限制时,您的服务将停止响应请求。

如需修改 API 的配额值,请按以下步骤操作:

  1. 在 Cloud 控制台中,依次前往 Google Maps Platform > 配额
  2. 选择要修改配额的 API。
  3. 找到要更改的配额值,然后使用复选框将其选中。
  4. 点击修改 ,输入新的配额值,然后点击提交请求

查看配额增加请求

如需查看所有配额增加请求,包括过去的请求和待处理的请求,请执行以下操作:

  1. 在 Cloud 控制台中,依次前往 Google Maps Platform > 配额
  2. 选择要查看其配额增加请求的 API。
  3. 点击配额增加请求

使用条款限制

如需了解使用条款,请参阅 Places API 的政策以及 Google Maps Platform 服务条款的“许可限制”部分