开发文档

7 天预报

海洋要素，返回 7 天海洋预报数据，包含风、浪、温、流数据

接口地址

https://api.foreocean.com/environment/universal/daily/7d

请求方式

GET

请求参数说明

参数名称	类型	是否必须	备注
Token	String	是	API 调用令牌，您申请应用的 Token，放在请求头中
space	String	是	经纬度或地址，例如：辽宁省大连市甘井子区或者 119.664236,35.529743

请求示例

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/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/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": {
        "gridName": "119.664236,35.529743",//无实际意义 可忽略此字段
        "reportDate": "2022-03-11 08:00:00",//数据起报时间点
        "data": {
            //day1-day7 分别指代第一天到第七天预报情况，数据起始时间从第一天 0 点开始，到 23 点止。
            "sst": [ //海温
                {
                    "day1": { //第一天最大最小值 单位 °C
                        "min": "5.8",
                        "max": "6.3"
                    },
                    "day2": { //第二天最大最小值
                        "min": "5.8",
                        "max": "6.7"
                    },
                    "day3": { //第三天最大最小值
                        "min": "6.4",
                        "max": "6.9"
                    }
                    //后面省略了
                }
            ],
            "seawater": {
                "waterSpeed": [ //海流流速
                    {
                        "day1": { //第一天最大最小值 单位 cm/s
                            "min": "0.0",
                            "max": "19.0"
                        },
                        "day2": { //第二天最大最小值
                            "min": "0.0",
                            "max": "21.0"
                        },
                        "day3": { //第三天最大最小值
                            "min": "0.0",
                            "max": "17.0"
                        }
                        //后面省略了
                    }
                ]
            },
            "wave": {
                "waveHeight": [ //浪高
                    {
                        "day1": { //第一天最大最小值 单位 m
                            "min": "0.3",
                            "max": "0.4"
                        },
                        "day2": { //第二天最大最小值
                            "min": "0.3",
                            "max": "0.3"
                        },
                        "day3": { //第三天最大最小值
                            "min": "0.1",
                            "max": "0.3"
                        }
                        //后面省略了
                    }
                ]
            },
            "wind": {
                "windSpeed": [ //风速
                    {
                        "day1": { //第一天最大最小值 单位 cm/s
                            "min": "1.8",
                            "max": "3.3"
                        },
                        "day2": { //第二天最大最小值
                            "min": "1.8",
                            "max": "4.3"
                        },
                        "day3": { //第三天最大最小值
                            "min": "2.0",
                            "max": "3.2"
                        }
                        //后面省略了
                    }
                ]
            }
        }
    },
    "msg": "success",
    "success": true
}