逐小时潮汐预报 24 小时
潮汐预报数据,返回逐小时 24 小时潮汐数据
接口地址
https://api.foreocean.com/environment/tide/hourly/24h
请求方式
GET
请求参数说明
参数名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
Token | String | 是 | API 调用令牌,您申请应用的 Token,放在请求头中 |
space | String | 是 | 经纬度,例如:119.35254,35.036837 |
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/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
}