潮汐

平台: API iOS Android

未来10天全球潮汐数据，包括满潮、干潮高度和时间，逐小时潮汐数据。

接口代码	接口	数据类
oceanTide	潮汐	OceanTideResponse

参数

OceanParameter

location(必选)需要查询的潮汐站点，请填写潮汐站点的LocationID，LocationID可通过POI搜索服务获取。例如 location=P2951
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: "P2236", date: date)
        let response = try await QWeather.instance
            .oceanTide(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:@"P2236" date:date];
[QWeatherObjc oceanTide:parameter completionHandler:^(OceanTideResponse * _Nullable response, NSError * _Nullable error) {
    if (response) {
        NSLog(@"%@", response.description);
    }
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    }
}];

返回数据

OceanTideResponse

code 请参考状态码
updateTime 当前API的最近更新时间
fxLink 当前数据的响应式页面，便于嵌入网站或应用
tideTable.fxTime 满潮或干潮时间
tideTable.height 海水高度，单位：米
tideTable.type 满潮（H）或干潮（L）
tideHourly.fxTime 逐小时预报时间
tideHourly.height 海水高度，单位：米。对于一些地点，此数据可能为空
refer.sources 原始数据来源，或数据源说明，可能为空
refer.license 数据许可或版权声明，可能为空