新闻

与 LocationIQ 的兼容替换已上线

LocationIQ 在许多从小规模起步、逐渐发展起来的技术栈中占有一席之地,这往往是因为它在早期很容易采用。我们的兼容主机正是针对这类集成:它今天运行良好,当初并不打算长期使用,却一直不值得重写。

该主机完全复刻 LocationIQ 的请求参数和响应正文,唯一的区别是版权、条款和隐私文本,这些是 My Geocode 自己的内容。按 LocationIQ 端点格式构建的请求可以不加修改地发送到我们的主机,返回的响应解析方式也与现有代码原本期望的相同。

这种精确并不是靠在每家提供商身上投入大量精力凑出来的。每个兼容主机都建立在与 My Geocode 其余部分相同的计费、配额和账户系统之上,因此构建一个新主机主要是一项映射工作,把字段名称和参数结构与某家提供商的客户端已经发送的内容对应起来,而不是另外搭建一个后端。这就是为什么定价、身份验证和配额统计在全部十七个主机上表现一致,而不会随着时间推移彼此偏离。

身份验证遵循平台上每个主机都采用的相同模式。通过 X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证或查询参数发送您的密钥,与您当前 LocationIQ 集成的做法保持一致。这四种方式在这里无一例外都被接受,因此切换时通常根本不需要改动您的 HTTP 客户端。

定价不会因为由哪个主机或端点处理调用而变化。任何地址无需密钥即可获得每天 2,500 次免费请求,按网络统计,因此这项配额合理地对应一个共享连接,而不是其背后的每一台设备。密钥还会额外提供自己的每天 2,500 次免费请求,与同一网络上的无密钥配额分开统计。超出之后,预付额度为每次请求 €0.0001,或者用每月 €50 的 Unlimited 套餐覆盖全部用量。

无论由哪个兼容主机处理,每个响应都带有我们完整的配额响应头集合:X-Quota-LimitX-Quota-UsedX-Quota-Free-RemainingX-Quota-Network-UsedX-Credits-Remaining 附加在这个主机的响应上,与附加在我们原生端点上的方式完全相同,因此任何围绕这些响应头构建的功能都能继续正常工作,无需改动。

如果项目需要兼容响应之外的内容,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在其上添加可选的额外字段,这完全需要主动开启。在地理编码调用中,这可以包括返回坐标的地面海拔,数据来源与直接响应 /v1/elevation 的来源相同。不使用它,响应格式就与 LocationIQ 的结构完全一致,现有解析逻辑不会遇到任何意外。

完成切换并发现它能经受真实流量考验的账户,往往最终会把它推荐给团队中仍在为原提供商付费的其他人。控制台中的推荐计划位于 /dashboard/referrals,正是为这种口碑传播而设计的。

该主机的文档位于 /compatibility/locationiq/,关于切换提供商的通用指南位于 /docs/compatibility/。通常用一个新密钥发送一次测试调用,就足以确认它能顺利融入现有集成。