通用旅游指数
返回信息包含了钓鱼、赶海、游泳适宜度、观日出指数
接口地址
https://api.foreocean.com/travel/universal
请求方式
GET
请求参数说明
参数名称 | 类型 | 是否必须 | 备注 |
---|---|---|---|
Token | String | 是 | API 调用令牌,您申请应用的 Token,放在请求头中 |
location | String | 是 | 经纬度,例如:121.413454,37.585744 |
day | String | 是 | 日期天数,例如:0 指代今日,可传参数 0-4,0 当天,1 第二天,以此类推 |
请求示例
java
public static void main(String[] args) {
Map<String, Object> params = new HashMap<>(16);
params.put("location", "121.447518,37.519286");
params.put("day", "0");
String requestUrl = "https://api.foreocean.com/travel/universal";
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/travel/universal'
headers = {'Token': 'API调用令牌'}
params = {'location': '121.447518,37.519286','day': '0'}
response = requests.get(url, headers=headers, params=params)
print(response.text)
返回结果示例
{
"code": "1000", //响应码,1000-处理成功,其他代码说明请参考API返回错误代码说明
"data": {
"tideMark": "干潮", //潮水现象名称 满潮 干潮 涨1-9分潮 落1-9分潮
"highTime": "00:00", //当日潮水最高时刻
"lowTime": "06:00", //当日潮水最低时刻
//赶海指数 最佳赶海时间段 潮水最低时刻前后两个小时
"sea": [{
"seaMark": "07日04时~07日08时"
},
{
"seaMark": "07日15时~07日19时"
}
],
//钓鱼指数 最佳钓鱼时间段 潮水涨七落三
"fish": [{
"fishMark": "06日21时~07日01时"
},
{
"fishMark": "07日09时~07日14时"
},
{
"fishMark": "07日21时~08日02时"
}
],
//游泳指数
"swim": "微风,微浪,海温偏冷,不宜游泳",
//观日指数
"watchsun": "轻度雾霾,不宜外出观日",
//生活指数
"lifeIndex": {
"ultraviolet": {//紫外线指数
"index": "1",//等级,请参照 海洋天气对照表 生活指数等级
"desc": "最弱"//描述
},
"dressing": {//穿衣指数
"index": "5",//等级,请参照 海洋天气对照表 生活指数等级
"desc": "凉爽"//描述
},
"comfort": {//舒适度指数
"index": "4",//等级,请参照 海洋天气对照表 生活指数等级
"desc": "温暖"//描述
},
"coldRisk": {//感冒指数
"index": "4",//等级,请参照 海洋天气对照表 生活指数等级
"desc": "极易发"//描述
}
}
},
"msg": "success",
"success": true
}