编辑

台风列表

平台: API iOS Android

台风列表API提供全球主要海洋流域最近2年的台风列表。

目前仅支持中国沿海地区，即basin=NP

请求URL 

https://api.qweather.com/v7/tropical/storm-list?{查询参数}

请求参数

请求参数包括必选和可选参数，参数之间使用&进行分隔。

  • 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
  • key(必选)用户认证key，请参考如何获取你的KEY。支持数字签名方式进行认证。例如 key=123456789ABC

请求示例

西北太平洋2020年台风列表

curl -L -X GET --compressed 'https://api.qweather.com/v7/tropical/storm-list?basin=NP&year=2020&key=YOUR_KEY'

返回数据

返回数据是JSON格式并进行了Gzip压缩。

{
  "code": "200",
  "updateTime": "2020-12-31T16:00+00:00",
  "fxLink": "https://www.qweather.com",
  "storm": [
    {
      "id": "NP_2022",
      "name": "环高",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2021",
      "name": "艾涛",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2020",
      "name": "艾莎尼",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2019",
      "name": "天鹅",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2018",
      "name": "莫拉菲",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2017",
      "name": "沙德尔",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_200012",
      "name": "无命名",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2016",
      "name": "浪卡",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2015",
      "name": "莲花",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2014",
      "name": "灿鸿",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2013",
      "name": "鲸鱼",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2012",
      "name": "白海豚",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2011",
      "name": "红霞",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2010",
      "name": "海神",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2009",
      "name": "美莎克",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2008",
      "name": "巴威",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2007",
      "name": "海高斯",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2006",
      "name": "米克拉",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2005",
      "name": "蔷薇",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2004",
      "name": "黑格比",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2003",
      "name": "森拉克",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2002",
      "name": "鹦鹉",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    },
    {
      "id": "NP_2001",
      "name": "黄蜂",
      "basin": "NP",
      "year": "2020",
      "active": "0"
    }
  ],
  "refer": {
    "sources": [
      "NMC"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}
  • code 请参考状态码
  • updateTime 当前API的最近更新时间
  • fxLink 当前数据的响应式页面，便于嵌入网站或应用
  • storm.id 台风ID
  • storm.stormId 台风ID
  • storm.name 台风名称
  • storm.basin 台风所处流域
  • storm.year 台风所处年份
  • storm.isActive 是否为活跃台风。1 活跃台风，0 停编。
  • refer.sources 原始数据来源，或数据源说明，可能为空
  • refer.license 数据许可或版权声明，可能为空