天气灾害预警

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

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

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

灾害预警

请求URL

商业版 HTTP GET

https://api.qweather.com/v7/warning/now?{请求参数}

开发版 HTTP GET

https://devapi.qweather.com/v7/warning/now?{请求参数}

请求参数

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

location 必选

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

key 必选

用户认证密钥，请参考如何获取你的KEY。支持数字签名方式认证。例如：key=12334567890ABC

gzip 可选

对接口进行压缩，可大幅节省网络消耗、减少接口获取延迟。默认开启gzip。

  • y 使用gzip方式压缩，默认
  • n 不使用压缩

lang 可选

多语言设置，具体的语言参数值请参考多语言参数。默认中文。

返回数据

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

参数 描述 示例值
code API状态码，具体含义请参考状态码 200
updateTime 当前API的最近更新时间 2013-12-30T01:45+08:00
fxLink 该城市的天气预警的自适应网页，可嵌入网站或应用。可能为空。 http://hfx.link/ae45
warning.id 本条预警的唯一标识，可判断本条预警是否已经存在，id有效期不超过72小时 202010110345679813
warning.sender 预警发布单位，可能为空 深圳市气象台
warning.pubTime 预警发布时间 2017-10-25T12:03+08:00
warning.title 预警信息标题 广东省深圳市气象台发布雷电黄色预警
warning.startTime 预警开始时间，可能为空。 2017-10-25T13:12
warning.endTime 预警结束时间，可能为空。 2017-10-26T13:12
warning.status 预警状态，可能为空
active 预警中或首次预警
update 预警信息更新
cancel 取消预警		 active
warning.level 预警等级 黄色
warning.type 预警类型 11B17
warning.typeName 预警等级名称 大雾
warning.text 预警详细文字描述 深圳市气象局于10月04日12时59分发布雷电黄色预警信号，请注意防御。
warning.related 与本条预警相关联的预警ID，当预警状态为cancel或update时返回。可能为空 202010110345679813
refer.sources 原始数据来源，可能为空  
refer.license 数据许可证  

灾害预警城市列表

请求URL

商业版 HTTP GET

https://api.qweather.com/v7/warning/list?{请求参数}

开发版 HTTP GET

https://devapi.qweather.com/v7/warning/list?{请求参数}

请求参数

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

range 必选

选择指定的国家，目前仅支持中国。例如range=cn。

key 必选

用户认证密钥，请参考如何获取你的KEY。支持数字签名方式认证。例如：key=12334567890ABC

gzip 可选

对接口进行压缩，可大幅节省网络消耗、减少接口获取延迟。默认开启gzip。

  • y 使用gzip方式压缩，默认
  • n 不使用压缩

返回数据

参数 描述 示例值
code API状态码，具体含义请参考状态码 200
updateTime 当前API的最近更新时间 2013-12-30T01:45+08:00
warningLocList.locationId 当前国家预警的城市/地区ID 101010100

请求和返回示例

城市灾害预警

// 长春灾害预警 
// 商业版：https://api.qweather.com/v7/warning/now?location=101060101&key=xxx
// 开发版：https://devapi.qweather.com/v7/warning/now?location=101060101&key=xxx
// 请将示例请求URL中的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"
    ]
  }
}

灾害预警城市列表

// 中国灾害预警城市列表 
// 商业版 https://api.qweather.com/v7/warning/list?range=cn&key=xxx
// 开发版 https://devapi.qweather.com/v7/warning/list?range=cn&key=xxx
// 请将示例请求URL中的KEY更换成你自己的KEY

{
  "code": "200",
  "updateTime": "2020-06-21T05:39+00:00",
  "warningLocList": [
    {
      "locationId": "101010800"
    },
    {
      "locationId": "101011200"
    },
    {
      "locationId": "101011400"
    },
    {
      "locationId": "101020700"
    },
    {
      "locationId": "101040400"
    },
    {
      "locationId": "101041900"
    },
    {
      "locationId": "101043400"
    },
    {
      "locationId": "101043600"
    },
    {
      "locationId": "101050106"
    },
    {
      "locationId": "101050107"
    },
    {
      "locationId": "101050301"
    },
    {
      "locationId": "101050302"
    },
    {
      "locationId": "101050303"
    },
    {
      "locationId": "101130103"
    },
    {
      "locationId": "101130109"
    },
    {
      "locationId": "101130114"
    },
    {
      "locationId": "101130302"
    },
    {
      "locationId": "101130303"
    },
    {
      "locationId": "101130409"
    },
    {
      "locationId": "101130610"
    },
    {
      "locationId": "101130611"
    },
    {
      "locationId": "101130613"
    },
    {
      "locationId": "101130614"
    },
    {
      "locationId": "101131920"
    },
    {
      "locationId": "101221008"
    },
    {
      "locationId": "101230507"
    },
    {
      "locationId": "101132101"
    },
    {
      "locationId": "101132201"
    },
    {
      "locationId": "101132301"
    }
  ],
  "refer": {
    "sources": [
      "12379",
      "Weather China"
    ],
    "license": [
      "commercial license"
    ]
  }
}