热带气旋(台风)
适用于 iOS SDK v4.9+台风数据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 |
|
fxLink |
当前数据的响应式页面,便于嵌入网站或应用 |
storm.stormId |
台风ID |
storm.name |
台风名称 |
storm.basin |
台风所处流域 |
storm.year |
台风所处年份 |
storm.isActive |
是否为活跃台风 |
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 |
|
fxLink |
当前数据的响应式页面,便于嵌入网站或应用 |
isActive |
是否为活跃台风 |
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 |
|
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或以上 |