潮汐和潮流

适用于 iOS SDK v4.4+

和风天气潮汐和潮流SDK包含全球1万多个港口数据,提供未来10天潮汐和潮流数据,包括满潮、干潮高度和时间,逐小时潮汐和潮流数据。

潮汐

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

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_OCEAN_TIDE 潮汐 OceanTideBaseClass

请求参数

location

需要查询的潮汐站点,请填写潮汐站点的LocationID,LocationID可通过POI搜索服务获取。例如 location=P2951

date

选择日期,最多可选择未来10天(包含今天)的数据。日期格式为yyyyMMdd,例如 date=20200531

appKey

用户认证key,请参考如何获取你的KEY。例如 appKey=123456789ABC

示例代码

QWeatherConfigInstance.publicID = @"publicID";
QWeatherConfigInstance.appKey = @"key";
QWeatherConfigInstance.appType = APP_TYPE_BIZ;    
QWeatherConfigInstance.location = @"P66981";
QWeatherConfigInstance.date = @"20210518";
[QWeatherConfigInstance weatherWithInquireType: INQUIRE_TYPE_OCEAN_TIDE WithSuccess:^(OceanTideBaseClass  *responseObject) {
        
    NSLog(@"描述->%@",[responseObject description]);
        
} faileureForError:^(NSError *error) {
    NSLog(@"error->%@",error);
        
}];

返回数据

参数 描述
code

API状态码,具体含义请参考状态码

updateTime

当前API的最近更新时间

fxLink

当前数据的响应式页面,便于嵌入网站或应用

tideTable.fxTime

满潮或干潮时间

tideTable.height

海水高度,单位:米

tideTable.type

满潮(H)或干潮(L)

tideHourly.fxTime

逐小时预报时间

tideHourly.height

海水高度,单位:米

refer.sources

原始数据来源,或数据源说明,可能为空

refer.license

数据许可或版权声明,可能为空

潮流

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

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_OCEAN_CURRENTS 潮流 OceanTideBaseClass

请求参数

请求参数包括必选和可选参数,如不填写可选参数将使用其默认值。

location

需要查询的潮流站点,请填写潮流站点的LocationID,LocationID可通过POI搜索服务获取。例如 location=P66981

date

选择日期,最多可选择未来10天(包含今天)的数据。日期格式为yyyyMMdd,例如 date=20200531

appKey

用户认证key,请参考如何获取你的KEY。例如 appKey=123456789ABC

示例代码

QWeatherConfigInstance.publicID = @"publicID";
QWeatherConfigInstance.appKey = @"key";
QWeatherConfigInstance.appType = APP_TYPE_BIZ;    
QWeatherConfigInstance.location = @"P66981";
QWeatherConfigInstance.date = @"20210518";
[QWeatherConfigInstance weatherWithInquireType: INQUIRE_TYPE_OCEAN_CURRENTS WithSuccess:^(OceanCurrentsBaseClass  *responseObject) {
        
    NSLog(@"描述->%@",[responseObject description]);
        
} faileureForError:^(NSError *error) {
    NSLog(@"error->%@",error);
        
}];

返回数据

参数 描述
code

API状态码,具体含义请参考状态码

updateTime

当前API的最近更新时间

fxLink

当前数据的响应式页面,便于嵌入网站或应用

currentsTable.fxTime

潮流最大流速时间

currentsTable.speedMax

潮流最大流速,单位:厘米/秒

currentsTable.dir360

潮流360度方向

currentsHourly.fxTime

逐小时预报时间

currentsHourly.speed

潮流流速,单位:厘米/秒

currentsHourly.dir360

潮流360度方向

refer.sources

原始数据来源,或数据源说明,可能为空

refer.license

数据许可或版权声明,可能为空