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

垂直起降场高影响天气预报查询

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

接口说明

本接口用于获取某一时刻，指定一个高度位置或多个层高，单点的高影响天气预报查询。输入感兴趣点的经度、纬度、高度（单层或多层），获取当前时刻，任意经纬度任意高度高影响天气预报数据。常用于垂直起降场的实时气象条件的查询。

调用方式

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

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

请求参数

参数名称	参数说明	数据类型	是否必须	说明	约束限制
coordinates	经纬度	list	是	经纬度列表： [22.50,113.76]	1.需在服务范围内，否则报错提示：当前查询位置超出观测（预报）的区域范围（暂时仅支持合肥和深圳地区查询）
heights	高度层	list	是	高度范围： [14,50]	1.不填写返回全部预设高度层；
dataTime	预报时间	string	是	2025-06-17 18:00:00	1.未来24小时内，否则报错提示：前查询时间超出观测（预报）的时间范围; 2.YYYY-MM-DD hh:mm:ss
variables	要素名称	list	否	详见附录: 高影响天气编码	1.不填写返回全部要素; 2.多个要素以英文逗号间隔

高影响天气编码：

要素名称	中文名称	单位	实况	预报	备注
dutton	颠簸指数等级	[0,4]	√	√
ic	积冰指数等级	[0,3]	√	√
hws	水平风切边	m/s/500m	√	√
vws	垂直风切变	%	√	√
cbh	云底高	m（2D）	√	√	单层高度数据
cth	云顶高	m（2D）	√	√	单层高度数据
vis	能见度	m	√	√
lcc_index	有无低云	（0为无，1为有）	√	√	单层高度数据
lcc	低云云量	lcc：[0,10]每层	√	√

返回参数

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

调用示例

请求示例

JSON
{
  "dataTime": "2025-08-12 19:00:00",
  "coordinates": [113.76,22.50],
  "heights": [80,100],
  "variables":[]
}

返回示例

JSON
{
    "status": 0,
    "version": "v1",
    "date": {
        "time": "20250812172702",
        "timeZone": "Asia/Shanghai"
    },
    "result": {
        "dataTime": "2025-08-12 19:00:00",
        "dataType": "forecast",
        "region": {
            "type": "point",
            "coordinates": {
                "lat": [
                    22.5
                ],
                "lon": [
                    113.76
                ]
            },
            "heights": [
                80.0,
                90.0,
                100.0
            ],
            "id": "WTX_440300"
        },
        "data": {
            "heights_2d": {
                "cth": [
                    1200.0
                ],
                "cbh": [
                    400.0
                ]
            },
            "heights_80": {
                "vis": [
                    24722.4
                ],
                "vws": [
                    6.32
                ],
                "hws": [
                    8.0
                ],
                "ic": [
                    0.0
                ],
                "dutton": [
                    3.0
                ],
                "lcc_index": [
                    1.0
                ],
                "lcc": [
                    6.16
                ]
            },
            "heights_90": {
                "vis": [
                    26465.03
                ],
                "vws": [
                    5.1
                ],
                "hws": [
                    6.0
                ],
                "ic": [
                    0.0
                ],
                "dutton": [
                    1.0
                ],
                "lcc_index": [
                    1.0
                ],
                "lcc": [
                    6.16
                ]
            },
            "heights_100": {
                "vis": [
                    26463.14
                ],
                "vws": [
                    6.32
                ],
                "hws": [
                    6.0
                ],
                "ic": [
                    0.0
                ],
                "dutton": [
                    2.0
                ],
                "lcc_index": [
                    1.0
                ],
                "lcc": [
                    6.16
                ]
            }
        }
    }
}