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 respond 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
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.

Warning: As of January 1, 2022, the API will use Type instead of Type (deprecated) return, so please update it.

Type Type (deprecated) TypeName
1001 11B01 Typhoon
1002 11B02 Tornado
1003 11B03 Rainstorm
1004 11B04 Snow Storm
1005 11B05 Cold Wave
1006 11B06 Gale
1007 11B07 Sandstorm
1008 11B08 Low Temperature Freeze
1009 11B09 High Temperature
1010 11B10 Heat Wave
1011 11B11 Dry Hot Air
1012 11B12 Downburst
1013 11B13 Avalanche
1014 11B14 Lightning
1015 11B15 Hail
1016 11B16 Frost
1017 11B17 Heavy Fog
1018 11B18 Low-Level Wind Shearl
1019 11B19 Haze
1020 11B20 Thunder Gust
1021 11B21 Road Icing
1022 11B22 Drought
1023 11B23 Gale at Sea
1024 11B24 Heat Stroke
1025 11B25 Wildfire
1026 11B26 Grassland Fire
1027 11B27 Freeze
1028 11B28 Space Weather
1029 11B29 Heavy Air Pollution
1030 11B30 Low Temperature Rain and Snow
1031 11B31 Strong Convection
1032 11B32 Ozone
1033 11B33 Heavy Snow
1034 11B34 Cold
1035 11B35 Continuous Rain
1036 11B36 Waterlogging
1037 11B37 Geological Hazard
1038 11B38 Heavy Rainfall
1039 11B39 Severely Falling Temperature
1040 11B40 Snow Disaster
1041 11B41 Wildfire (Grassland)
1042 11B42 Medical Meteorology
1043 11B43 Thunderstorm
1044 11B44 School Closure
1045 11B45 Factory Closure
1046 11B46 Maritime Risk
1047 11B47 Spring Dust
1048 11B48 Falling Temperature
1049 11B49 Typhoon and Rainstorm
1050 11B50 Severe Cold
1051 11B51 Sand Dust
1052 11B52 Sea Thunderstorms
1053 11B53 Sea Fog
1054 11B54 Sea Thunder
1055 11B55 Sea Typhoon
1056 11B56 Low Temperature
1057 11B57 Road Ice and Snow
1058 11B58 Thunderstorm and Gale
1059 11B59 Continuous Low Temperature
1061 11B61 Strong Dust
1064 11B64 Short-lived Heavy Shower Rain
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
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 11B99 Other