新闻

与 Geoapify 的兼容替换已上线

Geoapify 把地理编码与一整套更广泛的位置工具结合在一起,这意味着基于它构建的集成有时会牵涉到代码库中比单个 API 调用看上去更多的部分。我们的兼容主机只专注于地理编码的请求和响应结构,并做到完全一致,这样这一部分就可以单独迁移,而不影响周围的一切。

该主机精确复刻 Geoapify 的请求参数和响应正文,唯一的区别是版权、条款和隐私文本,这些内容属于我们而非原提供商。当前为 Geoapify 地理编码端点构建的请求可以原样发送到我们的主机,返回的 JSON 也能按现有代码原本期望的方式解析。

这样缩小范围是有意为之。Geoapify 自己的平台除了地理编码之外,还涵盖路线规划、等时线和地点搜索;如果试图在一个兼容主机中匹配所有这些功能,它的发布节奏就会被远远超出地理编码本身的功能所牵制。把主机限定在地理编码端点上,可以让它便于对照原服务进行验证,也便于在 My Geocode 增加自身能力的同时保持同步。

切换只需更换主机名和密钥,别无其他。该密钥的身份验证方式与我们运营的所有主机一样灵活:X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证,或查询参数。无论您当前的客户端发送哪一种,这里都同样接受。

底层定价与平台其他部分相同。任何地址无需密钥即可获得每天 2,500 次免费请求,按网络统计。密钥还会在此基础上额外提供每天 2,500 次免费请求。超出这两项配额后,预付额度为每次请求 €0.0001,或者用每月 €50 的 Unlimited 套餐覆盖全部用量;无论调用发往这个主机还是直接发往 /v1/forward,费率都相同。

这里的每个响应同样附带配额响应头:X-Quota-LimitX-Quota-UsedX-Quota-Free-RemainingX-Quota-Network-UsedX-Credits-RemainingX-Key-IPs-UsedX-Key-IPs-LimitX-Quota-Reset 都会出现,提供了单纯的 Geoapify 集成本身不具备的可见性。

把地理编码集成迁移到新的提供商,也是全面加强账户安全的好时机。控制台中的双重身份验证设置就在 API 密钥和账单旁边,因此为一个刚持有新密钥的账户开启它,只需多一步操作,而不必另立一个项目。

如需标准兼容响应之外的内容,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在其上叠加可选字段;除非明确请求,否则基础结构不会改变。

该主机的完整文档位于 /compatibility/geoapify/,涵盖全部十七个主机的兼容性总参考位于 /docs/compatibility/。如果 Geoapify 已经支撑着您技术栈中的某一部分,这是一个把它与我们进行比较的省力方法。