新闻

兼容替换主机新增自动补全建议

地址自动补全是一种不同于直接地理编码查询的请求:它需要响应不完整、不断变化的输入,而不是一个已完成的地址,通常是在有人往表单里输入时。我们已扩展兼容替换主机以支持这种模式,并与提供该功能的服务商的自动补全请求结构保持一致。

这与我们原生的 /v1/autocomplete 端点并存,后者的文档位于 /docs/address-autocomplete/,可直接处理同类的部分地址请求。凡是兼容替换主机对应的原服务商也提供自动补全的,我们对应的主机现在都支持同样的请求结构,只有版权、条款和隐私文本是我们自己的。

自动补全请求的认证和计费规则与平台上其他所有请求类型完全相同。密钥可以通过 X-API-Key 请求头、Authorization: Bearer 请求头、HTTP Basic 认证或查询参数进行认证,用量计入同一份每日免费配额,无论该配额来自发起调用的网络还是密钥本身。超出免费配额后,自动补全请求按每次请求 €0.0001 从预付额度中扣除,或由 Unlimited 套餐覆盖,与其他任何端点完全一样。

自动补全流量的节奏往往与典型的地理编码查询不同,常常在有人往表单里输入地址时每次按键都触发,而不是每次完成提交才触发一次。因此配额的可见性在这里尤其有用:每个响应都附带同样的配额响应头,X-Quota-LimitX-Quota-UsedX-Quota-Free-Remaining 等,让集成能够实时监控消耗并调整行为,例如在用量高于预期时更积极地对请求做防抖处理。

对于已经使用兼容替换主机进行地理编码、同时通过另一家服务商或第二套集成单独处理自动补全的团队来说,这次更新意味着自动补全现在也可以迁移到同一个主机和同一个密钥上,将两种请求类型整合到一个账户下,而不是分散在两处。

哪些兼容替换主机支持自动补全,取决于其原服务商是否支持,每个主机的详细信息都记录在该主机自己的页面上,可以从 /compatibility/ 的完整列表进入。由于任何新密钥都附带免费配额,在兼容替换主机上测试自动补全不需要任何费用。