台风实况和路径

台风实况和路径API提供全球主要海洋流域的台风实时位置、等级、气压、风速以及活跃台风的轨迹路径。

请求路径#

GET /v7/tropical/storm-track

参数#

查询参数

stormid^必选

string

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

请求示例#

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

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

试一下

返回数据#

{
  "code": "200",
  "updateTime": "2024-05-30T06:11+00:00",
  "fxLink": "https://www.qweather.com",
  "isActive": "1",
  "now": {
      "pubTime": "2024-05-30T05:00+08:00",
      "lat": "27.7",
      "lon": "134.5",
      "type": "STS",
      "pressure": "980",
      "windSpeed": "30",
      "moveSpeed": "21",
      "moveDir": "NE",
      "move360": "",
      "windRadius30": {
        "neRadius": "120",
        "seRadius": "150",
        "swRadius": "120",
        "nwRadius": "100"
      },
      "windRadius50": {
        "neRadius": "60",
        "seRadius": "60",
        "swRadius": "60",
        "nwRadius": "50"
      }
    },
  "track": [
    {
      "time": "2024-05-29T17:00+08:00",
      "lat": "26.1",
      "lon": "132.5",
      "type": "TY",
      "pressure": "970",
      "windSpeed": "35",
      "moveSpeed": "28",
      "moveDir": "NE",
      "move360": "",
      "windRadius30": {
        "neRadius": "120",
        "seRadius": "150",
        "swRadius": "120",
        "nwRadius": "100"
      },
      "windRadius50": {
        "neRadius": "60",
        "seRadius": "70",
        "swRadius": "60",
        "nwRadius": "50"
      },
      "windRadius64": {
        "neRadius": "30",
        "seRadius": "30",
        "swRadius": "30",
        "nwRadius": "30"
      }
    },
    {
      "time": "2024-05-29T20:00+08:00",
      "lat": "26.5",
      "lon": "133.2",
      "type": "TY",
      "pressure": "975",
      "windSpeed": "33",
      "moveSpeed": "27",
      "moveDir": "NE",
      "move360": "",
      "windRadius30": {
        "neRadius": "120",
        "seRadius": "150",
        "swRadius": "120",
        "nwRadius": "100"
      },
      "windRadius50": {
        "neRadius": "60",
        "seRadius": "70",
        "swRadius": "60",
        "nwRadius": "50"
      },
      "windRadius64": {
        "neRadius": "30",
        "seRadius": "30",
        "swRadius": "30",
        "nwRadius": "30"
      }
    },
    {
      "time": "2024-05-30T02:00+08:00",
      "lat": "27.1",
      "lon": "133.9",
      "type": "STS",
      "pressure": "980",
      "windSpeed": "30",
      "moveSpeed": "23",
      "moveDir": "NE",
      "move360": "",
      "windRadius30": {
        "neRadius": "120",
        "seRadius": "150",
        "swRadius": "120",
        "nwRadius": "100"
      },
      "windRadius50": {
        "neRadius": "60",
        "seRadius": "70",
        "swRadius": "60",
        "nwRadius": "50"
      }
    }
  ],
  "refer": {
    "sources": [
      "https://developer.qweather.com/attribution.html"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

code

string

状态码
updateTime

date-time

API的最近更新时间
fxLink

uri

当前数据的响应式页面，便于嵌入网站或应用
isActive

string

是否为活跃台风。1 活跃台风，0 停编
now

object

当前台风数据。如台风已结束，该字段可为 null
- pubTime
  
  date-time
  
  原始数据发布时间
- lat
  
  string
  
  台风所处纬度
- lon
  
  string
  
  台风所处经度
- type
  
  string
  
  台风类型
- pressure
  
  string
  
  台风中心气压
- windSpeed
  
  string
  
  台风附近最大风速
- moveSpeed
  
  string
  
  台风移动速度
- moveDir
  
  string
  
  台风移动方位
- move360
  
  string
  
  台风移动方位360度方向
- windRadius30
  
  object
  
  台风7级风圈半径
  - neRadius
    
    string
    
    台风7级风圈东北半径，可能为空
  - seRadius
    
    string
    
    当前台风7级风圈东南半径，可能为空
  - swRadius
    
    string
    
    当前台风7级风圈西南半径，可能为空
  - nwRadius
    
    string
    
    当前台风7级风圈西北半径，可能为空
- windRadius50
  
  object
  
  台风10级风圈半径
  - neRadius
    
    string
    
    台风10级风圈东北半径，可能为空
  - seRadius
    
    string
    
    当前台风10级风圈东南半径，可能为空
  - swRadius
    
    string
    
    当前台风10级风圈西南半径，可能为空
  - nwRadius
    
    string
    
    当前台风10级风圈西北半径，可能为空
- windRadius64
  
  object
  
  台风12级风圈半径
  - neRadius
    
    string
    
    台风12级风圈东北半径，可能为空
  - seRadius
    
    string
    
    当前台风12级风圈东南半径，可能为空
  - swRadius
    
    string
    
    当前台风12级风圈西南半径，可能为空
  - nwRadius
    
    string
    
    当前台风12级风圈西北半径，可能为空
track

array

台风轨迹数据列表
- time
  
  date-time
  
  当前台风信息发布时间
- lat
  
  string
  
  台风所处纬度
- lon
  
  string
  
  台风所处经度
- type
  
  string
  
  台风类型
- pressure
  
  string
  
  台风中心气压
- windSpeed
  
  string
  
  台风附近最大风速
- moveSpeed
  
  string
  
  台风移动速度
- moveDir
  
  string
  
  台风移动方位
- move360
  
  string
  
  台风移动方位360度方向
- windRadius30
  
  object
  
  台风7级风圈半径
  - neRadius
    
    string
    
    台风7级风圈东北半径，可能为空
  - seRadius
    
    string
    
    当前台风7级风圈东南半径，可能为空
  - swRadius
    
    string
    
    当前台风7级风圈西南半径，可能为空
  - nwRadius
    
    string
    
    当前台风7级风圈西北半径，可能为空
- windRadius50
  
  object
  
  台风10级风圈半径
  - neRadius
    
    string
    
    台风10级风圈东北半径，可能为空
  - seRadius
    
    string
    
    当前台风10级风圈东南半径，可能为空
  - swRadius
    
    string
    
    当前台风10级风圈西南半径，可能为空
  - nwRadius
    
    string
    
    当前台风10级风圈西北半径，可能为空
- windRadius64
  
  object
  
  台风12级风圈半径
  - neRadius
    
    string
    
    台风12级风圈东北半径，可能为空
  - seRadius
    
    string
    
    当前台风12级风圈东南半径，可能为空
  - swRadius
    
    string
    
    当前台风12级风圈西南半径，可能为空
  - nwRadius
    
    string
    
    当前台风12级风圈西北半径，可能为空
refer

object

数据来源和许可信息
- sources
  
  array
  
  原始数据来源，或数据源说明，可能为空
- license
  
  array
  
  数据许可或版权声明，可能为空