台风预报

台风预报API提供全球主要海洋流域的台风预测位置、等级、气压、风速等。

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

请求路径#

GET /v7/tropical/storm-forecast

参数#

查询参数

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

请求示例#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/v7/tropical/storm-forecast?stormid=NP2018'

请将your_token替换为你的JWT身份认证,将your_api_host替换为你的API Host

试一下

返回数据#

{
  "code": "200",
  "updateTime": "2021-07-27T03:00+00:00",
  "fxLink": "https://www.qweather.com",
  "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": [
      "https://developer.qweather.com/attribution.html"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}
  • code string 状态码
  • updateTime date-time API的最近更新时间
  • fxLink uri 当前数据的响应式页面,便于嵌入网站或应用
  • forecast array 台风预报数据列表
    • fxTime date-time 预报时间,ISO8601 格式
    • lat string 台风所处纬度
    • lon string 台风所处经度
    • type string 台风类型
    • pressure string 台风中心气压
    • windSpeed string 台风附近最大风速
    • moveSpeed string 台风移动速度
    • moveDir string 台风移动方位
    • move360 string 台风移动方位360度方向
  • refer object 数据来源和许可信息
    • sources array 原始数据来源,或数据源说明,可能为空
    • license array 数据许可或版权声明,可能为空