天气灾害预警

数据介绍

  • 获取当前时间点全国3240个市县区所有灾害预警信息。
  • 预警种类:台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰、寒冷、灰霾、雷雨大风、森林火险、降温、道路冰雪、干热风、低温、冰冻、空气重污染、海上大雾、雷暴大风、持续低温、浓浮尘、龙卷风、低温冻害、海上大风、低温雨雪冰冻、强对流、臭氧、大雪、强降雨、强降温、雪灾、森林(草原)火险、雷暴、严寒、沙尘、海上雷雨大风、海上雷电、海上台风。
  • 预警级别:白色(仅限广东省内)、蓝色、黄色、橙色、红色
  • 更新时间:每15分钟更新一次。
  • 当使用此接口时,会按照返回的预警数量扣除相应的访问量

请求URL

商业版(指定地区):

https://api.heweather.net/s6/alarm?{parameters}

商业版(全部地区):

https://api.heweather.net/s6/alarm/all?{parameters}
  • {parameters}代表请求参数,包括必选和可选参数。所有请求参数均使用 &进行分隔,参数值存在中文或特殊字符的情况,需要对参数进行 url encode

请注意,在替换{parameters}对应值的时候,URL中不要包含大括号{}

请求URL示例

# 获取北京的灾害预警信息
https://api.heweather.net/s6/alarm?location=beijing&key=xxx

请求参数

参数 描述 选择 示例值
lang 多语言,可以不使用该参数,默认为简体中文,海外城市默认为英文
详见多语言参数
可选 lang=en
unit 单位选择,公制(m)或英制(i),默认为公制单位
详见度量衡单位参数
可选 unit=i
key 用户数据key,请参考如何获取你的KEY
支持数字签名方式进行认证,推荐使用
必选 key=xxxxxxxxxxxxxx

数据返回字段和数值说明

basic 基础信息(指定地区)

基础信息包括所查询的城市/地区的一些基本信息,例如名称、ID、经纬度等

参数 描述 示例值
location 地区/城市名称 卓资
cid 地区/城市ID CN101080402
lat 地区/城市纬度 40.89576
lon 地区/城市经度 112.577702
parent_city 该地区/城市的上级城市 乌兰察布
admin_area 该地区/城市所属行政区域 内蒙古
cnty 该地区/城市所属国家名称 中国
tz 该地区/城市所在时区 +8.0

update 接口更新时间

参数 描述 示例值
loc 当地时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 12:34
utc UTC时间,24小时制,格式yyyy-MM-dd HH:mm 2017-10-25 04:34

status 接口状态

参数 描述 示例
status 接口状态,具体含义请参考接口状态码及错误码 ok

alarm 灾害预警(指定地区)

参数 描述 示例
title 预警标题 北京市朝阳区气象台发布大风黄色预警
stat 预警状态 预警中
level 预警等级 黄色
type 预警类型 大风
txt 预警详细信息 朝阳区气象台05日14时30分发布大风黄色预警,预计5日15时至21时,受东移加强的…

alarm_list 灾害预警(全部地区)

参数 描述 示例
cid 地区/城市ID CN101280601
title 预警标题 广东省深圳市气象台发布雷电黄色预警
stat 预警状态 预警中
level 预警等级 黄色
type 预警类型 雷电
txt 预警详细信息 深圳市气象局于10月04日12时59分发布雷电黄色预警信号,请注意防御。

数据返回示例

指定地区

{
	"HeWeather6": [{
		"basic": {
			"cid": "CN101010300",
			"location": "朝阳",
			"parent_city": "北京",
			"admin_area": "北京",
			"cnty": "中国",
			"lat": "39.92148972",
			"lon": "116.48641205",
			"tz": "+8.00"
		},
		"update": {
			"loc": "2018-06-06 09:27",
			"utc": "2019-06-06 01:27"
		},
		"status": "ok",
		"alarm": [{
			"level": "黄色",
			"stat": "预警中",
			"title": "北京市朝阳区气象台发布大风黄色预警",
			"txt": "朝阳区气象台05日14时30分发布大风黄色预警,预计,5日15时至21时,受东移加强的对流云团影响,朝阳区将出现短时大风,局地阵风可达9级左右,请注意防范。(预警信息来源:国家预警信息发布中心)",
			"type": "大风"
		}]
	}]
}

全部地区

{
    "HeWeather6": {
        "alarm_list": [
            {
                "cid": "CN101050110",
                "level": "蓝色",
                "stat": "预警中",
                "title": "黑龙江省哈尔滨市延寿县气象台发布大风蓝色预警",
                "txt": "预计未来24小时内延寿地区将受大风影响,平均风力可达6级以上,或者阵风7级以上。请有关单位和个人注意做好预防工作。\n",
                "type": "大风"
            },
            {
                "cid": "CN101050110",
                "level": "蓝色",
                "stat": "预警中",
                "title": "黑龙江省哈尔滨市气象台发布大风蓝色预警",
                "txt": "哈尔滨市气象台2018年4月16日15:20发布大风蓝色预警信号:预计16日下午至17日白天哈尔滨主城区及各区、县(市)将受大风影响,平均风力4-6级,阵风7-8级,火险等级高,请注意防范。",
                "type": "大风"
            },
            {
                "cid": "CN101050111",
                "level": "蓝色",
                "stat": "预警中",
                "title": "黑龙江省哈尔滨市尚志市气象台发布大风蓝色预警",
                "txt": "尚志市气象局2018年4月16日16时20分发布大风蓝色预警:预计未来24小时尚志地区将受大风影响,平均风力4-5级,阵风可达6-7级。请有关单位和个人注意做好预防工作。",
                "type": "大风"
            },
            {
                "cid": "CN101050111",
                "level": "蓝色",
                "stat": "预警中",
                "title": "黑龙江省哈尔滨市气象台发布大风蓝色预警",
                "txt": "哈尔滨市气象台2018年4月16日15:20发布大风蓝色预警信号:预计16日下午至17日白天哈尔滨主城区及各区、县(市)将受大风影响,平均风力4-6级,阵风7-8级,火险等级高,请注意防范。",
                "type": "大风"
            },
            {
                "cid": "CN101050112",
                "level": "蓝色",
                "stat": "预警中",
                "title": "黑龙江省哈尔滨市五常市气象台发布大风蓝色预警",
                "txt": "五常市气象台4月16日18时40分发布大风蓝色预警信号:预计未来24小时五常地区将受大风影响,平均风力4-6级,阵风7-8级,火险等级高,请注意防范。",
                "type": "大风"
            },
            {
                "cid": "CN101050112",
                "level": "蓝色",
                "stat": "预警中",
                "title": "黑龙江省哈尔滨市气象台发布大风蓝色预警",
                "txt": "哈尔滨市气象台2018年4月16日15:20发布大风蓝色预警信号:预计16日下午至17日白天哈尔滨主城区及各区、县(市)将受大风影响,平均风力4-6级,阵风7-8级,火险等级高,请注意防范。",
                "type": "大风"
            },
            {
                "cid": "CN101050113",
                "level": "蓝色",
                "stat": "预警中",
                "title": "黑龙江省哈尔滨市木兰县气象台发布大风蓝色预警",
                "txt": "木兰县气象台2018年4月16日16时00分发布大风蓝色预警信号:预计16日下午至17日白天我县将受大风影响,平均风力4-6级,阵风7-8级,火险等级高,请注意防范。",
                "type": "大风"
            },
            {
                "cid": "CN101050113",
                "level": "蓝色",
                "stat": "预警中",
                "title": "黑龙江省哈尔滨市气象台发布大风蓝色预警",
                "txt": "哈尔滨市气象台2018年4月16日15:20发布大风蓝色预警信号:预计16日下午至17日白天哈尔滨主城区及各区、县(市)将受大风影响,平均风力4-6级,阵风7-8级,火险等级高,请注意防范。",
                "type": "大风"
            },
            {
                "cid": "CN101050201",
                "level": "蓝色",
                "stat": "预警中",
                "title": "黑龙江省气象台发布大风蓝色预警",
                "txt": " 黑龙江省气象台4月16日15时40分发布大风蓝色预警信号:预计未来24小时齐齐哈尔南部、大庆、绥化、哈尔滨、伊春南部、佳木斯、双鸭山、七台河、鸡西、牡丹江将自西向东逐渐受大风影响,平均风力5级,阵风7级左右,其它地区平均风力3-4级。请有关单位和个人注意做好预防工作。",
                "type": "大风"
            },
            {
                "cid": "CN101050101",
                "level": "蓝色",
                "stat": "预警中",
                "title": "黑龙江省气象台发布大风蓝色预警",
                "txt": " 黑龙江省气象台4月16日15时40分发布大风蓝色预警信号:预计未来24小时齐齐哈尔南部、大庆、绥化、哈尔滨、伊春南部、佳木斯、双鸭山、七台河、鸡西、牡丹江将自西向东逐渐受大风影响,平均风力5级,阵风7级左右,其它地区平均风力3-4级。请有关单位和个人注意做好预防工作。",
                "type": "大风"
            },
            {
                "cid": "CN101290905",
                "level": "黄色",
                "stat": "预警中",
                "title": "云南省普洱市思茅区气象台发布雷电黄色预警",
                "txt": "思茅区气象台2018年4月16日16时25分发布雷电黄色预警信号:预计未来6小时内思茅区将出现雷电活动,局部伴有冰雹、大风等强对流天气,请注意防范。",
                "type": "雷电"
            }
        ],
        "status": "ok",
        "update": {
            "loc": "2018-04-17 10:36",
            "utc": "2018-04-17 02:36"
        }
    }
}