台风预报

平台: API iOS Android

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

如果查询的台风已经结束,则返回的数据为空,建议先通过台风列表获取台风的状态

接口代码 接口 数据类
tropicalStormForecast 台风预报 StormForecastResponse

参数

StormParameter

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

示例代码

Swift

Task{
    do {
        let parameter = StormParameter(stormid: "NP_2421")
        let response = try await QWeather.instance
            .tropicalStormForecast(parameter)
        print(response)
    } catch QWeatherError.errorResponse(let error) {
        print(error)
    } catch {
        print(error)
    }
}

Objective-C

StormParameter *parameter = [StormParameter instanceWithStormid:@"NP_2421"];
[QWeatherObjc tropicalStormForecast:parameter completionHandler:^(StormForecastResponse * _Nullable response, NSError * _Nullable error) {
    if (response) {
        NSLog(@"%@", response.description);
    }
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    }
}];

返回数据

StormForecastResponse

  • code 请参考状态码
  • 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或以上