7 天预报
支持全球海洋经纬度要素查询，返回 7 天海洋预报数据，包含风、浪、温、流数据
接口地址
https://api.foreocean.com/global/environment/universal/daily/7d
请求方式
GET
请求参数说明
| 参数名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| Token | String | 是 | API 调用令牌，您申请应用的 Token，放在请求头中 |
| location | String | 是 | 经纬度，经度在前，纬度在后，例如：119.316895,39.597702 |
请求示例
java
public static void main(String[] args) {
Map<String, Object> params = new HashMap<>(16);
params.put("space", "119.664236,35.529743");
String requestUrl = "https://api.foreocean.com/global/environment/universal/daily/7d";
String response = get(requestUrl, params);
System.out.println(response);
}
public static String get(String url, Map<String, Object> params) {
try {
CloseableHttpClient httpClient = HttpClients.createDefault();
url = url + "?";
for (Iterator<String> iterator = params.keySet().iterator(); iterator.hasNext();) {
String key = iterator.next();
String temp = key + "=" + params.get(key) + "&";
url = url + temp;
}
url = url.substring(0, url.length() - 1);
HttpGet httpGet = new HttpGet(url);
httpGet.addHeader("Token","API调用令牌");
CloseableHttpResponse response = httpClient.execute(httpGet);
try {
HttpEntity entity = response.getEntity();
if (entity != null) {
String str = EntityUtils.toString(entity, CHARSET);
return str;
}
} finally {
response.close();
httpClient.close();
}
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
python
import requests
if __name__ == '__main__':
url = 'https://api.foreocean.com/global/environment/universal/daily/7d'
headers = {'Token': 'API调用令牌'}
params = {'space': '119.664236,35.529743'}
response = requests.get(url, headers=headers, params=params)
print(response.text)
返回结果示例
{
"code": "1000",//响应码，1000-处理成功，其他代码说明请参考API返回错误代码说明
"data": {
"wavePeriod": [//主浪周期
{
"avg": "2.0",
"min": 1.8,
"max": 2.1,
"data_time": "2025-09-24"
},
{
"avg": "1.8",
"min": 1.6,
"max": 2.1,
"data_time": "2025-09-25"
},
{
"avg": "1.6",
"min": 1.4,
"max": 2.0,
"data_time": "2025-09-26"
}
//后面省略了
],
"swell2Period": [//2级涌浪周期
{
"avg": "3.5",
"min": 3.1,
"max": 4.5,
"data_time": "2025-09-24"
},
{
"avg": "3.6",
"min": 2.8,
"max": 4.1,
"data_time": "2025-09-25"
},
{
"avg": "2.6",
"min": 1.4,
"max": 3.4,
"data_time": "2025-09-26"
}
],
"currentDir": [//流向
{
"avg": "90.0",
"min": 90.0,
"max": 90.0,
"data_time": "2025-09-24"
},
{
"avg": "90.0",
"min": 0.0,
"max": 360.0,
"data_time": "2025-09-25"
},
{
"avg": "120.8",
"min": 12.0,
"max": 360.0,
"data_time": "2025-09-26"
}
],
"swell2Dir": [//2级涌浪浪向
{
"avg": "133.7",
"min": 110.4,
"max": 170.3,
"data_time": "2025-09-24"
},
{
"avg": "120.4",
"min": 109.6,
"max": 164.8,
"data_time": "2025-09-25"
},
{
"avg": "128.3",
"min": 102.5,
"max": 168.0,
"data_time": "2025-09-26"
}
],
"ssh": [//海平面高度 单位 m
{
"avg": "0.3",
"min": 0.2,
"max": 0.4,
"data_time": "2025-09-24"
},
{
"avg": "0.2",
"min": 0.1,
"max": 0.4,
"data_time": "2025-09-25"
},
{
"avg": "0.4",
"min": 0.2,
"max": 0.4,
"data_time": "2025-09-26"
}
],
"windWaveHeight": [//风浪高度
{
"avg": "0.1",
"min": 0.0,
"max": 0.1,
"data_time": "2025-09-24"
},
{
"avg": "0.0",
"min": 0.0,
"max": 0.0,
"data_time": "2025-09-25"
},
{
"avg": "0.0",
"min": 0.0,
"max": 0.0,
"data_time": "2025-09-26"
}
],
"windDir": [//风向
{
"avg": "276.2",
"min": 229.5,
"max": 323.7,
"data_time": "2025-09-24"
},
{
"avg": "195.8",
"min": 6.9,
"max": 335.0,
"data_time": "2025-09-25"
},
{
"avg": "190.0",
"min": 67.3,
"max": 304.7,
"data_time": "2025-09-26"
}
],
"currentSpeed": [//流速 单位：m/s
{
"avg": "0.1",
"min": 0.1,
"max": 0.1,
"data_time": "2025-09-24"
},
{
"avg": "0.1",
"min": 0.0,
"max": 0.1,
"data_time": "2025-09-25"
},
{
"avg": "0.1",
"min": 0.0,
"max": 0.1,
"data_time": "2025-09-26"
}
],
"waveDir": [//主浪浪向
{
"avg": "206.5",
"min": 190.7,
"max": 225.7,
"data_time": "2025-09-24"
},
{
"avg": "176.4",
"min": 123.2,
"max": 199.0,
"data_time": "2025-09-25"
},
{
"avg": "147.4",
"min": 120.2,
"max": 164.7,
"data_time": "2025-09-26"
}
],
"swell1Dir": [//1级涌浪浪向
{
"avg": "214.8",
"min": 193.9,
"max": 230.7,
"data_time": "2025-09-24"
},
{
"avg": "203.5",
"min": 158.2,
"max": 240.6,
"data_time": "2025-09-25"
},
{
"avg": "148.9",
"min": 112.8,
"max": 163.0,
"data_time": "2025-09-26"
}
],
"waveHeight": [//主浪浪高 单位：m
{
"avg": "0.1",
"min": 0.1,
"max": 0.2,
"data_time": "2025-09-24"
},
{
"avg": "0.0",
"min": 0.0,
"max": 0.1,
"data_time": "2025-09-25"
},
{
"avg": "0.0",
"min": 0.0,
"max": 0.1,
"data_time": "2025-09-26"
}
],
"windWavePeriod": [//风浪周期 单位：s/秒
{
"avg": "1.2",
"min": 0.0,
"max": 1.8,
"data_time": "2025-09-24"
},
{
"avg": "0.1",
"min": 0.0,
"max": 0.5,
"data_time": "2025-09-25"
},
{
"avg": "0.4",
"min": 0.0,
"max": 1.0,
"data_time": "2025-09-26"
}
],
"swell2Height": [//2级涌浪高度 单位：m
{
"avg": "0.0",
"min": 0.0,
"max": 0.1,
"data_time": "2025-09-24"
},
{
"avg": "0.0",
"min": 0.0,
"max": 0.0,
"data_time": "2025-09-25"
},
{
"avg": "0.0",
"min": 0.0,
"max": 0.0,
"data_time": "2025-09-26"
}
],
"windWaveDir": [//风浪方向
{
"avg": "264.1",
"min": 228.6,
"max": 315.4,
"data_time": "2025-09-24"
},
{
"avg": "239.8",
"min": 62.8,
"max": 340.6,
"data_time": "2025-09-25"
},
{
"avg": "143.7",
"min": 47.2,
"max": 212.8,
"data_time": "2025-09-26"
}
],
"sss": [//海盐度
{
"avg": "12.8",
"min": 12.7,
"max": 12.9,
"data_time": "2025-09-24"
},
{
"avg": "12.7",
"min": 12.7,
"max": 12.8,
"data_time": "2025-09-25"
},
{
"avg": "12.7",
"min": 12.6,
"max": 12.8,
"data_time": "2025-09-26"
}
],
"swell1Height": [//1级涌浪高度 单位：m
{
"avg": "0.1",
"min": 0.0,
"max": 0.1,
"data_time": "2025-09-24"
},
{
"avg": "0.0",
"min": 0.0,
"max": 0.1,
"data_time": "2025-09-25"
},
{
"avg": "0.0",
"min": 0.0,
"max": 0.1,
"data_time": "2025-09-26"
}
],
"sst": [//海温 单位：摄氏度℃
{
"avg": "24.4",
"min": 24.3,
"max": 24.7,
"data_time": "2025-09-24"
},
{
"avg": "24.7",
"min": 24.3,
"max": 25.1,
"data_time": "2025-09-25"
},
{
"avg": "24.6",
"min": 24.3,
"max": 24.9,
"data_time": "2025-09-26"
}
],
"swell1Period": [//1级涌浪浪周期 单位：s/秒
{
"avg": "2.2",
"min": 1.9,
"max": 2.8,
"data_time": "2025-09-24"
},
{
"avg": "1.8",
"min": 1.4,
"max": 2.3,
"data_time": "2025-09-25"
},
{
"avg": "1.8",
"min": 1.3,
"max": 3.5,
"data_time": "2025-09-26"
}
],
"windSpeed": [//风速 单位：m/s
{
"avg": "3.6",
"min": 1.3,
"max": 4.6,
"data_time": "2025-09-24"
},
{
"avg": "2.2",
"min": 0.2,
"max": 3.7,
"data_time": "2025-09-25"
},
{
"avg": "3.5",
"min": 1.5,
"max": 4.9,
"data_time": "2025-09-26"
}
]
},
"msg": "success",
"success": true
}