本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
发送一次包含一百个地址的 API 调用,这次调用会使用一百个请求,而不是一个。我们对批量请求中的每一项单独计数。这是一条简单的规则,但值得清楚地说明,因为它决定了应如何规划批处理任务并为其做预算。
只要想一想批量调用实际在做什么,其中的逻辑就很清楚了。一个对一百个地址进行地理编码的 HTTP 请求,在我们这边完成的是一百个单位的工作:一百次查询、一百个答案、响应中的一百行。如果把它当作一个请求来收费,就意味着为实际上一百条独立的信息只收取一分钱的零头。按项计数能让价格与实际完成的工作挂钩,而不是与您碰巧建立了多少次连接挂钩。
无论您是接近免费额度,还是在按量付费,规则都一样。如果您的网络在每日免费配额中还剩 400 个请求,而您发送了一批 1,000 个地址,其中 400 项由免费配额覆盖,剩余的 600 项则从预付额度或 Unlimited 套餐中扣除。响应中的配额响应头会准确反映这一点:X-Quota-Used 按项数而不是调用次数增加,X-Credits-Remaining 反映该批次在免费部分之外消耗的额度。
这也意味着,没有必要为了钻配额的空子而把工作拆成许多小调用,把工作合并成更少、更大的调用也不会受到惩罚。一百次单项调用和一次一百项的调用费用相同,计数也相同。选择您的代码更容易编写、您的基础设施更容易运行的形式即可。有些团队喜欢许多小调用,因为失败时重试更简单。另一些团队喜欢一次大调用,因为往返次数更少。两者的定价完全相同。
在规划时,这让容量计算变得很简单。如果一个每日任务需要处理 50,000 个地址,那就是 50,000 个请求,仅此而已,无论是作为一次调用、十次调用还是五百次调用发送。超出免费配额后每个请求 €0.0001,这笔账在纸上几秒钟就能算清楚。
每个端点和每个兼容替换主机在批量操作中都遵循同样的按项计数规则。没有单独的、更便宜的批量价格档,也没有单独的、更贵的档位。一次查询无论是单独到达,还是夹在一千个其他查询的列表中到达,费用都一样。
如果您正在基于 My Geocode 构建批处理任务,请按照您发送的地址、坐标或 IP 的数量来规划请求量,而不是按照承载它们的 HTTP 调用次数。这个数字会体现在您的配额中,也是任何账单所反映的数字。