本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
十七个兼容主机,靠一篇篇公告来跟踪实在太多,所以我们把它们都放在了一个地方:位于 /compatibility/ 的兼容性矩阵,并排列出我们支持的每一个兼容替换主机,并附有指向各自文档的直接链接。
列表涵盖 Google Maps Platform、Bing Maps REST Services、HERE Geocoding and Search、Mapbox Geocoding、Geocode.Farm、OpenStreetMap Nominatim、OpenCage、LocationIQ、Geoapify、TomTom Search、MapQuest Geocoding、Geocodio、PositionStack、ip-api.com、ipinfo.io、ipstack 和 Open-Elevation。它们合起来涵盖地理编码、IP 地理定位和海拔查询,完全复现每家原服务商的请求和响应结构,只有版权、条款和隐私文本是我们自己的。
把它们放在一个页面上,不只是为了整齐。这意味着正在权衡要迁出哪家服务商的团队可以一次看到全貌,而不是通过一篇篇单独的公告逐个发现兼容主机。如果您的技术栈涉及其中不止一家服务商,比如用 Mapbox 做地理编码、用 ipinfo.io 做 IP 查询,或任何其他组合,矩阵会清楚地表明,它们都可以整合到一个 My Geocode 账户和一个密钥之下。
这种整合正是兼容方案总体上的真正优势。一个密钥即可在列表中的每个主机上完成身份验证,使用您的集成已经偏好的四种标准方式中的任意一种:X-API-Key 请求头、Authorization: Bearer 请求头、HTTP Basic 认证或查询参数。所有主机上的用量都计入同一份免费配额、同一笔预付额度余额或同一个 Unlimited 套餐,而且无论由哪个主机产生,每个响应都带有相同的配额响应头。一个账户、一个密钥、一张账单,覆盖您的集成过去依赖的所有独立服务商。
对于考虑进行更大范围迁移、而不只是替换一家服务商的团队,这个矩阵是自然的起点,通用迁移指南也在旁边,见 /docs/compatibility/。每个主机自己的文档页面介绍具体的请求参数,以及切换前值得了解的细节。
我们计划随着兼容范围的变化持续更新此页面,让它始终是了解可用内容的唯一参考,而不是在一篇篇公告之间逐渐过时。