开发文档开发文档
文档
官网
控制台
服务协议
更新日志
文档
官网
控制台
服务协议
更新日志
  • 开始使用

    • 如何接入API
    • API计费限流规则
    • API错误代码说明
    • 不同版本区别
    • 联系我们
    • 海洋天气对照表
    • 海洋要素对照表
  • 海洋警报

    • 极端天气预警
    • 海浪警报
    • 风暴潮警报
    • 海冰警报
    • 海啸
  • 海洋环境(国内)

    • 3天预报
    • 7天预报
    • 15天预报
    • 逐小时预报72小时
    • 逐小时预报168小时
    • 逐小时预报360小时
    • 潮汐30天预报
    • 逐小时潮汐预报72小时
    • 逐小时潮汐预报168小时
    • 逐小时潮汐预报360小时
  • 海洋环境(全球)

    • 3天预报
    • 7天预报
    • 15天预报
    • 逐小时预报72小时
    • 逐小时预报168小时
    • 逐小时预报360小时
  • 海洋天气

    • 海洋天气实况
    • 3天预报
    • 7天预报
    • 15天预报
    • 逐小时预报72小时
    • 逐小时预报168小时
    • 逐小时预报360小时
    • 热带气旋
    • 海上强对流数据接口
    • 海雾数据接口
  • 海洋专题

    • 渔区网格
    • 近岸海域
    • 渔场
    • 港口
  • 海洋生态

  • 地理环境

    • 日出日落
    • 月出月落月相
    • 全球水深数据
    • 通用地理环境
  • 旅游专题

    • 钓鱼
    • 赶海
    • 通用旅游指数

通用旅游指数

返回信息包含了钓鱼、赶海、游泳适宜度、观日出指数

接口地址

https://api.foreocean.com/travel/universal

请求方式

GET

请求参数说明

参数名称类型是否必须备注
TokenString是API 调用令牌,您申请应用的 Token,放在请求头中
locationString是经纬度,例如:121.413454,37.585744
dayString是日期天数,例如: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
}
Prev
赶海