天气灾害预警

和风天气灾害预警API接口支持全国3240个市县区天气灾害预警,预警类型和级别包括:

  • 预警种类:台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰、寒冷、灰霾、雷雨大风、森林火险、降温、道路冰雪、干热风、低温、冰冻、空气重污染、海上大雾、雷暴大风、持续低温、浓浮尘、龙卷风、低温冻害、海上大风、低温雨雪冰冻、强对流、臭氧、大雪、强降雨、强降温、雪灾、森林(草原)火险、雷暴、严寒、沙尘、海上雷雨大风、海上雷电、海上台风。
  • 预警级别:白色(仅限广东省内)、蓝色、黄色、橙色、红色

灾害预警API可以获取指定城市的极端天气预警数据,也可以获取一个国家内当前发生极端天气的城市列表。

请求URL

  • 商业版https://api.qweather.com/v7/warning/now?[请求参数]
  • 开发版https://devapi.qweather.com/v7/warning/now?[请求参数]

请求参数

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

key

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

location

需要查询地区的LocationID或以英文逗号分隔的经度,纬度坐标(十进制),LocationID可通过城市搜索服务获取。例如 location=101010100location=116.41,39.92

lang

多语言设置,本数据仅支持中文和英文

  • zh 中文, 默认
  • en 英语

返回数据

如果查询的地区当前没有灾害预警信息,返回的warning字段为空。

// 长春灾害预警 
// 商业版:https://api.qweather.com/v7/warning/now?location=101060101&key=你的KEY
// 开发版:https://devapi.qweather.com/v7/warning/now?location=101060101&key=你的KEY

{
  "code": "200",
  "updateTime": "2020-06-21T13:33+08:00",
  "fxLink": "https://www.qweather.com/severe-weather/changchun-101060101.html",
  "warning": [
    {
      "id": "1010601202006202220000501",
      "pubTime": "2020-06-20T22:20+08:00",
      "title": "吉林省长春市气象台发布大风蓝色预警",
      "startTime": "",
      "endTime": "",
      "status": "预警中",
      "level": "蓝色",
      "type": "大风",
      "text": "长春市气象台2020年6月20日22时20分发布大风蓝色预警信号:预计未来24小时内,我市有5-6级西南风,瞬间风力可达7-8级,市应急管理局、市气象局联合提醒,注意做好防范。(预警信息来源:国家预警信息发布中心)"
    }
  ],
  "refer": {
    "sources": [
      "12379",
      "Weather China"
    ],
    "license": [
      "commercial license"
    ]
  }
}
参数 描述
code

API状态码,具体含义请参考状态码

updateTime

当前API的最近更新时间

fxLink

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

warning.id

本条预警的唯一标识,可判断本条预警是否已经存在

warning.sender

预警发布单位,可能为空

warning.pubTime

预警发布时间

warning.title

预警信息标题

warning.startTime

预警开始时间,可能为空

warning.endTime

预警结束时间,可能为空

warning.status

预警状态,可能为空
active 预警中或首次预警
update 预警信息更新
cancel 取消预警

warning.level

预警等级

warning.type

预警类型ID

warning.typeName

预警类型名称

warning.text

预警详细文字描述

warning.related

与本条预警相关联的预警ID,当预警状态为cancel或update时返回。可能为空

refer.sources

原始数据来源,或数据源说明,可能为空

refer.license

数据许可或版权声明,可能为空

预警等级

并非所有预警的最低或最高等级是蓝色或红色,例如霾预警只有黄色和橙色等级

Level LevelId 备注
白色 5 最低等级,仅限广东省
蓝色 4 最低等级
黄色 3  
橙色 2  
红色 1 最高等级

预警类型

预警类型ID和预警类型名称有可能会变更,请以API返回为准

Type TypeName
11B01 台风
11B02 龙卷风
11B03 暴雨
11B04 暴雪
11B05 寒潮
11B06 大风
11B07 沙尘暴
11B08 低温冻害
11B09 高温
11B10 热浪
11B11 干热风
11B12 下击暴流
11B13 雪崩
11B14 雷电
11B15 冰雹
11B16 霜冻
11B17 大雾
11B18 低空风切变
11B19
11B20 雷雨大风
11B21 道路结冰
11B22 干旱
11B23 海上大风
11B24 高温中暑
11B25 森林火险
11B26 草原火险
11B27 冰冻
11B28 空间天气
11B29 重污染
11B30 低温雨雪冰冻
11B31 强对流
11B32 臭氧
11B33 大雪
11B34 寒冷
11B35 连阴雨
11B36 渍涝风险
11B37 地质灾害气象风险
11B38 强降雨
11B39 强降温
11B40 雪灾
11B41 森林(草原)火险
11B42 医疗气象
11B43 雷暴
11B44 停课信号
11B45 停工信号
11B46 海上风险
11B47 春季沙尘天气
11B48 降温
11B49 台风暴雨
11B50 严寒
11B51 沙尘
11B52 海上雷雨大风
11B53 海上大雾
11B54 海上雷电
11B55 海上台风
11B56 低温
11B57 道路冰雪