新闻

与 OpenCage 的兼容替换已上线

OpenCage 在喜欢简单直接、文档完善、没有太多附加内容的地理编码 API 的开发者中积累了一批拥趸。我们也本着同样的精神构建了兼容主机:完全匹配请求和响应格式,让切换的任何环节都不会让人感觉是从头再来。

该主机精确复刻 OpenCage 的请求参数和响应正文,唯一的区别是版权、条款和隐私文本,这些是 My Geocode 自己的内容。当前构建 OpenCage 格式请求、解析 OpenCage 格式响应的代码,可以在这两部分完全不动的情况下指向我们的主机。

需要更改的是您配置中的主机名和用于身份验证的密钥。该密钥可以通过 X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证或查询参数发送,与您现有客户端库已经采用的方式保持一致。这四种方式在我们运行的每个主机上效果相同。

无论由哪个主机处理请求,定价都遵循我们的标准结构。任何地址无需密钥即可获得每天 2,500 次免费请求,按网络统计。密钥还会在此基础上额外提供每天 2,500 次免费请求。超出这两项配额后,预付额度为每次请求 €0.0001,或者用每月 €50 的 Unlimited 套餐覆盖用量;无论调用是经过这个兼容主机还是直接发往 /v1/forward,这些都不会改变。

每个响应都附带配额响应头,提供单纯的 OpenCage 集成本身不具备的一层用量可见性: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 请求头,即可在其上叠加可选字段,例如地面海拔;除非您主动要求,否则不会打乱基础结构。

该主机的文档位于 /compatibility/opencage/,关于兼容主机在整个平台上如何工作的更全面介绍位于 /docs/compatibility/。如果 OpenCage 已经接入您的技术栈,测试切换只需修改一处基础 URL 并使用一个新密钥。