Places API 用量和结算

关于字段掩码

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

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

“自动补全（新）”会话简介

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

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

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

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

Places API 的 SKU 详情和价格

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

其他用量限制

如需查看和管理配额和使用限制，请参阅配额和配额提醒。

• Places API（新版）：每分钟速率限制是指每个项目中每个 API 方法的速率限制。也就是说，每个 API 方法都有单独的配额。

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

使用条款限制

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