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

全球海流流场

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

接口说明

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

调用方式

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

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

请求参数

参数名	含义	规则数据	是否必填	缺省值
meteCode	要素类型，见要素代码表	string	是	/
start	查询开始时间（yyyyMMddHH）	string	是	/
end	查询结束时间（yyyyMMddHH）	string	是	/

meteCode要素代码表：

要素代码	要素说明
current_speed	海流流速

返回参数

参数名	类型	说明
status	int	状态码，非0表示没有正常获取到数据
dataCode	String	数据编码
productCode	String	产品类型编码
meteCode	String	要素编码
timeRange	String	请求的数据时间范围，格式：”yyyyMMddHH”,”yyyyMMddHH”
urls	String	时间序列对应的文件，每个时次包括一个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/ocean/flow/range?token=您的token&start=2024101601&end=2024101608&meteCode=wind_spd_10

返回示例

{
    "status": 0,
    "version": "v1",
    "date": {
        "time": "20241016140926",
        "timeZone": "Asia/Shanghai"
    },
    "result": {
        "dataCode": "current",
        "productCode": "flow",
        "meteCode": "current_speed",
        "timeRange": [
            "2024101601",
            "2024101608"
        ],
        "urls": {
            "2024101601": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/current/202410/1408/currentSpeed_202410160100a3b27dea347012661f.json",
            "2024101602": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/current/202410/1408/currentSpeed_202410160200b582e138263ff4bd52.json",
            "2024101603": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/current/202410/1408/currentSpeed_202410160300a716341eb18550d31e.json",
            "2024101604": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/current/202410/1408/currentSpeed_202410160400ef25767e09ae2196e1.json",
            "2024101605": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/current/202410/1408/currentSpeed_2024101605004dcd1a82c18e78b09a.json",
            "2024101606": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/current/202410/1408/currentSpeed_20241016060051047db18df9b25dd7.json",
            "2024101607": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/current/202410/1408/currentSpeed_20241016070044da13837b7ee13321.json",
            "2024101608": "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/flow/current/202410/1408/currentSpeed_2024101608003ec7c635127d59376c.json"
        }
    }
}