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

全球公里级网格预报图层

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

接口说明

本接口提供全球气象可视化图层，可以轻松的与第三方地图库集成，如中科星图地图、高德地图、腾讯地图、百度地图等。
我们有来自全球最受欢迎的气象模型（比如EC和GFS等数值天气预报）提供的陆地、海洋和大气预报，并以API的形式对外服务。
基于上述公里级高精度的气象数据，利用专业的可视化和图形渲染技术生成了鲜艳、直观的图层产品，包含已配色图层和中间体图层，后者支持您进行自定义前端配色。华丽的气象图层动画使您可以快速轻松地理解天气的演变。这些图层可以通过播放进行无缝隙流动，使您可以观察随时间推移的短期和长期趋势。清晰的天气数据可视化有助于更好地了解正在发生的事情和预期情况。目前支持的气象图层数量超过30个，是已知的最全模式预报图层库。可以帮助您轻松创建具有高度专业性的图层产品模块，在行业中脱颖而出，更好的通过图像讲述“天气故事”。
空间范围：全球
空间分辨率：25km
时间范围：查询时间过去24小时至未来10天
更新频次：2次/天（北京时间08时、20时）
预报时效：未来0~5天逐1小时，未来5~10天逐3小时
数据要素：2米温度、相对湿度、阵风风速、总云量、3小时累积降水量、土壤温度、土壤含水率、海面温度、海浪、涌浪等20余种要素，详见“要素代码”
数据格式：webp、json
配色方案：标准配色以及支持定制化配色
使用方式：通过API获取图层文件，并与地图叠加，最终可实现拖拽、放大缩小等诸多功能。您既可以展示静态的单张图片，亦可连续播放形成动态展示。

调用方式

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

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

请求参数

参数	类型	说明	必选	缺省值
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参数说明

参数名	类型
cp	对流性降水（雷雨），单位：mm
gust	阵风风速，单位：m/s
lcdc	低云量，单位：%
mslp	平均海平面气压，单位：hPa
pres	气压，单位：hPa
rh	相对湿度，单位：%
snow_dpt	积雪深度，单位：mm
snow_fall	降雪量，单位：mm
sst	海面温度，单位：℃
tcdc	总云量，单位：%
tmp	2米温度，单位：℃
tmp_change	24小时变温（升降温），单位：℃
tp	总降水量（未来0~5天逐1小时累计，未来5~10天逐3小时累计），单位：mm
vis	能见度，单位：m
wind_spd_10	10米风速，单位：m/s
wind_spd_100	100米风速，单位：m/s
hcdc	高云量，单位：%
mcdc	中云量，单位：%
soil_w0_7	0-7cm土壤体积含水量，单位：m³/m³
soil_w7_28	7-28cm土壤体积含水量，单位：m³/m³
soil_w28_100	28-100cm土壤体积含水量，单位：m³/m³
soil_w100_289	100-289cm土壤体积含水量，单位：m³/m³
shww	风浪，单位：m
swh	海浪，单位：m
shts	涌浪，单位：m

返回参数

参数名	规则说明	含义
status	int	状态码，非0表示没有正常获取到数据
dataCode	String	数据编码
productCode	String	产品类型编码
meteCode	String	要素编码
timeRange	String[]	请求的数据时间范围，格式yyyyMMddHHmm
urls	Object	时间序列对应的文件

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/grid/forecast?productCode=mfv&meteCode=rh&start=2024072600&end=2024072800&token=您的token

返回示例

{
    "date": {
        "timeZone": "Asia/Shanghai",
        "time": "20241022191142"
    },
    "result": {
        "meteCode": "rh",
        "urls": {
            "2024102200": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/gfs/202410/2120/rh_2024102200067e23130fa7cb96a8.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/gfs/202410/2120/rh_2024102200067e23130fa7cb96a8.json"
            ]
        },
        "productCode": "mfv",
        "dataCode": "gfs",
        "timeRange": [
            "2024102200",
            "2024102200"
        ]
    },
    "version": "v1",
    "status": 0
}