台风预报

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

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

请求URL

  • 商业版https://api.qweather.com/v7/tropical/storm-forecast?[请求参数]

请求参数

请求参数包括必选和可选参数,如不填写可选参数将使用其默认值,参数之间使用&进行分隔。

stormid

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

key

用户认证key,请参考如何获取你的KEY。支持数字签名方式进行认证。例如 key=123456789ABC

返回数据

// 2021年烟花台风预报
// https://api.qweather.com/v7/tropical/storm-forecast?stormid=NP_2106&key=你的KEY

{
  "code": "200",
  "updateTime": "2021-07-27T03:00+00:00",
  "fxLink": "http://hfx.link/1",
  "forecast": [
    {
      "fxTime": "2021-07-27T20:00+08:00",
      "lat": "31.7",
      "lon": "118.4",
      "type": "TS",
      "pressure": "990",
      "windSpeed": "18",
      "moveSpeed": "",
      "moveDir": "",
      "move360": ""
    },
    {
      "fxTime": "2021-07-28T08:00+08:00",
      "lat": "32.5",
      "lon": "117.4",
      "type": "TD",
      "pressure": "992",
      "windSpeed": "15",
      "moveSpeed": "",
      "moveDir": "",
      "move360": ""
    },
    {
      "fxTime": "2021-07-28T20:00+08:00",
      "lat": "33.1",
      "lon": "117.2",
      "type": "TD",
      "pressure": "992",
      "windSpeed": "15",
      "moveSpeed": "",
      "moveDir": "",
      "move360": ""
    },
    {
      "fxTime": "2021-07-29T08:00+08:00",
      "lat": "34.3",
      "lon": "117.2",
      "type": "TD",
      "pressure": "992",
      "windSpeed": "15",
      "moveSpeed": "",
      "moveDir": "",
      "move360": ""
    },
    {
      "fxTime": "2021-07-29T20:00+08:00",
      "lat": "36",
      "lon": "117.8",
      "type": "TD",
      "pressure": "992",
      "windSpeed": "15",
      "moveSpeed": "",
      "moveDir": "",
      "move360": ""
    },
    {
      "fxTime": "2021-07-30T08:00+08:00",
      "lat": "37.1",
      "lon": "118.7",
      "type": "TD",
      "pressure": "995",
      "windSpeed": "15",
      "moveSpeed": "",
      "moveDir": "",
      "move360": ""
    },
    {
      "fxTime": "2021-07-31T08:00+08:00",
      "lat": "38",
      "lon": "119.8",
      "type": "TD",
      "pressure": "995",
      "windSpeed": "15",
      "moveSpeed": "",
      "moveDir": "",
      "move360": ""
    }
  ],
  "refer": {
    "sources": [
      "Weather China"
    ],
    "license": [
      "commercial license"
    ]
  }
}
参数 描述
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或以上