预警信息

和风天气预警服务支持中国及全球多个国家和地区的气象预警服务(APIiOS SDKAndroid 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 瑞士
gb 英国

预警状态

warning.status 代表当前预警信息的发布状态,包括:

  • Active - 当前预警处于激活状态
  • Update - 当前预警是一次对之前指定预警信息的升级或修改
  • Cancel - 由于各种原因取消之前指定预警信息的发布。该状态是一个预保留的值,你目前不能使用这个值去判断预警是否有效。

过期时间

一般预警信息的有效期不会超过48小时,因此如果预警信息中未能提供warning.endTime,我们建议将这条预警信息的过期时间设置为从warning.startTime开始后的24小时(我们也是这样做的)。

你可以根据warning.endTime来预估一条预警信息的失效时间,或者当你更新数据的时候无法再获取当之前相同ID的预警信息时,代表这一条预警已经过期或失效。

预警等级(弃用)

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(弃用)版将在2021年12月31日不再返回,而采用新的Type名称,请及时更新。

Type Type(弃用) TypeName
1001 11B01 台风
1002 11B02 龙卷风
1003 11B03 暴雨
1004 11B04 暴雪
1005 11B05 寒潮
1006 11B06 大风
1007 11B07 沙尘暴
1008 11B08 低温冻害
1009 11B09 高温
1010 11B10 热浪
1011 11B11 干热风
1012 11B12 下击暴流
1013 11B13 雪崩
1014 11B14 雷电
1015 11B15 冰雹
1016 11B16 霜冻
1017 11B17 大雾
1018 11B18 低空风切变
1019 11B19
1020 11B20 雷雨大风
1021 11B21 道路结冰
1022 11B22 干旱
1023 11B23 海上大风
1024 11B24 高温中暑
1025 11B25 森林火险
1026 11B26 草原火险
1027 11B27 冰冻
1028 11B28 空间天气
1029 11B29 重污染
1030 11B30 低温雨雪冰冻
1031 11B31 强对流
1032 11B32 臭氧
1033 11B33 大雪
1034 11B34 寒冷
1035 11B35 连阴雨
1036 11B36 渍涝风险
1037 11B37 地质灾害气象风险
1038 11B38 强降雨
1039 11B39 强降温
1040 11B40 雪灾
1041 11B41 森林(草原)火险
1042 11B42 医疗气象
1043 11B43 雷暴
1044 11B44 停课信号
1045 11B45 停工信号
1046 11B46 海上风险
1047 11B47 春季沙尘天气
1048 11B48 降温
1049 11B49 台风暴雨
1050 11B50 严寒
1051 11B51 沙尘
1052 11B52 海上雷雨大风
1053 11B53 海上大雾
1054 11B54 海上雷电
1055 11B55 海上台风
1056 11B56 低温
1057 11B57 道路冰雪
1058 11B58 雷暴大风
1059 11B59 持续低温
1061 11B61 浓浮沉
1064 11B64 短时强降雨
1101 洪水
1302 泥石流
1402 风暴潮
1601 炎热
1602 强烈季风信号
1603 山泥倾泻
1604 热带气旋
1605 火灾危险
1606 新界北部水浸特别报告
1607 寒冷天气
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 11B99 其他