本接口为全球静止卫星的图片拼接产品,该产品集成了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) | 红外图,该图像展示云层、陆地和海洋的温度分布、表面温度异常等方面,不同于可见光图片,红外图针对夜间也同步进行了观测 |
![]() 可见光图像 | ![]() 水汽图像 | ![]() 红外图像 |
---|
参数 | 类型 | 说明 | 必选 | 缺省值 |
---|---|---|---|---|
productCode | string | 产品类型(详情见下) | 是 | / |
meteCode | string | 要素类型(详情见下) | 是 | / |
start | string | 查询开始时间 (yyyyMMddHH),start和end当只传一个时间时,默认查询该时刻数据。 | 是 | / |
end | string | 查询结束时间(yyyyMMddHH),start和end当只传一个时间时,默认查询该时刻数据。 | 是 | / |
productCode参数说明
productCode | 说明 | 使用说明 |
mfv | 墨卡托投影整图产品(返回webp彩图及json文件) | 彩图可直接叠加地图进行显示(配色方案下载) |
sevg | 4326可视化产品(返回png红黑图及json文件) | 红黑图配合json文件可求解出各像素点气象要素值,详见下方红黑图使用说明或 咨询技术支持 |
sev | 3857可视化产品(返回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
}