星图云开放平台
Rain-Pulse全国降水雷达图层
更新时间:2025-08-07 19:05:19
接口说明

Rain-Pulse 分钟降水临近预报产品基于雷达和地面观测资料等多源数据,综合深度学习质控算法、深度学习大模型雷达回波预测算法、深度学习雷达回波反演降水、机器学习雨雪相态预报算法、基于实况的自动化空报和漏报订正等技术,实现未来2小时精细到分钟级、街道级的降水临近预报产品。用户可直接选择雷达色斑图或中间体文件,根据需要进行灵活配色,通过图像产品清晰地感知降水过程(含雨雪)的发生演变,对于降水的追踪具有重要参考意义,可广泛应用于各行业。
空间范围:中国区(73~135.5°E,12.15~54.2°N)
更新频次:6分钟
预报时效:未来2小时,逐6分钟
返回数据时间:查询时间过去1小时、未来2小时
空间分辨率:1km
产品要素:回波强度、降水强度
数据格式:png、webp
配色方案:标准配色以及支持定制化配色
使用方式:通过API获取图层文件,并与地图叠加,最终可实现拖拽、放大缩小等诸多功能。您既可以展示静态的单张图片,亦可连续播放形成动态展示。
 

示例
调用方式

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

服务地址https://api.open.geovisearth.com/v2/rain/pulse/radar
请求方式GET 方法
接口鉴权服务密钥授权,您需要 申请 token将 token 作为必填参数拼接在服务地址中一起请求
调用限制服务调用量的限制请点击 这里 查阅
请求参数
参数名含义规则数据是否必填缺省值
productCode产品类型,见产品类型代码表string/
meteCode要素类型,见要素类型代码表string/

 

 

productCode产品类型代码表

代码说明使用说明
sev3857可视化产品(返回png红黑图及json文件)黑图配合json文件可求解出各像素点气象要素值,详见下方红黑图使用说明或 咨询技术支持
mfv墨卡托投影整图产品(返回webp彩图及json文件)彩图可直接叠加地图进行显示(配色方案下载

 

 

meteCode要素类型代码表

ste

回波强度,单位:dBZ

precipint

降水强度,单位:mm/h

 

 

返回参数
参数名含义规则数据
statusString状态码,非0表示没有正常获取到数据
productCodeString产品类型编码
meteCodeString要素编码
timeRangeString[]请求的数据时间范围,格式:“yyyyMMddHH”
urlsObject时间序列对应的文件,每个时次包括一个webp/png文件和一个json文件

 

 

json文件参数说明

min气象要素最小值
max气象要素最大值
width图片宽度
height图片高度
lonmin图片经度最小值
latmin图片纬度最小值
lonmax图片经度最大值
latmax图片纬度最大值

 

 

 

红黑图使用说明
本接口sev、sevg产品以红黑图形式提供,其优点是数据量小,传输速度快、存储量低。png图片中的R通道值与气象要素值存在线性映射关系,利用气象要素的最大值和最小值,将气象要素的真值映射到通道值的0~255,气象要素的最小值和最大值可从对应的json文件中读取。
要将红黑图像素点的通道值换算为气象要素值,公式如下:
气象要素值=min+R通道值/255*(max-min)

调用示例

请求示例

https://api.open.geovisearth.com/v2/rain/pulse/radar?productCode=sev&meteCode=ste&token=您的token

返回示例

{
    "date": {
        "timeZone": "Asia/Shanghai",
        "time": "20240911132722"
    },
    "result": {
        "meteCode": "ste",
        "urls": {
            "202409111518": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091115180c8a407712fd6a5671.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091115180c8a407712fd6a5671.json"
            ],
            "202409111418": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091114185f60806fe18bd02ac2.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091114185f60806fe18bd02ac2.json"
            ],
            "202409111318": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111318e0c2b44997b450b602.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111318e0c2b44997b450b602.json"
            ],
            "202409111230": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1112/ste_30202409111230f672fe006580b57a37.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1112/ste_30202409111230f672fe006580b57a37.json"
            ],
            "202409111236": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1112/ste_36202409111236c5153207b1442eeec7.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1112/ste_36202409111236c5153207b1442eeec7.json"
            ],
            "202409111412": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111412d48b337a4bdd91d266.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111412d48b337a4bdd91d266.json"
            ],
            "202409111312": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111312e7befcc1008f1bb772.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111312e7befcc1008f1bb772.json"
            ],
            "202409111436": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111436bf5edb11304b1f0262.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111436bf5edb11304b1f0262.json"
            ],
            "202409111336": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091113362e5c173aca890b3de4.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091113362e5c173aca890b3de4.json"
            ],
            "202409111512": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111512cfcd70441db6e49bda.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111512cfcd70441db6e49bda.json"
            ],
            "202409111254": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1112/ste_542024091112547ff7d5e9ee89949384.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1112/ste_542024091112547ff7d5e9ee89949384.json"
            ],
            "202409111430": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_0620240911143092e0787e876d071aa7.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_0620240911143092e0787e876d071aa7.json"
            ],
            "202409111330": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091113308d23d6b3ccf254e0ff.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091113308d23d6b3ccf254e0ff.json"
            ],
            "202409111454": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091114545b28989cdfc090b71d.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091114545b28989cdfc090b71d.json"
            ],
            "202409111354": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111354a5296d63227921d1a3.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111354a5296d63227921d1a3.json"
            ],
            "202409111306": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091113067bc6ef8dc363057966.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091113067bc6ef8dc363057966.json"
            ],
            "202409111448": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091114488139eb97999a0bbded.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091114488139eb97999a0bbded.json"
            ],
            "202409111506": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091115064b0d271544bfa3475a.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091115064b0d271544bfa3475a.json"
            ],
            "202409111406": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111406745c72d3757adff7f2.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111406745c72d3757adff7f2.json"
            ],
            "202409111324": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111324cac1d14a2b5fb884f9.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111324cac1d14a2b5fb884f9.json"
            ],
            "202409111500": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091115004eb782335e1e2687ea.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091115004eb782335e1e2687ea.json"
            ],
            "202409111400": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_0620240911140098455a957e941cdda3.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_0620240911140098455a957e941cdda3.json"
            ],
            "202409111348": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111348c503f82e89ed7c397a.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111348c503f82e89ed7c397a.json"
            ],
            "202409111524": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111524c8d01b69dbe1daa4fd.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_06202409111524c8d01b69dbe1daa4fd.json"
            ],
            "202409111248": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1112/ste_48202409111248c41c53196ed1d23ebf.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1112/ste_48202409111248c41c53196ed1d23ebf.json"
            ],
            "202409111424": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_0620240911142428f8384582be1bef47.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_0620240911142428f8384582be1bef47.json"
            ],
            "202409111342": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091113426927ba4c901f80eb2a.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091113426927ba4c901f80eb2a.json"
            ],
            "202409111242": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1112/ste_42202409111242108abf3bf07464fefa.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1112/ste_42202409111242108abf3bf07464fefa.json"
            ],
            "202409111300": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_0020240911130014d62677b328e9115a.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_0020240911130014d62677b328e9115a.json"
            ],
            "202409111442": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091114427b789fb8924c25ce01.png",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/sev/nowcast/202409/1113/ste_062024091114427b789fb8924c25ce01.json"
            ]
        },
        "productCode": "sev",
        "dataCode": "nowcast",
        "timeRange": [
            "202409111227",
            "202409111527"
        ]
    },
    "version": "v1",
    "status": 0
}