关于字段掩码
对于“地点详情(新)”“附近搜索(新)”和“文本搜索(新)”,请使用 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:查找地点 - 仅返回 ID | 主要价格表 印度价格表 |
| 基本功能版 | SKU:地点详情基本功能版 - ID 刷新 | 主要价格表 印度价格表 |
| 基本功能版 | SKU:查询自动补全 - 按请求结算 | 主要价格表 印度价格表 |
| Pro | SKU:自动补全(不含地点详情)- 按会话结算 | 主要价格表 印度价格表 |
| Pro |
附加费用: |
主要价格表 印度价格表 |
| Pro |
附加费用: |
主要价格表 印度价格表 |
| Pro |
附加费用: |
主要价格表 印度价格表 |
| Pro |
附加费用: |
主要价格表 印度价格表 |
| 企业版 |
附加费用: |
主要价格表 印度价格表 |
| 企业版 |
附加费用: |
主要价格表 印度价格表 |
| 企业版 | SKU:地点照片 | 主要价格表 印度价格表 |
用量限额
如需查看和管理配额及用量限额,请参阅配额和配额 提醒。
Places API(新):每个 项目的每种 API 方法的每分钟速率限制。这意味着每种 API 方法都有单独的配额。
Places API(旧版):每分钟速率限制的计算方式为,使用同一项目凭据的所有应用的客户端请求和服务器端请求的总和。
调整配额
配额限制定义了在给定时间范围内允许特定 API 或服务的请求数上限。当项目中的请求数达到配额限制时,您的服务将停止响应请求。
如需修改 API 的配额值,请按以下步骤操作:
- 在 Cloud 控制台中,依次前往 Google Maps Platform > 配额 。
- 选择要修改配额的 API。
- 找到要更改的配额值,然后使用复选框将其选中。
- 点击修改 ,输入新的配额值,然后点击提交请求 。
查看配额增加请求
如需查看所有配额增加请求,包括过去的请求和待处理的请求,请执行以下操作:
- 在 Cloud 控制台中,依次前往 Google Maps Platform > 配额 。
- 选择要查看其配额增加请求的 API。
- 点击配额增加请求 。
使用条款限制
如需了解使用条款,请参阅 Places API 的政策以及 Google Maps Platform 服务条款的“许可限制”部分 。