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 |
---|---|
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 fromwarning.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 (Severity)
Every country and region may have its own definitions or protocols for weather warning levels(severity) and not all warning messages have every level, for example, haze warnings are only available in Yellow(Moderate) and Orange(Severe).
Color
For some countries and regions, weather warning levels are usually defined by colors. For mainland China, White (Guangdong Province only), Blue, Yellow, Orange and Red are used. For Hong Kong(SAR China), Yellow, Red and Black are used. For Macau(SAR China), Blue, Yellow, Orange, Red and Black are used. For Russia, White, Green, Yellow, Orange and Red are uesed. For India and European region, Green, Yellow, Orange and Red are available.
In general, the darker the color, the higher the severity of the warning. Currently available colors include:
- White
- Blue
- Green
- Yellow
- Orange
- Red
- Black
Text
For some countries and regions, weather warning levels are usually defined by text. 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 text includes:
- Cancel
- None
- Unknown
- Standard
- Minor
- Moderate
- Major
- Severe
- Extreme
Color vs Text
Both color and text can indicate the severity of the warning message, and generally they can be mapped to each other(it is not a rule or standard, just our practice):
Color | Text |
---|---|
White | Unknown |
Blue | Minor |
Yellow | Moderate |
Orange | Severe |
Red | Extreme |
Urgency
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
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.
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 | |
9998 | Severe Weather Warning | |
9999 | 11B99 | Other |