General Weather State

Weather Symbol | Weather Code | Weather Text | Visibility | Runway Visual Range | Dew or Rime | Fog | Icing Potential | Interval Values of Icing Potential | Slippery Road | Planetary Boundary Layer Height | Snow Line | Freezing Level | Stratospheric Polar Vortex | Power Line Oscillation Warning | Soaring Index | Leisure Indices | Laundry Index | Cold Index | Probability for Snow Cover | Windshield Icing | Aerodrome Approach Index

Weather symbol

The weather symbol is the easiest way to query an overview of the weather state.

weather_symbol_<interval>:idx

Available intervals: 20min, 30min, 1h, 3h, 6h, 12h, 24h

Example:

Show the weather symbols for the next 5 days. A table with the different symbols and their meaning can be viewed below:
https://api.meteomatics.com/2024-04-24T00:00:00Z--2024-04-29T00:00:00Z:PT1H/weather_symbol_1h:idx/50,10/xml

Weather symbol example xml

Symbol Id (Day)Symbol Id (Night)Description
0
0
A weather symbol could not be determined
1
101
Clear sky
2
102
Light clouds
3
103
Partly cloudy
4
104
Cloudy
5
105
Rain
6
106
Rain and snow / sleet
7
107
Snow
8
108
Rain shower
9
109
Snow shower
10
110
Sleet shower
11
111
Light Fog
12
112
Dense fog
13
113
Freezing rain
14
114
Thunderstorms
15
115
Drizzle
16
116
Sandstorm

An archive containing all weather symbols above can be found here.

Weather Code

Weather code according to the present weather code 4677 of the international WMO Standard1 (mean for 1h, 3h, 6h, 12h, 24h)

weather_code_<interval>:idx

Available intervals: 1h, 3h, 6h, 12h, 24h

  • Meaning of Code: 00 - 19, 20 - 29, 30 - 39, 40 - 49, 50 - 59, 60 - 69, 70 - 79, 80 - 99

    CodeMeaningAdditional Information
    00 - 19No precipitation, fog, ice fog (except for 11 and 12), duststorm, sandstorm, drifting or blowing snow
    00Cloud development not observed or not observableCharacteristic change of the state of sky during the past hour
    01Clouds generally dissolving or becoming less developedCharacteristic change of the state of sky during the past hour
    02State of sky on the whole unchangedCharacteristic change of the state of sky during the past hour
    03Clouds generally forming or developingCharacteristic change of the state of sky during the past hour
    04Visibility reduced by smoke, e.g. veldt or forest fires, industrial smoke or volcanic ashes
    05Haze
    06Widespread dust in suspension in the air, not raised by wind at or near the station at the time of observation
    07Dust or sand raised by wind at or near the station at the time of observation, but no well developed dust whirl(s) or sand whirl(s), and no duststorm or sandstorm seen
    08Well developed dust whirl(s) or sand whirl(s) seen at or near the station during the preceding hour or at the time ot observation, but no duststorm or sandstorm
    09Duststorm or sandstorm within sight at the time of observation, or at the station during the preceding hour
    10Mist
    11PatchesShallow fog or ice fog at the station, whether on land or sea, not deeper than about 2 metres on land or 10 metres at sea
    12More or less continuousShallow fog or ice fog at the station, whether on land or sea, not deeper than about 2 metres on land or 10 metres at sea
    13Lightning visible, no thunder heard
    14Precipitation within sight, not reaching the ground or the surface of the sea
    15Precipitation within sight, reaching the ground or the surface of the sea, but distant, i.e. estimated to be more than 5 km from the station
    16Precipitation within sight, reaching the ground or the surface of the sea, near to, but not at the station
    17Thunderstorm, but no precipitation at the time of observation
    18SquallsAt or within sight of the station during the preceding hour or at the time of observation
    19Funnel cloud(s)At or within sight of the station during the preceding hour or at the time of observation
    20 - 29Precipitation, fog, ice fog or thunderstorm at the station during the preceding hour
    20Drizzle (not freezing) or snow grainsNot falling as shower(s)
    21Rain (not freezing)Not falling as shower(s)
    22SnowNot falling as shower(s)
    23Rain and snow or ice pelletsNot falling as shower(s)
    24Freezing drizzle or freezing rainNot falling as shower(s)
    25Shower(s) of rain
    26Shower(s) of snow, or of rain and snow
    27Shower(s) of hail, or of rain and hail
    28Fog or ice fog
    29Thunderstorm (with or without precipitation)
    30 - 39Duststorm, sandstorm, drifting or blowing snow
    30Slight or moderate duststorm or sandstormHas decreased during the preceding hour
    31Slight or moderate duststorm or sandstormNo appreciable change during the preceding hour
    32Slight or moderate duststorm or sandstormHas begun or has increased during the preceding hour
    33Severe duststorm or sandstormHas decreased during the preceding hour
    34Severe duststorm or sandstormNo appreciable change during the preceding hour
    35Severe duststorm or sandstormHas begun or has increased during the preceding hour
    36Slight or moderate blowing snowGenerally low (below eye level)
    37Heavy drifting snowGenerally low (below eye level)
    38Slight or moderate blowing snowGenerally high (above eye level)
    39Heavy drifting snowGenerally high (above eye level)
    40 - 49Fog or ice fog at the time of observation
    40Fog or ice fog at a distance at the time of observation, but not at the station during the preceding hour, the fog or ice fog extending to a level above that of the observer
    41Fog or ice fog in patches
    42Fog or ice fog, sky visibleHas become thinner during the preceding hour
    43Fog or ice fog, sky invisibleHas become thinner during the preceding hour
    44Fog or ice fog, sky visibleNo appreciable change during the preceding hour
    45Fog or ice fog, sky invisibleNo appreciable change during the preceding hour
    46Fog or ice fog, sky visibleHas begun or has become thicker during the preceding hour
    47Fog or ice fog, sky invisibleHas begun or has become thicker during the preceding hour
    48Fog, depositing rime, sky visible
    49Fog, depositing rime, sky invisible
    50 - 59Drizzle at the station at the time of observation
    50Drizzle, not freezing, intermittentSlight at time of observation
    51Drizzle, not freezing, continuousSlight at time of observation
    52Drizzle, not freezing, intermittentModerate at time of observation
    53Drizzle, not freezing, continuousModerate at time of observation
    54Drizzle, not freezing, intermittentHeavy (dense) at time of observation
    55Drizzle, not freezing, continuousHeavy (dense) at time of observation
    56Drizzle, freezing, slight
    57Drizzle, freezing, moderate or heavy (dence)
    58Drizzle and rain, slight
    59Drizzle and rain, moderate or heavy
    60 - 69Rain at the station at the time of observation
    60Rain, not freezing, intermittentSlight at time of observation
    61Rain, not freezing, continuousSlight at time of observation
    62Rain, not freezing, intermittentModerate at time of observation
    63Rain, not freezing, continuousModerate at time of observation
    64Rain, not freezing, intermittentHeavy at time of observation
    65Rain, not freezing, continuousHeavy at time of observation
    66Rain, freezing, slight
    67Rain, freezing, moderate or heavy (dence)
    68Rain or drizzle and snow, slight
    69Rain or drizzle and snow, moderate or heavy
    70 - 79Solid precipitation not in showers at the station at the time of observation
    70Intermittent fall of snowflakesSlight at time of observation
    71Continuous fall of snowflakesSlight at time of observation
    72Intermittent fall of snowflakesModerate at time of observation
    73Continuous fall of snowflakesModerate at time of observation
    74Intermittent fall of snowflakesHeavy at time of observation
    75Continuous fall of snowflakesHeavy at time of observation
    76Diamond dust (with or without fog)
    77Snow grains (with or without fog)
    78Isolated star-like snow crystals (with or without fog)
    79Ice pellets
    80 - 99Showery precipitation, or precipitation with current or recent thunderstorm at the station at the time of observation
    80Rain shower(s), slight
    81Rain shower(s), moderate or heavy
    82Rain shower(s), violent
    83Shower(s) of rain and snow mixed, slight
    84Shower(s) of rain and snow mixed, moderate or heavy
    85Snow shower(s), slight
    86Snow shower(s), moderate or heavy
    87Shower(s) of snow pellets or small hail, with or without rain or rain and snow mixedSlight
    88Shower(s) of snow pellets or small hail, with or without rain or rain and snow mixedModerate or heavy
    89Shower(s) of hail, with or without rain or rain and snow mixed, not associated with thunderSlight
    90Shower(s) of hail, with or without rain or rain and snow mixed, not associated with thunderModerate or heavy
    91Slight rain at time of observationThunderstorm during the preceding hour but not at time of observation
    92Moderate or heavy rain at time of observationThunderstorm during the preceding hour but not at time of observation
    93Slight snow, or rain and snow mixed or hail at time of observationThunderstorm during the preceding hour but not at time of observation
    94Moderate or heavy snow, or rain and snow mixed or hail at time of observationThunderstorm during the preceding hour but not at time of observation
    95Thunderstorm, slight or moderate, without hail but with rain and/or snow at time of observationThunderstorm at time of observation
    96Thunderstorm, slight or moderate, with hail at time of observationThunderstorm at time of observation
    97Thunderstorm, heavy, without hail but with rain and/or snow at time of observationThunderstorm at time of observation
    98Thunderstorm combined with duststorm or sandstorm at time of observationThunderstorm at time of observation
    99Thunderstorm, heavy, with hail at time of observationThunderstorm at time of observation
  • Corresponding symbols to weather codes:

    Ww codes
  • Weather codes from 100 - 199 correspond to the weather codes 00 - 99 of the code 4680 of the international WMO Standard for present weather reported from an automatic weather station (mean for 1h, 3h, 6h, 12h, 24h).

    Meaning of Code: 100 - 119, 120 - 129, 130 - 139, 140 - 149, 150 - 159, 160 - 169, 170 - 179, 180 - 189, 190 - 199

    CodeMeaningAdditional Information
    100 - 119No precipitation, clouds, haze, smoke, dust, mist
    100No significant weather observed
    101Clouds generally dissolving or becoming less developedCharacteristic change of the state of sky during the past hour
    102State of sky on the whole unchangedCharacteristic change of the state of sky during the past hour
    103Clouds generally forming or developingCharacteristic change of the state of sky during the past hour
    104Haze or smoke, or dust in suspension in the air, visibility >= 1 km
    105Haze or smoke, or dust in suspension in the air, visibility < 1 km
    106 - 109Reserved
    110Mist
    111Diamond dust
    112Distant lightning
    113 - 117Reserved
    118Squalls
    119Reserved
    120 - 129Precipitation, fog or thunderstorm at the station during the preceding hour
    120FogReported at the station during the preceding hour but not at the time of observation
    121PRECIPITATIONReported at the station during the preceding hour but not at the time of observation
    122Drizzle (not freezing) or snow grainsReported at the station during the preceding hour but not at the time of observation
    123Rain (not freezing)Reported at the station during the preceding hour but not at the time of observation
    124SnowReported at the station during the preceding hour but not at the time of observation
    125Freezing drizzle or freezing rainReported at the station during the preceding hour but not at the time of observation
    126Thunderstorm (with or without precipitation)Reported at the station during the preceding hour but not at the time of observation
    127BLOWING OR DRIFTING SNOW OR SAND
    128Blowing or drifting snow or sand, visibility >= 1 km
    129Blowing or drifting snow or sand, visibility < 1 km
    130 - 139Fog or ice fog
    130FOG
    131Fog or ice fogIn patches
    132Fog or ice fogHas become thinner during the past hour
    133Fog or ice fogNo appreciable change during the past hour
    134Fog or ice fogHas begun or become thicker during the past hour
    135Fog, depositing rime
    136 - 139Reserved
    140 - 149Precipitation
    140PRECIPITATION
    141PrecipitationSlight or moderate
    142PrecipitationHeavy
    143Liquid precipitationSlight or moderate
    144Liquid precipitationHeavy
    145Solid precipitationSlight or moderate
    146Solid precipitationHeavy
    147Freezing precipitationSlight or moderate
    148Freezing precipitationHeavy
    149Reserved
    150 - 159Drizzle at the station at the time of observation
    150DRIZZLE
    151Drizzle, not freezingSlight
    152Drizzle, not freezingModerate
    153Drizzle, not freezingHeavy
    154Drizzle, freezingSlight
    155Drizzle, freezingModerate
    156Drizzle, freezingHeavy
    157Drizzle and rainSlight
    158Drizzle and rainModerate or heavy
    159Reserved
    160 - 169Rain at the station at the time of observation
    160RAIN
    161Rain, not freezingSlight
    162Rain, not freezingModerate
    163Rain, not freezingHeavy
    164Rain, freezingSlight
    165Rain, freezingModerate
    166Rain, freezingHeavy
    167Rain (or drizzle) and snowSlight
    168Rain (or drizzle) and snowHeavy
    169Reserved
    170 - 179Solid precipitation not in showers at the station at the time of observation
    170SNOW
    171SnowSlight
    172SnowModerate
    173SnowHeavy
    174Ice pelletsSlight
    175Ice pelletsModerate
    176Ice pelletsHeavy
    177Snow grains
    178Ice crystals
    179Reserved
    180 - 189Shower(s) or intermittent precipitation at the station at the time of observation
    180SHOWER(S) OR INTERMITTENT PRECIPITATION
    181Rain shower(s) or intermittent rainSlight
    182Rain shower(s) or intermittent rainModerate
    183Rain shower(s) or intermittent rainHeavy
    184Rain shower(s) or intermittent rainViolent
    185Snow shower(s) or intermittent snowSlight
    186Snow shower(s) or intermittent snowModerate
    187Snow shower(s) or intermittent snowHeavy
    188Reserved
    189Hail
    190 - 199Current or recent thunderstorm at the station at the time of observation
    190THUNDERSTORM
    191Thunderstorm, slight or moderateWith no precipitation
    192Thunderstorm, slight or moderateWith rain showers and/or snow showers
    193Thunderstorm, slight or moderateWith hail
    194Thunderstorm, heavyWith no precipitation
    195Thunderstorm, heavyWith rain showers and/or snow showers
    196Thunderstorm, heavyWith hail
    197 - 198Reserved
    199Tornado

    Generic terms for weather (e.g. fog, drizzle) are intended for stations capable of determining types of weather but no other information. These generic terms are included in the table with capital letters.

  • Corresponding symbols to weather codes (codes 00 - 99 in this table correspond to codes 100 - 199):

    Wmo4680 wawa large

Examples:

Weather Text

This parameter provides an automated text snipped describing the general weather state of the queried day. It is currently available in English, German, French and Italian.
The weather text always refers to a specific day. Therefore, only the date specification is relevant in the query, the time can be set to 00 UTC.

weather_text_de:str
weather_text_en:str
weather_text_fr:str
weather_text_it:str

Weather texts are currently available for a single coordinate and a single parameter in the same request and available in the CSV format only.

Example

validdate;weather_text_en:str
2019-04-08T00:00:00Z;Today after sunrise the sky will be overcast.
In the afternoon it will be mostly sunny. About 4 hours of sunshine are predicted. 
It stays very balmy with temperatures between 9°C and 16°C. 
After daybreak there is a slight northeasterly wind which shifts afterwards to a slight southerly wind. 
In the late evening the sky is partly cloudy, in the second half of the night dense mist may appear. 

Visibility

This parameter returns the visibility in kilometers. Fog conditions occur if the visibility is less than 1km.

visibility:<unit>

Available units: m, km, ft, nmi

Examples:

Runway Visual Range

This parameter returns the distance over which a pilot is able to see the runway surface markings at the runway margin. This parameter is used for assessing the conditions for landing and takeoff.

runway_visual_range:m
runway_visual_range:ft

Examples:

  • The evolution of the runway visual range from 2018/12/10 to 2018/12/20:

    Derived parameters runway visual range m

Dew or Rime

This index gives you an idea whether dew or rime will occur. Dew or rime forms if the surface cools down quicker than the surrounding air, which causes condensation onto the surface at high relative humidities. Dew and rime are very sensitive to solar radiation and disappear quickly as the surface warms. Rime is the frozen version of dew.

0: neither dew nor rime, 1: dew, -1: rime

dew_or_rime:idx

Examples:

  • Temperature and dew or rime evolution from 2020/01/10 to 2020/01/15:

    Derived parameters dew or rime idx

Fog

Check if there was any fog within the last hour or 30 minutes.

0: no fog, 1: fog event

is_fog_<interval>:idx

Available intervals: 30min, 1h

Examples:

  • Show if there is any fog expected during the next four days. The visibility is also shown as the two parameters contain similar information:
    https://api.meteomatics.com/2024-04-24T00:00:00Z--2024-04-29T00:00:00Z:PT1H/visibility:km,is_fog_1h:idx/47.412164,9.340652/html

    Derived parameters is fog 1h idx
  • Another example as a json output for fog expectation during the next six hours:
    https://api.meteomatics.com/2024-04-24T00:00:00ZPT6H:PT1H/visibility:km,is_fog_1h:idx/47.412164,9.340652/json

    {"version":"3.0","user":"api-test","dateGenerated":"2018-02-07T16:10:49Z","status":"OK","data":
     [{"parameter":"visibility:km","coordinates":[{"lat":47.4122,"lon":9.34065,"dates":
     [{"date":"2017-02-07T00:00:00Z","value":20},{"date":"2017-02-07T01:00:00Z","value":20},
     {"date":"2017-02-07T02:00:00Z","value":20},{"date":"2017-02-07T03:00:00Z","value":20},
     {"date":"2017-02-07T04:00:00Z","value":20},{"date":"2017-02-07T05:00:00Z","value":20},
     {"date":"2017-02-07T06:00:00Z","value":20}]}]},
     {"parameter":"is_fog_1h:idx","coordinates":[{"lat":47.4122,"lon":9.34065,"dates":
     [{"date":"2017-02-07T00:00:00Z","value":0},{"date":"2017-02-07T01:00:00Z","value":0},
     {"date":"2017-02-07T02:00:00Z","value":0},{"date":"2017-02-07T03:00:00Z","value":0},
     {"date":"2017-02-07T04:00:00Z","value":0},{"date":"2017-02-07T05:00:00Z","value":0},
     {"date":"2017-02-07T06:00:00Z","value":0}]}]}]}

Icing Potential

Icing is absolutely critical in aviation and in-flight icing on planes are the cause of multiple near-accidents or even crashes. Consequently, it is crucial for aviation to have reliable icing forecasts predicting the expected occurrence of icing on different altitudes and allowing for early circumnavigation.

icing_potential_<level>:idx

Available pressure levels: 1000hPa, 975hPa, 950hPa, 925hPa, 900hPa, 875hPa, 850hPa, 825hPa, 800hPa, 775hPa, 750hPa, 700hPa, 650hPa, 600hPa, 550hPa, 500hPa, 450hPa, 400hPa, 350hPa, 300hPa
Available flight levels: FL10 - FL605 (continuously)

IndexDescription
0.0-0.2No Icing
0.2-0.4Traces
0.4-0.6Light
0.6-0.8Moderate
0.8-1.0Heavy

Examples:

  • Below showing an example screenshot of the icing potential at 500hPa displayed via the powerful Meteomatics WMS interface. Very well visible is the icing potential along the cold front associated with the strong low pressure system West of Ireland.

    Derived parameters icing potential 500h Pa idx

Interval Values of Icing Potential

Gives the mean, maximum or minimum icing potential at the indicated flight level over the indicated duration.

icing_potential_<measure>_<level>_<interval>:idx

Available flight levels: FL10 - FL605 (continuously)

Available measures: mean, min, max

Available intervals: 1h, 3h, 6h, 12h, 24h

Examples

Slippery Road

Check if there is any chance for slippery roads within the given interval.

Probability:

prob_slippery_road_<interval>:p

Provides the probability for slippery roads from 0-100 %.

Binary Index:

is_slippery_road_<interval>:idx

0: no slippery road conditions, 1: slippery roads possible

Available intervals: 1h, 3h, 6h, 12h, 24h

Examples:

Planetary Boundary Layer Height

The planetary boundary layer (PBL) height is determined by identifying the height above ground level, where big wind direction changes, local minima of wind speed, local maxima of temperature, high temperature increases (inversion) or high potential temperature increases occur.

pbl_height:m

Example:

Snow Line

The snow line parameter provides the height above which precipitation occurs in the form of snow. Should it be undeterminable, for example if it is below ground level, it returns -666.

snow_line:m

Example:

Freezing Level

The freezing level parameter provides the altitude where the temperature equals 0 °C. If the freezing level is below ground, the return value is -666. In case of strong convection, the height of the freezing level correlates with the size of hail observed at the surface, since it determines the melting area for falling hail.

freezing_level:<unit>

Available units: m, ft

Example:

Stratospheric Polar Vortex (SPV): Wind speed

This index provides the average wind speed at 10, 50 or 200 hPa between 60 °N and 90 °N and thus indicates the strength of the stratospheric polar vortex during the polar winter.
The SPV index provides a measure of the circumpolar vortex strength and indirectly relates to a risk of cooling temperatures near the surface in the northern hemisphere, if decreasing below zero.
If the index becomes negative, the vortex disruption is such that a "split" or strong "displacement" is under way, possibly weakening the jet stream in the troposphere.

polar_vortex_<level>:ms

Available levels: 200hPa, 50hPa, 10hPa

Example:

Power line oscillation warning

Precipitation in the form of freezing rain or wet snow can freeze onto overland power lines. With the increase in diameter and mass come a bigger air resistance and a lower resonance frequency. Strong wind over a sufficient amount of time could then excite the conductors to oscillate near their resonance frequency (sometimes referred to as gallop) and thereby damage the lines and masts.

A power line oscillation warning for the past 24 hours can be queried with the following parameter:

power_line_oscillation_24h:idx

The warning is binary with 1 corresponding to a warning and 0 to an all clear. Not taken into account are things like constructional details of the power lines or the Joule heat emitted by active power lines.

Example:

Soaring Index

The soaring-index is used for an estimation of the thermal situation. It is useful for paraglider and other sport pilots. A higher soaring-index also shows a greater chance of showers and thunderstorms, as it is a measure of the lift caused by convective clouds. The soaring index is independent of altitude, as it is computed with variables in different altitudes.

soaring conditionssoaring index range
poor< -10
moderate-10 to 5
good5 to 20
excellent> 20
soaring_index:idx

Example:

Leisure Indices

The leisure index combines different weather parameters and assesses if weather conditions are favorable for certain outdoor activities or not. The index ranges from 0 to 1, where 1 means that conditions are perfect for the queried activity at the queried point in time (i.e. the parameter is instantaneous).
The indices are based on a combination of precipitation, temperature, wind speed, wind gusts, humidity, sunshine duration, snow cover, visibility and fog.

leisure_<activity>:idx
Available activities: ballooning, bbq, beach, biking, climbing, fishing, gardening, gliding, hiking, hunting, sailing, skiing, tv

Examples:

Laundry Index

The laundry index describes how well laundry dries in the air. Values closer to 1 indicate that laundry will definitely dry outside, whereas values towards 0 correspond to laundry that will remain wet.

laundry_index:idx

Examples:

Cold Index

This index combines several weather parameters like temperature, wind speed, humidity and precipitation and assesses how favorable these weather conditions are for catching a cold. The index takes values from 1 to 100, where higher values indicate higher risks.

cold_index:idx

Examples:

Probability for Snow Cover

Gives the probability for a location/region being covered by snow. The probability is determined by combining information about temperatures at different altitudes and precipitation predictions.

prob_snow_cover:p

Examples:

Index for Windshield Icing

Gives the probability for the occurrence of windshield icing for cars. This index combines information about temperature, humidity, wind speed and other parameters and yields a probability in the range of 0-100 %. In addition, it is possible to specify an inclination between 0° (flat) and 90° (vertical) of the windshield - the default value is 50°.

prob_car_windshield_frost_<inclination>d:p

Examples:

Aerodrome Approach Index

This index gives an indication for significant weather conditions at an airport. The index yields values between 0 and 2. If the index equals 2, conditions are hostile for an aircraft to land. If the index equals 0, no dangerous weather conditions are present.

aerodrome_approach:idx

Examples: