天气灾害预警
天气灾害预警API可以获取中国及全球多个国家或地区官方发布的实时天气灾害预警数据。
提示:天气预警有较多规则和需要注意的事项,在开始使用天气预警之前,你应该先阅读预警信息
请求URL
https://api.qweather.com/v7/warning/now?[请求参数]
如果是免费订阅,将上述API Host更改为devapi.qweather.com
。参考免费订阅可用的数据。
请求参数
请求参数包括必选和可选参数,参数之间使用&
进行分隔。
-
key
(必选)用户认证key,请参考如何获取你的KEY。支持数字签名方式进行认证。例如key=123456789ABC
-
location
(必选)需要查询地区的LocationID或以英文逗号分隔的经度,纬度坐标(十进制,最多支持小数点后两位),LocationID可通过城市搜索服务获取。例如location=101010100
或location=116.41,39.92
-
lang
多语言设置,本数据仅支持中文和英文,可选值是lang=zh
和lang=en
请求示例
厦门市预警
curl -L -X GET --compressed 'https://api.qweather.com/v7/warning/now?location=101230201&lang=en&key=YOUR_KEY'
返回数据
返回数据是JSON格式并进行了Gzip压缩,数据类型均为字符串。
{
"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"
]
}
}
注意:如果查询的地区当前没有灾害预警信息,返回的
warning
字段为空。
-
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
数据许可或版权声明,可能为空