星图云开放平台
开发指南
全球卫星可视化图层
更新时间:2025-06-10 15:04:11
接口说明

本接口为全球静止卫星的图片拼接产品,该产品集成了5颗静止卫星的数据,包括美国NOAA/NESDIS运营的GOES-East和GOES-West卫星、欧洲气象卫星组织运营的Meteosat-9和Meteosat-10以及日本气象厅(JMA)运营的Himawari-9。该图片产品提供从72N-72S的全球覆盖范围,内含三个光谱带:长波红外(LIR)、水汽(WV)、可见光(VIS)。每小时生成一次,空间分辨率为8km。可见光图片可以展示云层和地表特征。 红外图片可以展示夜间的云层和雾等。长波红外可以展示云层和陆地/海洋的温度情况等。水汽图可以展示对流层中水汽含量,较深的灰色表示空气较干燥,较亮的灰色或白色表示空气较湿润。
空间范围:全球
时间范围:查询时间前24小时至当前时刻
更新频次:根据卫星图像实际生产时间,每小时更新一次
数据要素:水汽图像、可见光图像、红外图像
数据格式:png、webp
配色方案:标准配色以及支持定制化配色
使用方式:通过API获取图层文件,并与地图叠加,最终可实现拖拽、放大缩小等诸多功能。您既可以展示静态的单张图片,亦可连续播放形成动态展示。

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

 

可见光图像

水汽图像

红外图像

调用方式

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

服务地址https://api.open.geovisearth.com/v2/global/satellite/visual
请求方式GET 方法
接口鉴权服务密钥授权,您需要 申请 token将 token 作为必填参数拼接在服务地址中一起请求
调用限制服务调用量的限制请点击 这里 查阅
请求参数
参数类型说明必选缺省值
productCodestring产品类型(详情见下)/
meteCodestring要素类型(详情见下)/
startstring查询开始时间 (yyyyMMddHH),start和end当只传一个时间时,默认查询该时刻数据。/
endstring查询结束时间(yyyyMMddHH),start和end当只传一个时间时,默认查询该时刻数据。/

 

 

productCode参数说明

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

 

meteCode要素类型代码表

wv水汽
vis可见光
lw红外
返回参数
参数名规则说明含义

status

int

状态码,非0表示没有正常获取到数据

dataCode

String

数据编码

productCode

String

产品类型编码

meteCode

String

要素编码

timeRange

String[]

请求的数据时间范围,格式yyyyMMddHHmm

urls

Object

时间时间序列对应的文件,每个时次包括一个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/global/satellite/visual?productCode=mfv&meteCode=wv&start=2024072600&end=2024072800&token=您的token

返回示例

{
    "date": {
        "timeZone": "Asia/Shanghai",
        "time": "20241022191236"
    },
    "result": {
        "meteCode": "wv",
        "urls": {
            "2024102200": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/gmgsi/202410/2200/wv_20241022008ce446aff284928401.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/gmgsi/202410/2200/wv_20241022008ce446aff284928401.json"
            ]
        },
        "productCode": "mfv",
        "dataCode": "gmgsi",
        "timeRange": [
            "2024102200",
            "2024102200"
        ]
    },
    "version": "v1",
    "status": 0
}