Warning Info

QWeather supports weather warning services(API, iOS SDK, Android SDK) for many countries or regions around the world. You can find more descriptions of these warnings here, such as the list of supported countries and regions, warning levels and warning types.

All warning level, type, urgency and other fields are possible to change, including add/modify/delete. We may not be able to give advance notice of these changes, so you have to make your code more compatible to avoid errors when they happen.

We recommend not trying to enumerate these values or mappings, but to output them directly to the screen.

Weather warning do not always work with multilingual setting. When a warning message does not response to your multilingual setting, we will return the message in either English or the local language, or even part of the content in English and part in the local language.

Supported Regions

Weather warnings are not available for all cities, we will continue to expand these data, currently QWeather supports the following countries or regions.

Weather warning are based on official data from government departments in each country. When official data is not released properly, we may temporarily take offline the country where the failure occurred.

You can use the range parameter to get a list of all warning cities for that country or regions via Warning City List API.

ISO 3166-1 Countries or Regions
ar Argentina
at Austria
be Belgium
br Brazil
bg Bulgaria
cn China
hr Croatia
cy Cyprus
cz Czechia
dk Denmark
ee Estonia
fi Finland
fr France
de Germany
gr Greece
hk Hong Kong
hu Hungary
is Iceland
in India
ie Ireland
il Israel
it Italy
kw Kuwait
lv Latvia
lt Lithuania
lu Luxembourg
mo Macao
mt Malta
md Moldova (Republic of)
me Montenegro
nl Netherlands
mk North Macedonia
no Norway
pl Poland
pt Portugal
ro Romania
ru Russian Federation
rs Serbia
sk Slovakia
si Slovenia
za South Africa
es Spain
se Sweden
ch Switzerland
tw Taiwan, Province of China
gb United Kingdom of Great Britain and Northern Ireland

Status

warning.status denotes the status of the current warning published, including:

  • Active - Warning is active
  • Update - The current warning is an update or modification to a previously specified warning.
  • Cancel - The previously specified warning is cancelled for various reasons. This is a reserved value and you cannot use it to determine if the warning is active.

Expiry time

Typically, a warning message is not valid for more than 48 hours, so if warning.endTime is not available, we recommend to set the expiry time of this warning message to 24 hours from warning.startTime (which is what we do).

You can use warning.endTime to estimate when a warning message will expire, or when you can no longer get a warning message with the same ID as the previous one, which means that the warning has expired.

Level (deprecated)

warning.level represents the level of the warning information.

Warning: This field is currently deprecated, replaced with severity and severity color.

Severity

warning.severity indicates the intensity of the impact caused by the warning event.

Every country and region may have its own definitions or protocols for warning severity. For Kuwait, Minor, Moderate, Severe and Extreme are used. For Brazil, Moderate, Severe and Extreme are applied. For South Africa, Minor, Moderate, Extreme and Unknown are applied. For Australia, Cancel, None, Unknown, Standard, Minor, Moderate, Major, Severe and Extreme are applied. For other countries and regions, Unknown, Minor, Moderate, Severe and Extreme are available.

Currently available severity includes:

  • Cancel
  • None
  • Unknown
  • Standard
  • Minor
  • Moderate
  • Major
  • Severe
  • Extreme

Severity color

Some countries and regions prefer to define the severity by color, and we will provide the preferred color for the severity according to the local practice.

Note: May be null if there is no local preferred color.

Currently available colors are:

  • White
  • Blue
  • Green
  • Yellow
  • Orange
  • Red
  • Black

Urgency

Note: warning.urgency is not available in some countries and regions, or does not have the same value as listed below

warning.urgency denotes the urgency of the warning message, including:

  • Immediate
  • Expected
  • Future
  • Past
  • Unknown

Certainty

Note: warning.certainty is not available in some countries and regions, or does not have the same value as listed below

warning.certainty denotes the certainty or confidence level of the warning messages, including:

  • Observed
  • Likely
  • Possible
  • Unlikely
  • Unknown

Warning Type

QWeather provides over 100 warning types based on definitions from official meteorological departments around the world, however, these types are not available to all countries or regions.

We also provide warning icons, please go to QWeather Icons.

Type TypeName
1001 Typhoon
1002 Tornado
1003 Rainstorm
1004 Snow Storm
1005 Cold Wave
1006 Gale
1007 Sandstorm
1008 Low Temperature Freeze
1009 High Temperature
1010 Heat Wave
1011 Dry Hot Air
1012 Downburst
1013 Avalanche
1014 Lightning
1015 Hail
1016 Frost
1017 Heavy Fog
1018 Low-Level Wind Shearl
1019 Haze
1020 Thunder Gust
1021 Road Icing
1022 Drought
1023 Gale at Sea
1024 Heat Stroke
1025 Wildfire
1026 Grassland Fire
1027 Freeze
1028 Space Weather
1029 Heavy Air Pollution
1030 Low Temperature Rain and Snow
1031 Strong Convection
1032 Ozone
1033 Heavy Snow
1034 Cold
1035 Continuous Rain
1036 Waterlogging
1037 Geological Hazard
1038 Heavy Rainfall
1039 Severely Falling Temperature
1040 Snow Disaster
1041 Wildfire (Grassland)
1042 Medical Meteorology
1043 Thunderstorm
1044 School Closure
1045 Factory Closure
1046 Maritime Risk
1047 Spring Dust
1048 Falling Temperature
1049 Typhoon and Rainstorm
1050 Severe Cold
1051 Sand Dust
1052 Sea Thunderstorms
1053 Sea Fog
1054 Sea Thunder
1055 Sea Typhoon
1056 Low Temperature
1057 Road Ice and Snow
1058 Thunderstorm and Gale
1059 Continuous Low Temperature
1060 Low Visibility
1061 Strong Dust
1062 Gale at Sea
1063 Short Duration Heavy Precipitation
1064 Short-lived Heavy Shower Rain
1065 Sea Fog
1066 Heat Stroke Conditions
1067 Heavy Pollution Weather
1068 CO Poisoning Weather Conditions
1069 Respiratory Disease Weather Conditions
1071 Intestinal Diseases Weather Conditions
1072 Cardiovascular Diseases Weather Conditions
1073 Flooding Weather Risk
1074 Heavy Pollution Weather Conditions
1075 Urban Flooding Weather Risk
1076 Flooding Weather Risk
1077 Wildfire Weather Risk
1078 Meteorological Drought
1079 Agricultural Weather Risk
1080 Strong Monsoon
1081 Ice Accretion on Wires
1082 Stroke Weather Risk
1084 Wildfire (Grassland) Risk
1085 Thunderstorms and strong winds
1086 Low Temperature Freeze
1087 Low Temperature Damage
1088 National Agricultural Meteorological Risk
1089 Dry Hot Winds Risk for Winter Wheat
1101 Flood
1302 Mudflow
1402 Storm Surge
1601 Very Hot Weather
1602 Strong Monsoon Signal
1603 Landslip
1604 Tropical Cyclone
1605 Fire Danger
1606 Special Announcement on Flooding in the northern New Territories
1607 Cold Weather
1701 Cold Surge Advisory
1702 Strong Wind Advisory
1703 Rainfall Advisory
2001 Wind
2002 Snow-ice
2003 Fog
2004 Coastal Event
2005 Forest Fire
2006 Rain
2007 Rain-flood
2008 Freezing rain, icing
2009 Ground Frost
2010 Dust Raising Winds
2011 Strong Surface Winds
2012 Hot Day
2013 Warm Night
2014 Cold Day
2015 Thunderstorm and Lightning
2016 Hailstorm
2017 Sea area warning
2018 Fishermen warning
2019 Low Humidity
2020 Accumulated Rain
2021 Hazardous Surf Warning
2022 Marine Wind Warning
2023 Road Weather Alert
2024 Thunder Rain
2025 Thunder rain and Fog
2026 Damaging Winds
2027 Veld Fire Conditions
2028 Weather Advisory
2052 Snow
2053 Zonda Wind
2054 Storm
9998 Severe Weather Warning
9999 Other