新闻

与 HERE Geocoding and Search 的兼容替换已上线

HERE Geocoding and Search 支撑着相当多的物流、汽车和位置软件,而且往往只是众多组件之一,而非整个系统。当一家提供商嵌入得如此之深时,评估替代方案通常意味着要在工程成本与不确定的收益之间权衡。我们的 HERE 兼容主机正是为了把工程成本从这个等式中彻底去掉。

该主机完全复刻 HERE 的请求参数和响应正文,唯一的区别是版权、条款和隐私文本,这些内容属于我们而非原提供商。已经在构建 HERE 格式请求、读取 HERE 格式响应的客户端代码无需任何改动,只需要换一个主机名和一个 My Geocode 密钥。

该密钥在我们运行的每个主机上(包括这一个)都同样灵活:X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证,或查询参数。使用您现有客户端已经发送的那一种即可,因为这四种方式在每个端点和每个兼容主机上都被无一例外地识别。

在兼容的外表之下,定价是我们自己的,并且在平台上处处相同。任何地址无需密钥即可获得每天 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。这提供了原 API 本身不具备的用量透明度,同时不改变响应正文本身。

如果项目需要兼容结构返回内容之外的信息,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在其上叠加可选字段,例如地面海拔,这完全需要主动开启。不使用它,响应就与 HERE 的格式完全一致。

该兼容主机的文档位于 /compatibility/here/,关于在全部十七个主机之间如何切换的更全面介绍位于 /docs/compatibility/。通常一次测试调用就足以判断它是否合适。