本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
许多基于 Mapbox Geocoding 编写的代码存在于前端应用、移动应用和内部工具中,在这些地方,地理编码调用本身只是埋在更大系统里的一个很小、很容易被忽略的细节。在这种情况下更换提供商,通常意味着要先找出这个细节所在的每一个位置,然后才能做其他事情。我们的兼容主机旨在把这项工作缩减到几乎为零。
它完全复刻 Mapbox 的请求格式和响应结构,唯一的区别是版权、条款和隐私文本,这些是 My Geocode 自己的内容。您的代码目前在哪里发送按 Mapbox 格式构建的请求,就可以把同样的请求改为发送到我们的主机,返回的响应会按您现有代码原本期望的方式解析。
身份验证遵循我们一贯的模式,这部分同样不需要重写。通过 X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证或查询参数发送您的密钥,选择与您客户端当前身份验证方式相符的那一种即可。这四种方式在我们运行的每个主机和每个端点上都有效。
定价不会因为由哪个主机处理请求而变化。任何地址无需密钥即可获得每天 2,500 次免费请求,按网络而非按单个调用方统计。密钥还会额外提供自己的每天 2,500 次免费请求。超出这两项配额后,预付额度为每次请求 €0.0001,或者用每月 €50 的 Unlimited 套餐覆盖全部用量。兼容主机的费用与我们原生的 /v1/forward 和 /v1/reverse 端点完全相同。
无论采用何种格式,每个响应都附带配额响应头,提供单纯的 Mapbox 集成本身不具备的可见性:X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Credits-Remaining、X-Key-IPs-Used、X-Key-IPs-Limit 和 X-Quota-Reset 在这个主机上的出现方式与其他所有地方相同。
如需兼容响应结构之外的内容,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在其上添加可选的额外字段,而不改变基础结构。它默认关闭,因此在您明确要求更多内容之前,响应都与 Mapbox 的结构一致。
该主机位于 /compatibility/mapbox/,关于迁移集成的通用指南位于 /docs/compatibility/。如果您目前维护着一个 Mapbox 格式的集成,测试它只需要一个密钥和一处修改过的基础 URL。