
本接口用于获取某一时刻,指定一个高度位置或多个层高,单点的气象要素预报查询。输入感兴趣点的经度、纬度、高度(单层或多层),获取当前时刻,任意经纬度任意高度气象要素预报数据。常用于垂直起降场的实时气象条件的查询。
| 参数名称 | 参数说明 | 数据类型 | 是否必须 | 说明 | 约束限制 |
| coordinates | 经纬度 | list | 是 | 经纬度列表: [22.50,113.76] | 1.需在服务范围内,否则报错提示:当前查询位置超出观测(预报)的区域范围(暂时仅支持合肥和深圳地区查询) |
| heights | 高度层 | list | 是 | 高度范围: [14,50] | 1.不填写返回全部预设高度层; 2.传一个数据值时进行单点单层查询; 3.最高不得超过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 08:12:00",
"coordinates": [
113.76,
22.50
],
"heights": [
11,
20,
830
],
"variables": []
}返回示例
JSON
{
"status": 0,
"version": "v1",
"date": {
"time": "20250812171933",
"timeZone": "Asia/Shanghai"
},
"result": {
"dataTime": "2025-08-13 08:20:00",
"dataType": "forecast",
"region": {
"type": "point",
"coordinates": {
"lat": [
22.5
],
"lon": [
113.76
]
},
"heights": [
10.0,
20.0,
30.0,
40.0,
50.0,
60.0,
70.0,
80.0,
90.0,
100.0,
110.0,
120.0,
140.0,
160.0,
180.0,
200.0,
220.0,
240.0,
260.0,
280.0,
300.0,
400.0,
500.0,
600.0,
700.0,
800.0,
900.0
],
"id": "WTX_440300"
},
"data": {
"heights_2d": {
"tp": [
0.0
]
},
"heights_10": {
"u": [
2.23
],
"rh": [
78.0
],
"v": [
1.36
],
"tmp": [
302.09
],
"c3p3": [
999999.0
]
},
"heights_20": {
"u": [
2.26
],
"rh": [
78.0
],
"v": [
1.38
],
"tmp": [
302.02
],
"c3p3": [
999999.0
]
},
"heights_30": {
"u": [
2.28
],
"rh": [
78.0
],
"v": [
1.39
],
"tmp": [
301.95
],
"c3p3": [
999999.0
]
},
"heights_40": {
"u": [
2.3
],
"rh": [
78.0
],
"v": [
1.4
],
"tmp": [
301.88
],
"c3p3": [
999999.0
]
},
"heights_50": {
"u": [
2.32
],
"rh": [
78.0
],
"v": [
1.41
],
"tmp": [
301.81
],
"c3p3": [
999999.0
]
},
"heights_60": {
"u": [
2.34
],
"rh": [
78.0
],
"v": [
1.43
],
"tmp": [
301.75
],
"c3p3": [
999999.0
]
},
"heights_70": {
"u": [
2.36
],
"rh": [
78.0
],
"v": [
1.44
],
"tmp": [
301.68
],
"c3p3": [
999999.0
]
},
"heights_80": {
"u": [
2.38
],
"rh": [
78.0
],
"v": [
1.45
],
"tmp": [
301.61
],
"c3p3": [
999999.0
]
},
"heights_90": {
"u": [
2.4
],
"rh": [
77.0
],
"v": [
1.46
],
"tmp": [
301.54
],
"c3p3": [
999999.0
]
},
"heights_100": {
"u": [
2.42
],
"rh": [
77.0
],
"v": [
1.48
],
"tmp": [
301.47
],
"c3p3": [
0.0
]
},
"heights_110": {
"u": [
2.44
],
"rh": [
77.0
],
"v": [
1.49
],
"tmp": [
301.4
],
"c3p3": [
0.0
]
},
"heights_120": {
"u": [
2.45
],
"rh": [
77.0
],
"v": [
1.5
],
"tmp": [
301.31
],
"c3p3": [
0.0
]
},
"heights_140": {
"u": [
2.48
],
"rh": [
78.0
],
"v": [
1.52
],
"tmp": [
301.12
],
"c3p3": [
0.0
]
},
"heights_160": {
"u": [
2.51
],
"rh": [
79.0
],
"v": [
1.54
],
"tmp": [
300.92
],
"c3p3": [
0.0
]
},
"heights_180": {
"u": [
2.54
],
"rh": [
79.0
],
"v": [
1.56
],
"tmp": [
300.73
],
"c3p3": [
0.0
]
},
"heights_200": {
"u": [
2.57
],
"rh": [
80.0
],
"v": [
1.58
],
"tmp": [
300.54
],
"c3p3": [
0.0
]
},
"heights_220": {
"u": [
2.6
],
"rh": [
80.0
],
"v": [
1.61
],
"tmp": [
300.35
],
"c3p3": [
0.0
]
},
"heights_240": {
"u": [
2.63
],
"rh": [
81.0
],
"v": [
1.63
],
"tmp": [
300.16
],
"c3p3": [
0.0
]
},
"heights_260": {
"u": [
2.66
],
"rh": [
81.0
],
"v": [
1.65
],
"tmp": [
299.96
],
"c3p3": [
0.0
]
},
"heights_280": {
"u": [
2.68
],
"rh": [
82.0
],
"v": [
1.67
],
"tmp": [
299.77
],
"c3p3": [
0.0
]
},
"heights_300": {
"u": [
2.71
],
"rh": [
82.0
],
"v": [
1.69
],
"tmp": [
299.58
],
"c3p3": [
0.0
]
},
"heights_400": {
"u": [
2.86
],
"rh": [
85.0
],
"v": [
1.8
],
"tmp": [
298.62
],
"c3p3": [
4.0
]
},
"heights_500": {
"u": [
3.0
],
"rh": [
88.0
],
"v": [
1.9
],
"tmp": [
297.66
],
"c3p3": [
9.0
]
},
"heights_600": {
"u": [
3.05
],
"rh": [
88.0
],
"v": [
1.91
],
"tmp": [
296.9
],
"c3p3": [
12.0
]
},
"heights_700": {
"u": [
3.04
],
"rh": [
87.0
],
"v": [
1.85
],
"tmp": [
296.26
],
"c3p3": [
14.0
]
},
"heights_800": {
"u": [
2.94
],
"rh": [
86.0
],
"v": [
1.75
],
"tmp": [
295.67
],
"c3p3": [
14.0
]
},
"heights_900": {
"u": [
2.71
],
"rh": [
85.0
],
"v": [
1.57
],
"tmp": [
295.15
],
"c3p3": [
12.0
]
}
}
}
}