逐小时潮汐预报 24 小时

潮汐预报数据,返回逐小时 24 小时潮汐数据

接口地址

https://api.foreocean.com/environment/tide/hourly/24h

请求方式

GET

请求参数说明

参数名称类型是否必须备注
TokenStringAPI 调用令牌,您申请应用的 Token,放在请求头中
spaceString经纬度,例如:119.35254,35.036837
beginString定制返回的起始时间戳,默认为当前 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/tide/hourly/24h";
		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/tide/hourly/24h'
    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": {
        "harmonicTide": [ //天文潮预报数据
            {
                "datatime": "2022-03-11 00:00:00", //时间
                "value": 107.89 //天文潮数值 单位 cm
            },
            {
                "datatime": "2022-03-11 01:00:00",
                "value": 209.82
            },
            {
                "datatime": "2022-03-11 02:00:00",
                "value": 250.2
            },
            //逐24小时,后面省略了
        ],
        "combinedWater": [ //预测水位数据
            {
                "datatime": "2022-03-11 00:00:00", //时间
                "value": 476.9 //水位数值 单位 cm
            },
            {
                "datatime": "2022-03-11 01:00:00",
                "value": 331.16
            },
            {
                "datatime": "2022-03-11 02:00:00",
                "value": 191.25
            },
            //逐24小时,后面省略了
        ]
    },
    "msg": "success",
    "success": true
}
最后更新于:
维护人: “wenjunzhangp, zhang