星图云开放平台
开发指南
葵花9号卫星云图
更新时间:2025-04-03 14:25:59
接口说明

本接口为Himawari-9卫星云图产品,提供包含中国区的72~137°E,6~54°N的空间范围图像产品,内含三个光谱带:红外(LW)、水汽(WV)、可见光(VIS)。每小时生成一次,空间分辨率最高达500m可见光图片可以展示云层和地表信息等。红外图片可以展示夜间的云层和雾等。
水汽图可以展示对流层中水汽含量,较深的灰色表示空气较干燥,较亮的灰色或白色表示空气较湿润。
空间范围:72~137°E,6~54°N
空间分辨率:可见光通道500m,红外、水汽通道2km
时间范围:查询时间前24小时至当前时刻
更新频次:根据卫星图像实际生产时间,每小时更新一次
数据要素:水汽图像、可见光图像、红外图像
数据格式: webp、json
配色方案:标准配色以及支持定制化配色
使用方式:通过API获取图层文件,并与地图叠加,最终可实现拖拽、放大缩小等诸多功能。您既可以展示静态的单张图片,亦可连续播放形成动态展示。

调用方式

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

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

参数名

含义

规则数据

是否必填

缺省值

productCode产品类型,见产品类型代码表string/
meteCode要素类型,见要素代码表string/
start查询开始时间(yyyyMMddHH),start和end必填一个,当只传一个时间时,默认查询该时刻数据。string/
end查询结束时间(yyyyMMddHH),start和end必填一个,当只传一个时间时,默认查询该时刻数据。string/
hightrue为高分辨率,针对大屏或PC端显示效果优化;false或不填为普通分辨率,适合手机端产品Boolean/

 

 

productCode参数说明

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

 

meteCode要素类型代码表

wv水汽
vis可见光
lw红外
返回参数
参数名类型说明
statusint状态码,非0表示没有正常获取到数据
productCodeString产品类型编码
dataCodeString数据编码
meteCodeString要素编码
timeRangeString[]请求的数据时间范围,格式:”yyyyMMddHH”,”yyyyMMddHH”
urlsObject时间时间序列对应的文件,每个时次包括一个webp文件和一个json文件

 

json文件参数说明

min气象要素最小值(用于从红黑图换算气象要素值,mfv彩图产品无此要素)
max气象要素最大值(用于从红黑图换算气象要素值,mfv彩图产品无此要素)
width图片宽度(mfv彩图产品无此要素)
height图片高度(mfv彩图产品无此要素)
lonmin图片经度最小值
latmin图片纬度最小值
lonmax图片经度最大值
latmax图片纬度最大值

 

红黑图使用说明

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

调用示例

请求示例

https://api.open.geovisearth.com/v2/view/satellite/himawari9?token=您的token&start=2024112800&end=2024112900&meteCode=vis&high=true&productCode=mfv

返回示例

{
    "date": {
        "timeZone": "Asia/Shanghai",
        "time": "20241129110743"
    },
    "result": {
        "meteCode": "vis",
        "urls": {
            "2024112800": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2800/vis_202411280056388eeff10a563bfc.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2800/vis_202411280056388eeff10a563bfc.json"
            ],
            "2024112801": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2801/vis_20241128015835a16d92d047bc88.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2801/vis_20241128015835a16d92d047bc88.json"
            ],
            "2024112802": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2802/vis_20241128024edf70d3e0ac2477ab.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2802/vis_20241128024edf70d3e0ac2477ab.json"
            ],
            "2024112803": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2803/vis_202411280332f2a4e2b51f7b384a.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2803/vis_202411280332f2a4e2b51f7b384a.json"
            ],
            "2024112804": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2804/vis_2024112804d280caad6a4294be59.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2804/vis_2024112804d280caad6a4294be59.json"
            ],
            "2024112805": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2805/vis_2024112805772f86201565352cbe.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2805/vis_2024112805772f86201565352cbe.json"
            ],
            "2024112806": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2806/vis_20241128062a4ff2f2b656ac1aa6.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2806/vis_20241128062a4ff2f2b656ac1aa6.json"
            ],
            "2024112807": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2807/vis_2024112807c192e97b2d6abf07d1.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2807/vis_2024112807c192e97b2d6abf07d1.json"
            ],
            "2024112808": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2808/vis_2024112808da6d8f21672253085a.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2808/vis_2024112808da6d8f21672253085a.json"
            ],
            "2024112809": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2809/vis_20241128099d6c78b1cabcffee92.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2809/vis_20241128099d6c78b1cabcffee92.json"
            ],
            "2024112810": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2810/vis_2024112810b8f83ec0ce92faa332.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2810/vis_2024112810b8f83ec0ce92faa332.json"
            ],
            "2024112811": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2811/vis_202411281149fc91ea273cfa017f.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2811/vis_202411281149fc91ea273cfa017f.json"
            ],
            "2024112812": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2812/vis_20241128127d73fda0016756cce3.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2812/vis_20241128127d73fda0016756cce3.json"
            ],
            "2024112813": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2813/vis_2024112813dc9034811c32ba160b.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2813/vis_2024112813dc9034811c32ba160b.json"
            ],
            "2024112814": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2814/vis_2024112814db5356a382c3152b1b.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2814/vis_2024112814db5356a382c3152b1b.json"
            ],
            "2024112815": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2815/vis_202411281594f2e90eaa466a954a.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2815/vis_202411281594f2e90eaa466a954a.json"
            ],
            "2024112816": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2816/vis_2024112816998022be746829eef4.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2816/vis_2024112816998022be746829eef4.json"
            ],
            "2024112817": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2817/vis_2024112817c9b32c67aa6c912405.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2817/vis_2024112817c9b32c67aa6c912405.json"
            ],
            "2024112818": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2818/vis_2024112818b4bdeb7e6db68125db.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2818/vis_2024112818b4bdeb7e6db68125db.json"
            ],
            "2024112819": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2819/vis_20241128195b24a0bb63392e7244.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2819/vis_20241128195b24a0bb63392e7244.json"
            ],
            "2024112820": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2820/vis_2024112820ded9a1467022d4d014.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2820/vis_2024112820ded9a1467022d4d014.json"
            ],
            "2024112821": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2821/vis_2024112821bd25d0777438a59d68.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2821/vis_2024112821bd25d0777438a59d68.json"
            ],
            "2024112822": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2822/vis_2024112822c58795fd7534182c6c.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2822/vis_2024112822c58795fd7534182c6c.json"
            ],
            "2024112823": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2823/vis_20241128237989bf0e6cfb83be21.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2823/vis_20241128237989bf0e6cfb83be21.json"
            ],
            "2024112900": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2900/vis_20241129005728dc31f233754ccb.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/himawari9/202411/2900/vis_20241129005728dc31f233754ccb.json"
            ]
        },
        "productCode": "mfv",
        "dataCode": "himawari9",
        "timeRange": [
            "2024112800",
            "2024112900"
        ]
    },
    "version": "v1",
    "status": 0
}