逐小时预报 72 小时

海洋要素，返回逐小时 72 小时海洋预报数据，包含风、浪、温、流数据

接口地址

https://api.foreocean.com/environment/universal/hourly/72h

请求方式

GET

请求参数说明

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

请求示例

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/environment/universal/hourly/72h";
		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;
	}

import requests

if __name__ == '__main__':
    url = 'https://api.foreocean.com/environment/universal/hourly/72h'
    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": {
		"gridName": "119.751695,35.515907", //无实际意义 可忽略此字段
		"reportDate": "2021-12-16 08:00:00", //数据起报时间点
		"data": {
			"sst": [ //海温
				{
                    "datatime": "2022-03-11 00:00:00",//时间
                    "value": "5.8"//单位 °C
                },
                {
                    "datatime": "2022-03-11 01:00:00",
                    "value": "5.8"
                },
                {
                    "datatime": "2022-03-11 02:00:00",
                    "value": "5.8"
                },
				//...此处忽略69个
			],
			"seawater": {
				"waterSpeed": [ //海流流速
					{
                        "datatime": "2022-03-11 00:00:00",//时间
                        "value": "21.9"//单位：cm/s
                    },
                    {
                        "datatime": "2022-03-11 01:00:00",
                        "value": "37.2"
                    },
                    {
                        "datatime": "2022-03-11 02:00:00",
                        "value": "47.5"
                    },
				],
				"waterDirection": [ //海流流向
                    {
                        "datatime": "2022-03-11 00:00:00",//时间
                        "value": "245.8"//角度 从北顺时针360度
                    },
                    {
                        "datatime": "2022-03-11 01:00:00",
                        "value": "276.2"
                    },
                    {
                        "datatime": "2022-03-11 02:00:00",
                        "value": "292.2"
                    },
				]
			},
			"wave": {
				"waveHeight": [ //浪高
					{
                        "datatime": "2022-03-11 00:00:00",//时间
                        "value": "0.3"//单位 m
                    },
                    {
                        "datatime": "2022-03-11 01:00:00",
                        "value": "0.3"
                    },
                    {
                        "datatime": "2022-03-11 02:00:00",
                        "value": "0.3"
                    },
				],
				"waveDirection": [ //浪向
					{
                        "datatime": "2022-03-11 00:00:00",//时间
                        "value": "129.0"//方向
                    },
                    {
                        "datatime": "2022-03-11 01:00:00",
                        "value": "128.0"
                    },
                    {
                        "datatime": "2022-03-11 02:00:00",
                        "value": "128.0"
                    },
				],
				"wavePeriod": [ //浪周期
                    {
                        "datatime": "2022-03-11 00:00:00",//时间
                        "value": "3.4"//单位：秒
                    },
                    {
                        "datatime": "2022-03-11 01:00:00",
                        "value": "3.4"
                    },
                    {
                        "datatime": "2022-03-11 02:00:00",
                        "value": "3.4"
                    },
				]
			},
			"wind": {
				"windSpeed": [ //海风风速
					{
                        "datatime": "2022-03-11 00:00:00",//时间
                        "value": "1.8"//单位 m/s
                    },
                    {
                        "datatime": "2022-03-11 01:00:00",
                        "value": "1.8"
                    },
                    {
                        "datatime": "2022-03-11 02:00:00",
                        "value": "1.8"
                    },
				],
				"windDirection": [ //海风风向
					{
                        "datatime": "2022-03-11 00:00:00",//时间
                        "value": "43.5"//方向
                    },
                    {
                        "datatime": "2022-03-11 01:00:00",
                        "value": "31.9"
                    },
                    {
                        "datatime": "2022-03-11 02:00:00",
                        "value": "22.2"
                    },
				]
			}
		}
	},
	"msg": "success",
	"success": true
}