和风天气灾害预警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"
]
}
}