本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
MapQuest Geocoding 一直是许多长期运行的应用的一部分,其中一些应用的位置查询代码多年来都没动过,因为它一直正常工作。我们的兼容主机正是为这种情况而构建的:代码运行良好,没人想重写,但团队仍然希望在不重建的前提下告别一个日渐老旧的集成。
该主机完全复刻 MapQuest 的请求参数和响应正文,唯一的区别是版权、条款和隐私文本,这些内容属于我们而非原提供商。当前按 MapQuest 地理编码端点格式构建的请求可以原样发送到我们的主机,返回的响应解析方式也与现有代码原本期望的相同。
唯一需要更改的是主机名和密钥。该密钥使用我们四种标准方式中与您当前集成相符的那一种进行身份验证:X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证,或查询参数。
获取该密钥并不需要先完成账户验证。新注册账户的密钥在一段宽限期内即可正常使用,之后 My Geocode 才会要求确认注册邮箱;到那时,未验证的密钥会被暂停,而不是直接失败。这对于此类迁移测试尤为重要:有人想在周五下午把一个老旧集成指向新主机,而不必等待邮件往返。
定价遵循与 My Geocode 其他地方相同的结构。任何地址无需密钥即可获得每天 2,500 次免费请求,按网络统计。密钥还会单独额外提供每天 2,500 次免费请求。超出这些配额后,预付额度为每次请求 €0.0001,或者用每月 €50 的 Unlimited 套餐覆盖用量;这个主机与其他任何主机之间的费率没有差别。
每个响应都带有与平台其余部分相同的配额响应头:X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used、X-Credits-Remaining、X-Key-IPs-Used、X-Key-IPs-Limit 和 X-Quota-Reset。其中 X-Key-IPs-Used 和 X-Key-IPs-Limit 这两个跟踪的是密钥特有的信息,而非网络:每个密钥只允许从少量滚动更新的 IP 地址调用,这样既能防止一个密钥被一群互不相关的服务器共享,又能容忍正常部署导致应用出站地址发生变化。
对于希望获得比兼容响应更多内容的项目,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在标准结构之上添加可选字段,这完全需要主动开启。
该主机的文档位于 /compatibility/mapquest/,关于整个平台兼容性的更全面介绍位于 /docs/compatibility/。如果 MapQuest Geocoding 仍然安静地待在您的技术栈中,这是一个低成本的方法,可以看看在同样熟悉的结构之下,现代的配额结构是什么样子。