热带气旋（台风）

适用于 iOS SDK v4.8+

台风数据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或以上