新闻

用于地址列表的新批量端点

逐个处理地址列表,一个 HTTP 调用接一个 HTTP 调用,在数量少时没有问题,但一旦达到实际规模就很快变得繁琐。我们现在支持将整个地址列表作为一次批量调用发送,减少处理大型列表所需的往返次数,而且不改变任何计价方式。

这里的计数规则与平台上其他地方完全相同:批量调用中的每个地址都算作一次请求,而不是整个调用算一次。在一次批量调用中发送五百个地址,就会按五百次请求计入适用的配额,无论是每日免费配额、按每次请求 €0.0001 计费的预付额度,还是 Unlimited 套餐的覆盖范围。把工作合并到一次调用中,与拆成许多较小的调用发送相比,既没有折扣,也没有额外惩罚。

配额响应头也会准确反映批量调用。X-Quota-UsedX-Quota-Free-RemainingX-Credits-Remaining 都会按照该次调用中实际处理的地址数量变化,因此一次大型批量请求更新您可见配额的方式,与五百次单独调用完全相同,只是只需一次往返,而不是五百次。

这正是针对过去需要围绕单地址调用编写循环的那类工作负载:导入需要地理编码的客户名单、清理地址数据库,或准备一个按计划运行、而不是响应单个用户操作的大型批处理任务。将名单通过一次批量调用发送,可以减少管理大量独立 HTTP 连接的开销,对于运行在自身连接或速率限制(除我们的限制之外)较严格的基础设施上的任务尤其有用。

身份验证和总体行为保持不变:同样的四种密钥传递方式都可用,同样的配额规则适用,同样的免费配额足以在产生任何实际费用之前进行有意义的测试。与任何基于地址的查询一样,正向和逆地理编码结果仍属于我们目前正在开发、用于提供真实世界填充结果的后端,因此这项批量功能的文档专门围绕其请求结构和计数方式编写。

发送批量请求的完整文档,包括请求格式,见 /docs/forward-geocoding//docs/reverse-geocoding/。如果您的工作流程目前是循环调用单地址接口,那么对于一次需要处理多个地址的任何任务,都值得看一看。