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.

Warning: 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.

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.

Note: 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.

Supported language

Weather warning may not be available for all languages we support, please refer to the following scenarios:

• Only warning.title, warning.text, warning.typeName support multi-language setting.
• If no language is set, the local language of the query city will be responded to first, or English if the local language does not exist.
• If the language is supported, it responds the set language.
• If the language is not supported, it will response the local language of the query city, or English if the local language is not supported.

Hint: The language of the data may be mixed, e.g. part of the content is in the local language and part in other languages. This case is unusual and cannot be excluded as they are based on the official content published by the respective meteorological services.

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

Hint: 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: Do not use warning.level anymore, this field is currently deprecated and the value will be null or out of date, it will be removed completely in the future. Please 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.

Hint: The name of the warning type may be the same, this is not a bug, for example, almost every meteorological department will issue “wind warning”, but the rules or standards of this warning may be different, please refer to the definition of the meteorological department.

WARNING: Warning types may be added, modified or deleted according to the meteorological authorities, and the names of warning types may change due to translation effects, so we do not recommend storing these warning types to avoid causing errors in your program when warning types are updated.