台风列表

平台: API iOS Android

台风列表提供全球主要海洋流域最近2年的台风列表。

目前仅支持中国沿海地区，即basin=NP

接口代码	接口	数据类
tropicalStormList	台风列表	StormListResponse

参数

StormListParameter

basin(必选)需要查询的台风所在的流域，例如中国处于西北太平洋，即 basin=NP。当前仅支持NP。
- AL North Atlantic 北大西洋
- EP Eastern Pacific 东太平洋
- NP NorthWest Pacific 西北太平洋
- SP SouthWestern Pacific 西南太平洋
- NI North Indian 北印度洋
- SI South Indian 南印度洋
year(必选)支持查询本年度和上一年度的台风，例如：year=2020, year=2019

示例代码

Swift

Task{
    do {
        let parameter = StormListParameter(basin: .NP, year: 2024)
        let response = try await QWeather.instance
            .tropicalStormList(parameter)
        print(response)
    } catch QWeatherError.errorResponse(let error) {
        print(error)
    } catch {
        print(error)
    }
}

Objective-C

StormListParameter *parameter = [StormListParameter instanceWithBasin:BasinNP year:2024];
[QWeatherObjc tropicalStormList:parameter completionHandler:^(StormListResponse * _Nullable response, NSError * _Nullable error) {
    if (response) {
        NSLog(@"%@", response.description);
    }
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    }
}];

返回数据

StormListResponse

code 请参考状态码
updateTime 当前API的最近更新时间
fxLink 当前数据的响应式页面，便于嵌入网站或应用
storm.stormId 台风ID
storm.name 台风名称
storm.basin 台风所处流域
storm.year 台风所处年份
storm.isActive 是否为活跃台风。1 活跃台风，0 停编。
refer.sources 原始数据来源，或数据源说明，可能为空
refer.license 数据许可或版权声明，可能为空