海拔查询 API

陆地上任意一点相对于平均海平面的高度(以米为单位),数据来自覆盖陆地和海底的全球 15 角秒网格(约 460 米)。可发送一个点,也可在一次调用中发送最多 100 个点,用于剖面和路线。

GEThttps://api.mygeocode.com/v1/elevation?lat=...&lon=...

在演示中试用 完整参考

示例

请求
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/elevation?lat=27.9881&lon=86.9250"

# Several points, separated by |
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/elevation?locations=46.5763,7.6613|46.5484,7.9819|46.5588,8.0056"

数值取自全球 15 角秒网格中最近的单元格,因此您得到的是周边地形的高度,而不是单点高程:适合路线剖面、流域分析、无线电路径和合理性检查,但对于单栋建筑或狭窄山脊来说过于粗略。在平缓地带误差约为几米,在陡峭山区误差更大。在海洋上,数值为海底深度,以负数表示。

响应
{
  "status": "ok",
  "results": [
    {
      "lat": 27.9881,
      "lon": 86.925,
      "elevation_m": 8627.0,
      "resolution_m": 463.8
    }
  ]
}

返回内容

字段含义
results每个点一个条目,顺序与您发送时相同。
elevation_m相对于平均海平面的米数,保留一位小数。低于海平面时为负数(死亡谷、死海沿岸)。在开阔海域为 null
resolution_m数据集的网格间距(以米为单位):463.8(15 角秒)。

使用场景

路线剖面

以每批 100 个的方式发送徒步或骑行路线上的点,绘制海拔剖面、总爬升和最大坡度。

场地评估

洪水风险筛查、太阳能板规划、无线电视距分析。与正向地理编码结合使用,两次调用即可从地址得到高度。

校正 GPS 高度

消费级 GPS 的高度数据经常偏差数十米。对于位于地面上的任何物体,请用地形查询结果替代。

价格和限制

每个点计为一次请求,因此包含 100 个点的调用计为 100 次。每个密钥每天有 2,500 次免费请求;超出后,每次从预付额度中扣除 €0.0001,使用 Unlimited 密钥(每月 €50)则不收费。价格Google Elevation APIBing ElevationsOpen-Elevation 格式均以兼容替换主机的形式提供。