天气灾害预警
天气灾害预警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 |
|
fxLink |
当前数据的响应式页面,便于嵌入网站或应用 |
warning.id |
本条预警的唯一标识,可判断本条预警是否已经存在 |
warning.sender |
预警发布单位,可能为空 |
warning.pubTime |
预警发布时间 |
warning.title |
预警信息标题 |
warning.startTime |
预警开始时间,可能为空 |
warning.endTime |
预警结束时间,可能为空 |
warning.status |
|
warning.level |
预警等级(弃用),该字段已弃用,使用 |
warning.severity |
|
warning.severityColor |
预警严重等级颜色,可能为空 |
warning.type |
|
warning.typeName |
|
warning.urgency |
预警信息的紧迫程度,可能为空 |
warning.certainty |
预警信息的确定性,可能为空 |
warning.text |
预警详细文字描述 |
warning.related |
与本条预警相关联的预警ID,当预警状态为cancel或update时返回。可能为空 |
refer.sources |
原始数据来源,或数据源说明,可能为空 |
refer.license |
数据许可或版权声明,可能为空 |