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

垂直起降场基础气象要素实况查询

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

接口说明

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

调用方式

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

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

请求参数

参数名称	参数说明	数据类型	是否必须	说明	约束限制
coordinates	经纬度	list	是	经纬度列表： [113.76,22.50]	1.需在服务范围内，否则报错提示：当前查询位置超出观测（预报）的区域范围（暂时仅支持合肥和深圳地区查询）
heights	高度层	list	否	高度范围： [14,50]	1.不填写返回全部预设高度层； 2.传一个数据值时进行单点单层查询； 3.最高不得超过1300，否则报错提示：前查询高度超出观测（预报）的高度范围
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
{
  "coordinates": [113.76,22.50],
  "heights": [11,20],
  "variables":["tmp","u","v"]
}

返回示例

JSON
{
    "status": 0,
    "version": "v1",
    "date": {
        "time": "20250812133533",
        "timeZone": "Asia/Shanghai"
    },
    "result": {
        "dataTime": "2025-08-12 13:30:00",
        "dataType": "live",
        "region": {
            "type": "point",
            "coordinates": {
                "lat": [
                    22.5
                ],
                "lon": [
                    113.76
                ]
            },
            "heights": [
                10.0,
                20.0
            ],
            "id": "WTX_440300"
        },
        "data": {
            "heights_10": {
                "u": [
                    1.21
                ],
                "v": [
                    1.16
                ],
                "tmp": [
                    305.34
                ]
            },
            "heights_20": {
                "u": [
                    1.22
                ],
                "v": [
                    1.17
                ],
                "tmp": [
                    305.31
                ]
            }
        }
    }
}