本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
发往 My Geocode 的每个请求,无论访问哪个端点、采用哪个兼容主机的格式,都要经过同一套服务基础设施才能得到应答。我们最近完成了对这套共享基础设施的升级,结果是响应时间全面加快。
这是一项全平台范围的变化,而不是针对某一个端点。/v1/forward、/v1/reverse、/v1/ip、/v1/timezone、/v1/elevation、/v1/autocomplete 和 /v1/postcode 都运行在同一套升级后的技术栈上,全部十七个兼容主机也是如此。请求参数、响应字段、身份验证方式和定价都没有因此发生任何变化。这次升级完全在幕后进行,只体现在响应返回的速度上。
对于大多数集成来说,这种改进更多是感受到的,而不是精确测量出来的,总体感觉是调用返回得比以前快了一点。对于请求量可观的集成,尤其是按顺序处理大量条目的批处理任务,或者任何在用户输入时反复触发的自动补全类流量,这种效果会在大量请求中累积,变得更容易直接察觉。一个在每次按键时都发送请求的自动补全字段,在输入一个八个字符的搜索词的过程中会发出八次调用,每次哪怕只缩短一点点时间,也会改变整个交互的感受,而单独的一次查询根本体现不出这种差别。
我们把这类基础设施工作视为一项持续的责任,而不是一次性项目。一个供人们在其上构建真实产品的地理编码 API,需要在使用量增长时持续保持良好性能,而不只是在上线当天表现良好,这意味着要定期重新审视服务栈,而不是无限期地放任不管。这次升级是这一持续过程中的一步,而不是终点。
由于每个端点和每个兼容替换主机都运行在同一套共享服务栈上,这样的升级只需进行一次,所有端点和主机就都能受益,而不必逐个端点或逐个主机重复进行。也正是由于这种共享设计,这里的改动从不涉及请求格式、响应字段或配额引擎:它们位于完全不同的层级。
配额和计费机制不会因此发生任何变化。每个响应仍然带有同样完整的一组配额响应头:X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used、X-Credits-Remaining、X-Key-IPs-Used、X-Key-IPs-Limit 和 X-Quota-Reset,免费配额、预付额度费率以及 Unlimited 套餐价格也全部保持不变。
每个兼容替换主机同样运行在这套共享服务栈上,因此 TomTom 格式的调用和对 /v1/forward 的原生调用获得的提升完全相同,而且这项改进无需按主机单独申请,也无需为特定集成另行协商。
如果您的集成对响应时间敏感,无论是因为它直接面向用户,还是因为它要处理大量批量请求,您都应该能感受到差别,而无需在您这边做任何更改。每个端点的完整文档保持原样,可在 /docs/ 查看。