编辑

天气灾害预警

天气灾害预警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": "蓝色",
      "severity": "Minor",
      "severityColor": "Blue",
      "type": "1006",
      "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`	预警信息的发布状态
`warning.level`	预警等级（弃用），该字段已弃用，使用`severity`和`severityColor`代替
`warning.severity`	预警严重等级
`warning.severityColor`	预警严重等级颜色，可能为空
`warning.type`	预警类型ID
`warning.typeName`	预警类型名称
`warning.urgency`	预警信息的紧迫程度，可能为空
`warning.certainty`	预警信息的确定性，可能为空
`warning.text`	预警详细文字描述
`warning.related`	与本条预警相关联的预警ID，当预警状态为cancel或update时返回。可能为空
`refer.sources`	原始数据来源，或数据源说明，可能为空
`refer.license`	数据许可或版权声明，可能为空

另请参考

天气预警信息