开发文档

逐小时预报 360 小时

支持全球海洋经纬度要素查询，返回逐小时 360 小时海洋预报数据，包含风、浪、温、流数据

接口地址

https://api.foreocean.com/global/environment/universal/hourly/360h

请求方式

GET

请求参数说明

参数名称	类型	是否必须	备注
Token	String	是	API 调用令牌，您申请应用的 Token，放在请求头中
location	String	是	经纬度，经度在前，纬度在后，例如：119.316895,39.597702
begin	String	否	定制返回的起始时间戳，默认为当前 utc 时间戳，可以用来返回两日内的历史数据，例如请求 2023-05-04 10 点后的预报数据，则传参为整点时刻时间戳：1683165600，注意时间戳是秒级时间戳，不是毫秒级！

请求示例

java

public static void main(String[] args) {
		Map<String, Object> params = new HashMap<>(16);
		params.put("space", "119.664236,35.529743");
		params.put("begin", "");
		String requestUrl = "https://api.foreocean.com/global/environment/universal/hourly/360h";
		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/hourly/360h'
    headers = {'Token': 'API调用令牌'}
    params = {'space': '119.664236,35.529743','begin': ''}
    response = requests.get(url, headers=headers, params=params)
    print(response.text)

返回结果示例

{
	"code": "1000", //响应码，1000-处理成功，其他代码说明请参考API返回错误代码说明
	"data": [
	    {
            "wave_height": 0.1,//主浪浪高 单位 m
            "wave_dir": 199.8,//主浪浪向 角度
            "wave_period": 1.9,//主浪周期 单位 s/秒
            "wind_wave_height": 0.1,//风浪高度 单位 m
            "wind_wave_dir": 244.4,//风浪浪向 角度
            "wind_wave_period": 1.5,//风浪周期 单位 s/秒
            "swell1_height": 0.0,//1级涌浪高度 单位 m
            "swell1_dir": 225.3,//1级涌浪浪向 角度
            "swell1_period": 2.6,//1级涌浪周期 单位 s/秒 
            "swell2_height": 0.0,//2级涌浪高度 单位 m
            "swell2_dir": 110.4,//2级涌浪浪向 角度
            "swell2_period": 4.2,//2级涌浪周期 单位 s/秒
            "ssh": 0.4,//海平面高度 单位 m
            "current_s": 0.1,//流速 单位 m/s
            "current_d": 90.0,//流向 单位 角度
            "win_s_10m": "3.9",//10m风速 单位 m/s
            "win_d_10m": "275.3",//10m风向 风向角度
            "sst": 24.6,//海表面温度 单位摄氏度
            "sss": 12.8,//海盐度
            "local_time": "2025-09-24T07:00:00",//查询经纬度点位的当地时间
            "utc_time": "2025-09-24T07:00:00",//utc时间
        },
        {
            "wave_height": 0.1,
            "swell1_period": 2.7,
            "wind_wave_dir": 238.7,
            "swell2_dir": 110.4,
            "wave_dir": 195.3,
            "ssh": 0.3,
            "win_s_10m": "4.2",
            "current_d": 90.0,
            "swell1_dir": 223.6,
            "swell1_height": 0.0,
            "win_d_10m": "298.7",
            "sss": 12.8,
            "local_time": "2025-09-24T08:00:00",
            "sst": 24.7,
            "utc_time": "2025-09-24T08:00:00",
            "wind_wave_height": 0.1,
            "swell2_period": 3.8,
            "wind_wave_period": 1.5,
            "swell2_height": 0.0,
            "current_s": 0.1,
            "wave_period": 1.9
        }
        //后面省略了
	],
	"msg": "success",
	"success": true
}