星图云开放平台-以卫星遥感为核心的空天信息服务开放平台

飞行高度层基础气象要素预报查询

更新时间：2025-08-15 09:58:15

接口说明

本接口用于获取某一时刻，指定一个高度层上，航线、区域两种维度的气象要素预报查询。输入路线巡航点或区域边界点的多对经度、纬度，以及单层高度，获取当前时刻，同一高度层上的航线上所有点或区域覆盖面上所有点的气象要素预报数据。常用于空域气象图层的叠加或航线水平剖面的气象条件分析。

调用方式

使用 API 前，需要先注册账号并完成用户认证，查看开发指南

服务地址	https://api.open.geovisearth.com/pj/v1/lowaltitude/snapshot/forecast/mete/multipoint
请求方式	POST 方法
接口鉴权	服务密钥授权，您需要申请 token，将 token 作为必填参数拼接在服务地址中一起请求
调用限制	服务调用量的限制请点击这里查阅

请求参数

参数名称	参数说明	数据类型	是否必须	说明	约束限制
type	类型	string	是	line：线段上所有点的查询 plane：多边形平面上所有点的查询	无
coordinates	经纬度	list	是	经纬度列表： {“lon”:[113.76,113.71,113.72,113.73,113.74],“lat”:[22.50,22.51,22.53,22.54,22.55]}	1.需在服务范围内，否则报错提示：当前查询位置超出观测（预报）的区域范围（暂时仅支持合肥和深圳地区查询） 2.当查询方式为line时，最大经度差和纬差分别不超过3度（0.005600=3，约300公里）;且coordinates至少两个点；否则报错提示：当前查询范围过大，请缩小查询范围，最大经度差和纬差分别不超过3度； 3.当查询方式为plane时，最大经度差和纬差分别不超过0.3度（0.00560=0.3，约100平方公里）;且coordinates至少三个点；否则报错提示：当前查询范围过大，请缩小查询范围，最大经度差和纬差分别不超过0.3度；
height	高度层	int	是	10	1.最高不得超过1300，否则报错提示：前查询高度超出观测（预报）的高度范围
dataTime	预报时间	string	是	2025-06-17 18:00:00	1.未来24小时内，否则报错提示：前查询时间超出观测（预报）的时间范围; 2.YYYY-MM-DD hh:mm:ss
variables	要素名称	list	否	详见附录: 气象要素编码	1.不填写返回全部要素; 2.多个要素以英文逗号间隔

气象要素编码：

要素名称	中文名称	单位	实况	预报	备注
tmp	温度	K	√	√
u	U向风速	m/s	√	√
v	V向风速	m/s	√	√
rh	相对湿度	%	√	√
c3p3	不同层云量	%	√	√	只有1200, 1100, 1000, 900, 800, 700, 600, 500, 400, 300, 280, 260, 240,220, 200, 180, 160, 140, 120, 110, 100会有云量数据
tp	10分钟累积降水量	mm（2D）	√	√	现在2维未来实现3D维

返回参数

参数名称	参数说明	类型	异常值
status	状态码，非0表示没有正常获取到数据	int	无
dataTime	数据时间	string	无
coordinates	经纬度	list	无
heights	高度层	list	无
data	高度层要素数据	object	无

调用示例

请求示例

JSON
{
  "dataTime": "2025-08-13 12:00:00",
  "coordinateList": {
    "lat": [22.50,22.505,22.51],
    "lon": [113.76,113.77,113.78]
  },
  "height": "33",
  "variables":[],
  "type":"line"
}

返回示例

JSON
{
    "status": 0,
    "version": "v1",
    "date": {
        "time": "20250812172059",
        "timeZone": "Asia/Shanghai"
    },
    "result": {
        "dataTime": "2025-08-13 12:00:00",
        "dataType": "forecast",
        "region": {
            "type": "line",
            "coordinates": {
                "lat": [
                    22.5,
                    22.502,
                    22.504,
                    22.505,
                    22.507,
                    22.509,
                    22.51
                ],
                "lon": [
                    113.76,
                    113.764,
                    113.768,
                    113.77,
                    113.774,
                    113.778,
                    113.78
                ]
            },
            "heights": [
                33.0
            ],
            "id": "WTX_440300"
        },
        "data": {
            "heights_2d": {
                "tp": [
                    0.01,
                    0.01,
                    0.01,
                    0.01,
                    0.01,
                    0.01,
                    0.01
                ]
            },
            "heights_30": {
                "u": [
                    2.98,
                    2.98,
                    2.95,
                    2.95,
                    2.95,
                    2.91,
                    2.91
                ],
                "rh": [
                    65.0,
                    65.0,
                    66.0,
                    66.0,
                    66.0,
                    66.0,
                    66.0
                ],
                "v": [
                    0.99,
                    0.99,
                    0.9,
                    0.9,
                    0.9,
                    0.82,
                    0.82
                ],
                "tmp": [
                    304.32,
                    304.32,
                    304.19,
                    304.19,
                    304.19,
                    304.19,
                    304.19
                ],
                "c3p3": [
                    999999.0,
                    999999.0,
                    999999.0,
                    999999.0,
                    999999.0,
                    999999.0,
                    999999.0
                ]
            }
        }
    }
}