潮流

平台: API iOS Android

未来10天全球潮流数据，包括潮流流速和流向。

接口代码	接口	数据类
oceanCurrents	潮流	OceanCurrentsResponse

参数

OceanParameter

location(必选)需要查询的潮流站点，请填写潮流站点的LocationID，LocationID可通过POI搜索服务获取。例如 location=P66981
date(必选)选择日期，最多可选择未来10天（包含今天）的数据。日期格式为yyyyMMdd，例如 date=20200531

示例代码

Swift

Task{
        do {
        let sevenDaysAfter = Calendar.current.date(byAdding: .day, value: 7, to: Date())!
        let formatter = DateFormatter()
        formatter.dateFormat = "yyyMMdd"
        let date = formatter.string(from: sevenDaysAfter)
        let parameter = OceanParameter(location: "P66981", date: date)
        let response = try await QWeather.instance
            .oceanCurrents(parameter)
        print(response)
    } catch QWeatherError.errorResponse(let error) {
        print(error)
    } catch {
        print(error)
    }
}

Objective-C

NSDate * sevenDaysAfter = [[NSCalendar currentCalendar] dateByAddingUnit:NSCalendarUnitDay value:7 toDate:[NSDate date] options:0];
NSDateFormatter * formatter = [[NSDateFormatter alloc] init];
[formatter setDateFormat:@"yyyyMMdd"];
NSString * date = [formatter stringFromDate:sevenDaysAfter];
OceanParameter *parameter = [OceanParameter instanceWithLocation:@"P66981" date:date];
[QWeatherObjc oceanCurrents:parameter completionHandler:^(OceanCurrentsResponse * _Nullable response, NSError * _Nullable error) {
    if (response) {
        NSLog(@"%@", response.description);
    }
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    }
}];

返回数据

OceanCurrentsResponse

code 请参考状态码
updateTime 当前API的最近更新时间
fxLink 当前数据的响应式页面，便于嵌入网站或应用
currentsTable.fxTime 潮流最大流速时间
currentsTable.speedMax 潮流最大流速，单位：厘米/秒
currentsTable.dir360 潮流360度方向
currentsHourly.fxTime 逐小时预报时间
currentsHourly.speed 潮流流速，单位：厘米/秒
currentsHourly.dir360 潮流360度方向
refer.sources 原始数据来源，或数据源说明，可能为空
refer.license 数据许可或版权声明，可能为空