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

全球风流场

更新时间：2025-11-05 09:59:27

接口说明

本接口为“全球公里级网格预报图层”的补充，为了丰富可视化产品展示效果，我们推出流场产品，并提供示例代码，其中包括在高德地图、百度地图、leaflet、openlayer、Cesium等二三维地图框架的应用示例，使您可以在应用中快速集成，直观地展示流场特征。
空间范围：全球
空间分辨率：25km
时间范围：查询时间过去24小时至未来10天
更新频次：2次/天（北京时间08时、20时）
预报时效：未来0~5天逐1小时，未来5~10天逐3小时
数据要素：10米高度风场、100米高度风场

调用方式

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

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

请求参数

参数名	含义	类型	是否必填	缺省值
meteCode	要素类型，见要素代码表	string	是	/
start	查询开始时间（yyyyMMddHH）,start和end必填一个，当只传一个时间时，默认查询该时刻数据。	string	是	/
end	查询结束时间（yyyyMMddHH）,start和end必填一个，当只传一个时间时，默认查询该时刻数据。	string	是	/

meteCode要素类型代码表

wind_spd_10	10米高度风场
wind_spd_100	100米高度风场

返回参数

参数名	类型	说明
status	int	状态码，非0表示没有正常获取到数据
dataCode	String	数据编码
productCode	String	产品类型编码
meteCode	String	要素编码
timeRange	String[]	请求的数据时间范围，格式：”yyyyMMddHH”,”yyyyMMddHH”
urls	Object	时间序列对应的文件，每个时次包括一个webp/png文件和一个json文件

json文件参数说明

注：此说明用于帮助理解文件内容，应用开发可使用示例代码中的函数直接读取json文件。

参数名	参数说明	值
lo1	最小经度	固定为-180
lo2	最大经度	固定为179.75
la1	最小纬度	固定为-90
la2	最大纬度	固定为90
dx	横向步长	固定为1
dy	纵向步长	固定为0.99
nx	横向划分栅格数量	固定为360
ny	纵向划分栅格数量	固定为181
gribLength	栅格点数量	固定为65160
parameterNumberName	要素名称	U-component_of_wind、V-component of wind，每个文件包含以上两个要素名称的数据体
parameterUnit	数据单位	固定为m/s
refTime	数据时次	格式为yyyyMMddHHmm
data	各栅格点的风速数值	-

调用示例

请求示例

https://api.open.geovisearth.com/v2/flow/gfs/range?token=您的token&meteCode=wind_spd_10&start=2024101601&end=2024101608

返回示例

 {
    "status": 0,
    "version": "v1",
    "date": {
        "time": "20241016133647",
        "timeZone": "Asia/Shanghai"
    },
    "result": {
        "dataCode": "gfs",
        "productCode": "flow",
        "meteCode": "wind_spd_10",
        "timeRange": [
            "2024101601",
            "2024101608"
        ],
        "urls": {
            "2024101601": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/gfs/202410/1520/wind_spd_10_2024101601000926b4151aa2b46553.json",
            "2024101602": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/gfs/202410/1520/wind_spd_10_202410160200295ed353d8301dfba4.json",
            "2024101603": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/gfs/202410/1520/wind_spd_10_20241016030037f780f8370cd219db.json",
            "2024101604": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/gfs/202410/1520/wind_spd_10_202410160400832565768f2ce147f7.json",
            "2024101605": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/gfs/202410/1520/wind_spd_10_202410160500b50fcec268abad18cc.json",
            "2024101606": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/gfs/202410/1520/wind_spd_10_202410160600333fae6f4a80db6ca4.json",
            "2024101607": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/gfs/202410/1520/wind_spd_10_202410160700dfb3e90a54a6c69b3c.json",
            "2024101608": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/gfs/202410/1520/wind_spd_10_202410160800469337c0d5e068eb39.json"
        }
    }
}