本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
长期以来,Open-Elevation 一直是为一组坐标附加地面高度的一种简单朴素的方式。我们的兼容主机沿用同样的请求和响应结构,在其背后放上一个完全可用的海拔服务,并配以能准确告诉您已用多少的配额结构。
该主机完全复刻 Open-Elevation 的请求参数和响应正文,唯一的区别是版权、条款和隐私文本,这些内容属于我们而非原提供商。按照您现在向 Open-Elevation 发送坐标的方式发送一组坐标,海拔值就会以您现有代码如今解析的相同 JSON 结构返回。
由于我们的海拔端点完全可用,这不仅仅是结构上的匹配。查询某个位置的坐标,响应会返回一个以米为单位的真实海拔数值,与直接调用 /v1/elevation 的结果相同。批量请求的工作方式也一样,每对坐标计为一次请求,而不是把整个调用计为一次。
身份验证接受我们一贯的四种方式:X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证,或查询参数。由于 Open-Elevation 通常在完全不做身份验证的情况下使用,在这里加上一个密钥还意味着获得一份专属的、可跟踪的配额,而不是依赖一个共享的、无人管理的资源。
定价与平台上其他所有主机一致。任何地址无需密钥即可获得每天 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 全部包含在内,为海拔查询量提供可靠的可见性,而共享的公共实例通常不提供这一点。
如需标准海拔响应之外的内容,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在兼容结构之上添加可选的额外信息,完全由您选择。
该主机的文档位于 /compatibility/open-elevation/,底层海拔端点的完整说明位于 /docs/elevation-lookup/。如果海拔查询目前是某个地图或路线功能的一部分,这是在相同请求结构背后增加一份专属配额的直接方法。