星图云开放平台
开发指南
火烧云特色预报-火烧云点查询预报
更新时间:2025-06-12 16:26:11
接口说明

火烧云特色预报,又名朝霞晚霞预报。

浩瀚的天空下,每一刻都在上演着自然界的绝美诗篇。从万里无云的碧空如洗,到夕阳余晖中的火烧云霞,每一幕都是大自然赋予我们的无价之宝。

为了让广大用户不错过任何一次与气象之美的邂逅,我们结合先进气象模式预报科技,实现蓝天与火烧云精准预报,让天际的绮丽画卷不再神秘,带您领略天空的无限魅力!

 

空间范围:15~55°N,72~136°E

时间分辨率:每日两次(日出和日落)

预报时效:未来3天

数据要素:火烧云质量、蓝天指数、火烧云等级、蓝天等级、火烧云分布图层

此接口支持根据15~55°N,72~136°E范围内任意经纬度,查询未来3天(含当天)日出、日落时刻的火烧云质量和等级、蓝天指数和等级。

 

调用方式

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

服务地址https://api.open.geovisearth.com/v2/grid/glow/day
请求方式GET 方法
接口鉴权服务密钥授权,您需要 申请 token将 token 作为必填参数拼接在服务地址中一起请求
调用限制服务调用量的限制请点击 这里 查阅
请求参数

参数名

含义

类型

是否必填

缺省值

location查询的经纬度信息,经度和纬度用英文逗号分隔double[]

/

start查询开始时间,格式为yyyyMMddHHString

/

end查询结束时间,格式为yyyyMMddHHString

/

meteCodes

查询的要素集合,要素代码以英文逗号分隔    

aod,glow

火烧云水晶天等级说明

String[]

/

level是否展示数据等级集合,默认为FALSE    TRUEboolean

/

返回参数
参数名类型说明
statusint状态码,非0表示没有正常获取到数据
timeString请求时间,格式:yyyyMMddHHmmss
startString查询开始时间
endString查询结束时间
sizeint返回的数据时次数
meteCodesString[]查询的要素集合
datasObject[]数据集合
fc_timeString预报时间,格式:yyyyMMdd
valuesdouble[]数据结果集合,顺序和meteCodes请求内容对应
levelsint[]数据等级集合,顺序和meteCodes对应
调用示例

请求示例

https://api.open.geovisearth.com/v2/grid/glow/day?location=116,40&start=2024122500&end=2024122800&meteCodes=aod,glow&level=true&token=用户的token

返回示例

{
    "status": 0,
    "version": "v1",
    "date": {
        "time": "20241230214716",
        "timeZone": "Asia/Shanghai"
    },
    "result": {
        "start": "2024-12-30 21:00:00",
        "end": "2025-01-02 00:00:00",
        "size": 4,
        "meteCodes": [
            "aod",
            "glow"
        ],
        "datas": [
            {
                "fc_time": "2024-12-31 08:00:00",
                "values": [
                    0.127,
                    0
                ],
                "levels": [
                    6,
                    0
                ]
            },
            {
                "fc_time": "2024-12-31 20:00:00",
                "values": [
                    0.241,
                    0
                ],
                "levels": [
                    5,
                    0
                ]
},            …………//其它时次预报信息
        ]
    }
}
使用说明

1、火烧云质量

该数据的计算会考虑以下几个方面因素:火烧云的持续时间、火烧云的亮度与颜色、火烧云的云量(包括相态与含水量)、火烧云占据本地天空的面积、云底高度、不同层次云层之间的照明与遮挡关系,以及气溶胶光学厚度/大气浑浊度。

等级代码

预报值

等级

说明

00~0.018无火烧云无云或云况不典型等,基本不具备火烧云形成的条件
10.019~0.075微微烧云况不典型或云量少等不太适宜观赏的情况
20.076~0.151小烧范围小或不太鲜艳,大气很通透的情况下才会比较好看
30.152~0.438小到中烧比较容易看到的火烧云,观赏性普通
40.439~0.711中到大烧比较值得看的火烧云,观赏性更高
5>0.712大烧火烧云范围广、云量大、颜色明亮、持续时间长,且大气通透

2、蓝天指数

表明了气溶胶颗粒在垂直方向对光线的遮挡和散射效果。当气溶胶光学厚度较大的时候,天空中的光线在到达地面前会被气溶胶明显散射和吸收,导致天空颜色的饱和度与亮度下降,使得天空看起来黯淡。

等级代码

预报值

等级

说明

1>0.8无蓝天灰暗的天空,地面附近可能有比较重的霾
20.6~0.8天空会比较黯淡,地面附近可能有霾
30.4~0.6天空看起来会有黯淡
40.3~0.4普通天空普通的天空
50.2~0.3普通蓝天(如果天气晴朗)不算水晶天但也有蓝天
60.1~0.2高级蓝天(如果天气晴朗)普通水晶天,天空湛蓝
70.0~0.1顶级蓝天(如果天气晴朗)高级水晶天,多见于青藏高原