新闻

与 Geocode.Farm 的兼容替换已上线

长期以来,Geocode.Farm 一直在许多小型应用和内部工具中默默地提供地理编码,它们往往是在早期开发时接入的,此后就再没动过。我们的兼容主机正是为这类集成而设计的:它们一直运行良好,值得一条轻松的前进之路,而不是一次重写。

该主机完全复刻 Geocode.Farm 的请求参数和响应正文,唯一的区别是版权、条款和隐私文本,这些是 My Geocode 自己的内容。当前按 Geocode.Farm 端点格式构建的请求可以原样指向我们的主机,返回的响应结构与现有代码原本期望的相同。

切换只需更换主机名和密钥,周围的请求构建或响应解析逻辑都无需改动。该密钥可以通过 X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证或查询参数进行身份验证,与您当前集成已经发送的方式保持一致。

这类较老的集成往往是直接基于原始 HTTP 调用编写的,那时该提供商还没有 SDK,或者还不值得采用。My Geocode 发布了自己的 SDK,列在 /sdks/,供那些既然已经在改动这部分代码、不如顺便彻底告别原始 HTTP 调用的人使用,不过兼容主机本身并不要求这样做。

定价遵循与平台其他部分相同的规则。任何地址无需密钥即可获得每天 2,500 次免费请求,按网络统计。密钥还会在此基础上额外提供每天 2,500 次免费请求。超出之后,预付额度为每次请求 €0.0001,或者用每月 €50 的 Unlimited 套餐覆盖用量;无论由哪个主机处理调用,费率都相同。

每个响应都带有我们完整的配额响应头集合:X-Quota-LimitX-Quota-UsedX-Quota-Free-RemainingX-Quota-Network-UsedX-Credits-RemainingX-Key-IPs-UsedX-Key-IPs-LimitX-Quota-Reset,为那些规模较小、年代较久的集成提供了它们以前可能从未有过的用量可见性。

对于希望获得比兼容响应更多内容的项目,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在其上叠加可选的额外字段;这完全需要主动开启,默认关闭。

至此,我们已发布的兼容主机总数达到十七个,涵盖地理编码、IP 地理定位和海拔。达到这个数字,与其说是为了覆盖所有可能的提供商,不如说是为了覆盖真实集成实际在用的提供商,这也是为什么这份列表横跨这三个类别,而不是全部集中在其中一类。

该主机本身的文档位于 /compatibility/geocode-farm/,完整列表位于 /compatibility/。如果 Geocode.Farm 是您技术栈中某个较老集成的一部分,这是一个省力的方法,可以看看在相同的请求结构背后,现代的配额结构是什么样子。