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

风云4号卫星云图

更新时间：2025-08-07 19:05:19

接口说明

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

图像类别	图像说明
水汽图像（wv）	该图像捕捉了大气中的水汽含量，对于预测天气系统的演变和强度都具有重要意义，辅助预测降水模式和气旋的生成
可见光图像（vis）	该图像展示了直观的地表特征，包括云层、陆地和海洋，对于观察天气系统特征非常有用，比如：冷锋、云团
红外图像（lw）	红外图，该图像展示云层、陆地和海洋的温度分布、表面温度异常等方面，不同于可见光图片，红外图针对夜间也同步进行了观测

调用方式

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

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

请求参数

参数名	含义	规则数据	是否必填	缺省值
productCode	产品类型，见产品类型代码表	string	是	/
meteCode	要素类型，见要素代码表	string	是	/
start	查询开始时间（yyyyMMddHH），start和end必填一个，当只传一个时间时，默认查询该时刻数据。	string	是	/
end	查询结束时间（yyyyMMddHH），start和end必填一个，当只传一个时间时，默认查询该时刻数据。	string	是	/
high	true为高分辨率，针对大屏或PC端显示效果优化；false或不填为普通分辨率，适合手机端产品	Boolean	是	/

productCode参数说明

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

meteCode要素类型代码表

wv	水汽
vis	可见光
lw	红外

返回参数

参数名	类型	说明
status	int	状态码，非0表示没有正常获取到数据
productCode	String	产品类型编码
dataCode	String	数据编码
meteCode	String	要素编码
timeRange	String[]	请求的数据时间范围，格式：”yyyyMMddHH”,”yyyyMMddHH”
urls	Object	时间时间序列对应的文件，每个时次包括一个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/range?token=您的token&&start=2024112800&end=2024112900&meteCode=vis&high=true&productCode=mfv

返回示例

  {
    "status": 0,
    "version": "v1",
    "date": {
          "time": "20240913214553",
          "timeZone": "Asia/Shanghai"
          },
          "result": {
              "dataCode": "fy",
              "productCode": "mfv",
              "meteCode": "vis",
              "timeRange": [
                  "2024091000",
                  "2024091100"
              ],
              "urls": {
                  "2024091000": [
                      "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/fy_c/202409/1000/vis_202409100041733fe24d7544475e.webp",
                      "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/fy_c/202409/1000/vis_202409100041733fe24d7544475e.json"
                  ],
                  "2024091001": [
                      "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/fy_c/202409/1001/vis_2024091001c81eb679a2b3bfadc8.webp",
                      "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/fy_c/202409/1001/vis_2024091001c81eb679a2b3bfadc8.json"
                  ],
        …………//其它时次图层文件
      }
    }
}