预警信息
和风天气预警服务支持中国及全球多个国家和地区的气象预警服务(API,iOS SDK,Android SDK),这里可以了解我们所支持的预警信息的详细说明,例如支持的国家或地区列表,预警等级和预警类型。
警告:天气预警的等级、类型、紧迫程度等信息有可能发生变化,包括新增、修改或删除,这些变化我们可能无法提前通知到你,因此你需要让你的程序更具有兼容性,避免在发生变化的时候导致错误出现!
我们的建议是不要尝试枚举这些数值,或做其他形式的映射,而是直接输出到屏幕上。
提示:天气预警不一定适用于多语言设置,当一条预警信息无法响应你的多语言设置时,我们会返回英文或当地语言的信息,而且这可能是混合的,即部分内容为英文,另一部分是本地语言。
支持的国家或地区
天气灾害预警并非适用于所有城市,我们将不断的扩展这些数据,目前和风天气预警服务支持的国家或地区如下:
提示:你可以使用
range
参数通过预警城市列表获取该国家的所有预警城市信息。
注意:天气预警基于各国政府部门的官方数据,当官方数据无法正常发布时,我们可能会临时下线遇到问题的国家。
ISO 3166-1 | 国家或地区 |
---|---|
ar | 阿根廷 |
at | 奥地利 |
be | 比利时 |
br | 巴西 |
bg | 保加利亚 |
cn | 中国 |
hr | 克罗地亚 |
cy | 塞浦路斯 |
cz | 捷克 |
dk | 丹麦 |
ee | 爱沙尼亚 |
fi | 芬兰 |
fr | 法国 |
de | 德国 |
gr | 希腊 |
hk | 中国香港 |
hu | 匈牙利 |
is | 冰岛 |
in | 印度 |
ie | 爱尔兰 |
il | 以色列 |
it | 意大利 |
kw | 科威特 |
lv | 拉脱维亚 |
lt | 立陶宛 |
lu | 卢森堡 |
mo | 中国澳门 |
mt | 马耳他 |
md | 摩尔多瓦 |
me | 黑山 |
nl | 荷兰 |
mk | 北马其顿 |
no | 挪威 |
pl | 波兰 |
pt | 葡萄牙 |
ro | 罗马尼亚 |
ru | 俄罗斯 |
rs | 塞尔维亚 |
sk | 斯洛伐克 |
si | 斯洛文尼亚 |
za | 南非 |
es | 西班牙 |
se | 瑞典 |
ch | 瑞士 |
tw | 中国台湾省 |
gb | 英国 |
预警状态
warning.status
代表当前预警信息的发布状态,包括:
- Active - 当前预警处于激活状态
- Update - 当前预警是一次对之前指定预警信息的升级或修改
- Cancel - 由于各种原因取消之前指定预警信息的发布。该状态是一个预保留的值,你目前不能使用这个值去判断预警是否有效。
过期时间
提示:一般预警信息的有效期不会超过48小时,因此如果预警信息中未能提供
warning.endTime
,我们建议将这条预警信息的过期时间设置为从warning.startTime
开始后的24小时(我们也是这样做的)。
你可以根据warning.endTime
来预估一条预警信息的失效时间,或者当你更新数据的时候无法再获取当之前相同ID的预警信息时,代表这一条预警已经过期或失效。
预警等级(已弃用)
warning.level
代表预警信息的等级。
警告:不要再使用
warning.level
,这个字段已弃用,目前返回为空或未更新的值,未来可能会被完全移除。请使用严重等级和严重等级颜色替代。
严重等级
warning.severity
表示预警事件所造成的影响强度。
不同国家和地区对预警严重等级有自己的的定义和规范,在科威特适用于Minor、Moderate、Severe和Extreme。对于巴西,适用于Moderate、Severe和Extreme。对于南非,适用于Minor、Moderate、Extreme和Unknown。对于澳大利亚适用于Cancel、None、Unknown、Standard、Minor、Moderate、Major、Severe和Extreme。对于其他国家适用于Unknown、Minor、Moderate、Severe和Extreme。
目前预警严重等级包括:
- Cancel
- None
- Unknown
- Standard
- Minor
- Moderate
- Major
- Severe
- Extreme
严重等级颜色
对于严重等级,一些国家和地区的预警严重等级习惯采用颜色进行定义,我们将根据当地习惯提供严重等级所适用的颜色。
注意:如果当地没有更适合的颜色,则返回为空。
目前预警严重等级颜色包括:
- White
- Blue
- Green
- Yellow
- Orange
- Red
- Black
紧迫程度
注意:这个字段在一些国家和地区不可用,或者与所列出的值不尽相同。
warning.urgency
表示预警信息的紧迫性,包括:
- Immediate
- Expected
- Future
- Past
- Unknown
确定性
注意:这个字段在一些国家和地区不可用,或者与所列出的值不尽相同。
warning.certainty
表示预警信息的确定性或可信度,包括:
- Observed
- Likely
- Possible
- Unlikely
- Unknown
预警类型
和风天气根据各国官方气象部门的定义,提供了超过100种预警类型,这些类型并非适用于所有国家或地区。
我们也根据预警类型制作了对应的图标,请参考和风天气图标。
Type | TypeName |
---|---|
1001 | 台风 |
1002 | 龙卷风 |
1003 | 暴雨 |
1004 | 暴雪 |
1005 | 寒潮 |
1006 | 大风 |
1007 | 沙尘暴 |
1008 | 低温冻害 |
1009 | 高温 |
1010 | 热浪 |
1011 | 干热风 |
1012 | 下击暴流 |
1013 | 雪崩 |
1014 | 雷电 |
1015 | 冰雹 |
1016 | 霜冻 |
1017 | 大雾 |
1018 | 低空风切变 |
1019 | 霾 |
1020 | 雷雨大风 |
1021 | 道路结冰 |
1022 | 干旱 |
1023 | 海上大风 |
1024 | 高温中暑 |
1025 | 森林火险 |
1026 | 草原火险 |
1027 | 冰冻 |
1028 | 空间天气 |
1029 | 重污染 |
1030 | 低温雨雪冰冻 |
1031 | 强对流 |
1032 | 臭氧 |
1033 | 大雪 |
1034 | 寒冷 |
1035 | 连阴雨 |
1036 | 渍涝风险 |
1037 | 地质灾害气象风险 |
1038 | 强降雨 |
1039 | 强降温 |
1040 | 雪灾 |
1041 | 森林(草原)火险 |
1042 | 医疗气象 |
1043 | 雷暴 |
1044 | 停课信号 |
1045 | 停工信号 |
1046 | 海上风险 |
1047 | 春季沙尘天气 |
1048 | 降温 |
1049 | 台风暴雨 |
1050 | 严寒 |
1051 | 沙尘 |
1052 | 海上雷雨大风 |
1053 | 海上大雾 |
1054 | 海上雷电 |
1055 | 海上台风 |
1056 | 低温 |
1057 | 道路冰雪 |
1058 | 雷暴大风 |
1059 | 持续低温 |
1060 | 能见度不良 |
1061 | 浓浮沉 |
1062 | 海区大风 |
1063 | 短历时强降水 |
1064 | 短时强降雨 |
1065 | 海区大雾 |
1066 | 中暑气象条件 |
1067 | 重污染天气 |
1068 | 一氧化碳中毒气象条件 |
1069 | 感冒等呼吸道疾病气象条件 |
1071 | 腹泻等肠道疾病气象条件 |
1072 | 心脑血管疾病气象条件 |
1073 | 洪涝灾害气象风险 |
1074 | 重污染气象条件 |
1075 | 城市内涝气象风险 |
1076 | 洪水灾害气象风险 |
1077 | 森林火险气象风险 |
1078 | 气象干旱 |
1079 | 农业气象风险 |
1080 | 强季风 |
1081 | 电线积冰 |
1082 | 脑卒中气象风险 |
1084 | 森林(草原)火灾气象风险 |
1085 | 雷雨强风 |
1086 | 低温凝冻 |
1087 | 低温冷害 |
1088 | 全国农业气象灾害风险 |
1089 | 冬小麦干热风灾害风险预警 |
1101 | 洪水 |
1302 | 泥石流 |
1402 | 风暴潮 |
1601 | 炎热 |
1602 | 强烈季风信号 |
1603 | 山泥倾泻 |
1604 | 热带气旋 |
1605 | 火灾危险 |
1606 | 新界北部水浸特别报告 |
1607 | 寒冷天气 |
1701 | 低温特报 |
1702 | 陆上强风 |
1703 | 降雨特报 |
2001 | 大风 |
2002 | 强降雪和结冰 |
2003 | 大雾 |
2004 | 海岸风险 |
2005 | 森林火险 |
2006 | 雨 |
2007 | 大雨洪水 |
2008 | 冻雨和结冰 |
2009 | 地面霜 |
2010 | 扬尘风 |
2011 | 强地面风 |
2012 | 炎热 |
2013 | 夜间炎热 |
2014 | 寒冷 |
2015 | 雷暴和闪电 |
2016 | 冰雹风暴 |
2017 | 海况风险 |
2018 | 渔业风险 |
2019 | 低湿度 |
2020 | 累计降水风险 |
2021 | 冲浪风险 |
2022 | 海上大风 |
2023 | 道路天气风险 |
2024 | 雷雨 |
2025 | 雷雨大雾 |
2026 | 破坏性大风 |
2027 | 草原火灾条件 |
2028 | 天气预警建议 |
2052 | 大雪 |
2053 | Zonda Wind |
2054 | 风暴 |
9998 | 天气预警 |
9999 | 其他 |