天气灾害预警

天气灾害预警API可以获取中国及全球多个国家或地区实时天气灾害预警数据，了解更多预警信息。

你也可以先通过天气预警城市列表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=101010100 或 location=116.41,39.92

天气预警并非在所有地区可用，了解天气预警支持的国家或地区。

lang

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

  • zh 中文, 默认
  • en 英语

返回数据

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

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

{
  "code": "200",
  "updateTime": "2021-10-10T12:20+08:00",
  "fxLink": "http://hfx.link/2ax5",
  "warning": [
    {
      "id": "10101010020211009154607668935939",
      "sender": "北京市气象局",
      "pubTime": "2021-10-09T15:46+08:00",
      "title": "北京市气象台2021年10月09日15时40分发布大风蓝色预警信号",
      "startTime": "2021-10-09T15:40+08:00",
      "endTime": "2021-10-10T15:40+08:00",
      "status": "active",
      "level": "蓝色",
      "type": "11B06",
      "typeName": "大风",
      "text": "市气象台2021年10月9日15时40分发布大风蓝色预警信号：预计，9日22时至10日19时，本市大部分地区有4级左右偏北风，阵风6、7级，山区阵风可达8级左右，请注意防范。",
      "related": ""
    }
  ],
  "refer": {
    "sources": [
      "12379"
    ],
    "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

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

更多预警资料