热带气旋(台风)

适用于 iOS SDK v4.4+

台风数据SDK提供全球主要海洋流域的热带低气压(台风)信息,包括台风实时位置、等级、气压、风力、速度,还可查询台风路径和台风预报信息。

台风列表

获取全球全球主要海洋流域的台风列表。

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

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_STORM_LIST 台风列表 StormListBaseClass

请求参数

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

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

appKey

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

示例代码

    QWeatherConfigInstance.publicID = @"publicID";
    QWeatherConfigInstance.appKey = @"key";
    QWeatherConfigInstance.appType = APP_TYPE_BIZ;    
    QWeatherConfigInstance.basin = BASIN_TYPE_NP;
    QWeatherConfigInstance.year = @"2021";
    [QWeatherConfigInstance weatherWithInquireType:INQUIRE_TYPE_STORM_LIST WithSuccess:^(StormListBaseClass  *responseObject) {
        
        NSLog(@"描述->%@",[responseObject description]);
        
    } faileureForError:^(NSError *error) {
        NSLog(@"error->%@",error);
        
    }];

返回数据

参数 描述
code

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

updateTime

当前API的最近更新时间

fxLink

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

storm.stormId

台风ID

storm.name

台风名称

storm.basin

台风所处流域

storm.year

台风所处年份

storm.isActive

是否为活跃台风
1 活跃台风
0 停编

refer.sources

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

refer.license

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

台风实况和路径

台风实况和路径提供全球主要海洋流域的热带低气压(台风)信息,包括台风实时位置、等级、气压、风力、速度。

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_STORM_TRACK 台风实况和路径 StormNowTrackBaseClass

请求参数

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

stormid

需要查询的台风ID,StormID可通过台风列表获取。例如 stormid=NP2018

appKey

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

示例代码

    QWeatherConfigInstance.publicID = @"publicID";
    QWeatherConfigInstance.appKey = @"key";
    QWeatherConfigInstance.appType = APP_TYPE_BIZ;    
    QWeatherConfigInstance.stormID = @"NP_2102";
    [QWeatherConfigInstance weatherWithInquireType: INQUIRE_TYPE_STORM_TRACK WithSuccess:^(StormNowTrackBaseClass  *responseObject) {
        
        NSLog(@"描述->%@",[responseObject description]);
        
    } faileureForError:^(NSError *error) {
        NSLog(@"error->%@",error);
        
    }];

返回数据

参数 描述
code

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

updateTime

当前API的最近更新时间

fxLink

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

isActive

是否为活跃台风
1 活跃台风
0 停编

now.pubTime

台风信息发布时间

now.lat

台风所处纬度

now.lon

台风所处经度

now.type

台风类型

now.pressure

台风中心气压

now.windSpeed

台风附近最大风速

now.moveSpeed

台风移动速度

now.moveDir

台风移动方位

now.move360

台风移动方位360度方向

now.windRadius30.neRadius

台风7级风圈东北半径,可能为空

now.windRadius30.seRadius

当前台风7级风圈东南半径,可能为空

now.windRadius30.swRadius

当前台风7级风圈西南半径,可能为空

now.windRadius30.nwRadius

当前台风7级风圈西北半径,可能为空

now.windRadius50.neRadius

台风10级风圈东北半径,可能为空

now.windRadius50.seRadius

当前台风10级风圈东南半径,可能为空

now.windRadius50.swRadius

当前台风10级风圈西南半径,可能为空

now.windRadius50.nwRadius

当前台风10级风圈西北半径,可能为空

now.windRadius64.neRadius

台风12级风圈东北半径,可能为空

now.windRadius64.seRadius

当前台风12级风圈东南半径,可能为空

now.windRadius64.swRadius

当前台风12级风圈西南半径,可能为空

now.windRadius64.nwRadius

当前台风12级风圈西北半径,可能为空

track.time

当前台风信息发布时间

track.lat

台风所处纬度

track.lon

台风所处经度

track.type

台风类型

track.pressure

台风中心气压

track.windSpeed

台风附近最大风速

track.moveSpeed

台风移动速度

track.moveDir

台风移动方位

track.move360

台风移动方位360度方向

track.windRadius30.neRadius

台风7级风圈东北半径,可能为空

track.windRadius30.seRadius

当前台风7级风圈东南半径,可能为空

track.windRadius30.swRadius

当前台风7级风圈西南半径,可能为空

track.windRadius30.nwRadius

当前台风7级风圈西北半径,可能为空

track.windRadius50.neRadius

台风10级风圈东北半径,可能为空

track.windRadius50.seRadius

当前台风10级风圈东南半径,可能为空

track.windRadius50.swRadius

当前台风10级风圈西南半径,可能为空

track.windRadius50.nwRadius

当前台风10级风圈西北半径,可能为空

track.windRadius64.neRadius

台风12级风圈东北半径,可能为空

track.windRadius64.seRadius

当前台风12级风圈东南半径,可能为空

track.windRadius64.swRadius

当前台风12级风圈西南半径,可能为空

track.windRadius64.nwRadius

当前台风12级风圈西北半径,可能为空

refer.sources

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

refer.license

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

台风预报

台风预报提供全球主要海洋流域的热带低气压(台风)的预报信息,包括台风预测位置、等级、气压、风力、速度

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_STORM_FORECAST 台风预报 StormForecastBaseClass

请求参数

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

stormid

需要查询的台风ID,StormID可通过台风列表获取。例如 stormid=NP2018

appKey

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

示例代码

    QWeatherConfigInstance.publicID = @"publicID";
    QWeatherConfigInstance.appKey = @"key";
    QWeatherConfigInstance.appType = APP_TYPE_BIZ;    
    QWeatherConfigInstance.stormID = @"NP_2102";
    [QWeatherConfigInstance weatherWithInquireType: INQUIRE_TYPE_STORM_FORECAST WithSuccess:^(StormForecastBaseClass  *responseObject) {
        
        NSLog(@"描述->%@",[responseObject description]);
        
    } faileureForError:^(NSError *error) {
        NSLog(@"error->%@",error);
        
    }];

返回数据

参数 描述
code

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

updateTime

当前API的最近更新时间

fxLink

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

forecast.fxTime

台风预报时间

forecast.lat

台风所处纬度

forecast.lon

台风所处经度

forecast.type

台风类型

forecast.pressure

台风中心气压

forecast.windSpeed

台风附近最大风速

forecast.moveSpeed

台风移动速度

forecast.moveDir

台风移动方位

forecast.move360

台风移动方位360度方向

refer.sources

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

refer.license

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

台风等级

GBT 19201-2006

热带气旋等级 底层中心附近最大平均风速(m/s) 底层中心附近最大风力(级)
热带气压(TD) 10.8-17.1 6-7
热带风暴(TS) 17.2-24.4 8-9
强热带风暴(STS) 24.5-32.6 10-11
台风(TY) 32.7-41.4 12-13
强台风(STY) 41.5-50.9 14-15
超强台风(SuperTY) ≥51.0 16或以上