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

飞行高度层高影响天气实况查询

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

接口说明

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

调用方式

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

服务地址	https://api.open.geovisearth.com/pj/v1/lowaltitude/snapshot/live/highImpact/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，约900平方公里）;且coordinates至少三个点；否则报错提示：当前查询范围过大，请缩小查询范围，最大经度差和纬差分别不超过0.3度；
height	高度层	int	是	10	1.最高不得超过1300，否则报错提示：前查询高度超出观测（预报）的高度范围
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	高度层	int	无
data	高度层要素数据	object	无

调用示例

请求示例

JSON
{
  "dataTime": "2025-08-11 19:00:00",
  "coordinateList": {
    "lat": [22.50,22.505,22.51],
    "lon": [113.76,113.770,113.78]
  },
  "height": "66",
  "variables":[],
  "type": "line"
}

返回示例

JSON
{
    "status": 0,
    "version": "v1",
    "date": {
        "time": "20250812172334",
        "timeZone": "Asia/Shanghai"
    },
    "result": {
        "dataTime": "2025-08-12 17:10:00",
        "dataType": "live",
        "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": [
                66.0
            ],
            "id": "WTX_440300"
        },
        "data": {
            "heights_2d": {
                "cth": [
                    1200.0,
                    1200.0,
                    1200.0,
                    1200.0,
                    1200.0,
                    1200.0,
                    1200.0
                ],
                "cbh": [
                    120.0,
                    120.0,
                    120.0,
                    120.0,
                    120.0,
                    120.0,
                    120.0
                ]
            },
            "heights_70": {
                "vis": [
                    30496.88,
                    30496.88,
                    30483.63,
                    30483.63,
                    30483.63,
                    30481.48,
                    30481.48
                ],
                "vws": [
                    5.1,
                    5.1,
                    5.1,
                    5.1,
                    5.1,
                    4.12,
                    4.12
                ],
                "hws": [
                    2.0,
                    2.0,
                    4.0,
                    4.0,
                    4.0,
                    6.32,
                    6.32
                ],
                "ic": [
                    0.0,
                    0.0,
                    0.0,
                    0.0,
                    0.0,
                    0.0,
                    0.0
                ],
                "dutton": [
                    0.0,
                    0.0,
                    1.0,
                    1.0,
                    1.0,
                    1.0,
                    1.0
                ],
                "lcc_index": [
                    1.0,
                    1.0,
                    1.0,
                    1.0,
                    1.0,
                    1.0,
                    1.0
                ],
                "lcc": [
                    4.83,
                    4.83,
                    4.9,
                    4.9,
                    4.9,
                    4.86,
                    4.86
                ]
            }
        }
    }
}