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