MENUMENU

Basic Weather Parameter

Temperature

Immediate Temperature

Gives the instantaneous temperature at the indicated level above ground in the corresponding unit.

t_<level>:<unit>

Available levels: 0m, 2m, 1000hPa, 950hPa, 925hPa, 900hPa, 850hPa, 800hPa, 700hPa, 500hPa, 300hPa -150cm, -50cm, -15cm, -5cm

Available units: C, K, F

Examples

Interval Values of the Temperature

Gives the mean, maximum or minimum temperature at the indicated level over the indicated duration.

t_<measure>_<level>_<interval>:<unit>

Available levels: 0m, 2m, 1000hPa, 950hPa, 925hPa, 900hPa, 850hPa, 800hPa, 700hPa, 500hPa, 300hPa -150cm, -50cm, -15cm, -5cm

Available measures: mean, min, max

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

Available units: C, K, F

Examples

Humidity

Relative Humidity

Gives the instantaneous value of the relative humidity at the indicated level in percent.

relative_humidity_<level>:<unit>

Available levels: 2m, 1000hPa, 950hPa, 925hPa, 900hPa, 850hPa, 800hPa, 700hPa, 500hPa, 300hPa

Available units: p

Examples

Absolute Humidity

Gives the absolute humidity at 2m in [g/m3]. Note: the absolute humidity is only available at 2m.

absolute_humidity_2m:gm3

Examples

Dew Point

Instantaneous Dew Point

Gives the instantaneous value of the dew point temperature at the indicated level.

dew_point_<level>:<unit>

Available levels: 2m, 1000hPa, 950hPa, 925hPa, 900hPa, 850hPa, 800hPa, 700hPa, 500hPa, 300hPa

Available units: C, K, F

Example

Atmospheric Pressure

Pressure adjusted to sea level

Gives the pressure adjusted to sea level.

msl_pressure:<unit>

Available units: hPa, Pa

Examples

Surface Pressure

Gives the surface pressure.

sfc_pressure:<unit>

Available units: hPa, Pa

Examples

  • Show the predicted surface pressure evolution for the next three days.

    https://api.meteomatics.com/todayT00:00:00ZP3D:PT6H/sfc_pressure:hPa/47.412164,9.340652/html

  • The predicted surface pressure for the next two days in json format.
    https://api.meteomatics.com/todayT00:00:00ZP2D:PT6H/sfc_pressure:hPa/47.412164,9.340652/json

    {"version":"3.0","user":"api-test","dateGenerated":"2018-02-14T12:39:08Z","status":"OK","data":
    [[{"parameter":"sfc_pressure:hPa","coordinates":[{"lat":47.4122,"lon":9.34065,"dates":
    [{"date":"2018-01-01T00:00:00Z","value":924.2},{"date":"2018-01-01T06:00:00Z","value":926.8},
    {"date":"2018-01-01T12:00:00Z","value":924.7},{"date":"2018-01-01T18:00:00Z","value":917.8},
    {"date":"2018-01-02T00:00:00Z","value":924.2},{"date":"2018-01-02T06:00:00Z","value":927.6},
    {"date":"2018-01-02T00:00:00Z","value":924.2},{"date":"2018-01-02T06:00:00Z","value":927.6},
    {"date":"2018-01-02T12:00:00Z","value":930.2},{"date":"2018-01-02T18:00:00Z","value":930.4},
    {"date":"2018-01-03T00:00:00Z","value":925.6}]}]}]}

Surface Pressure Mean

Gives the surface pressure mean over the given interval.

sfc_pressure_mean_<interval>:<unit>

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

Available units: hPa, Pa

Examples

Wind

Instantaneous Wind Speed

Gives the instantaneous wind speed at the indicated level.

wind_speed_<level>:<unit>

Available levels: 10m, 80m, 100m, 120m, 1000hPa, 950hPa, 925hPa, 850hPa, 800hPa, 700hPa, 500hPa, 300hPa

Available speed units: ms, kmh, kn, bft

Examples

Instantaneous Wind Direction

Gives the instantaneous wind direction at the indicated height in degrees from North. For example, a direction of 45 degrees means that the wind is coming from the Northeast.

wind_dir_<level>:d

Available levels: 10m, 80m, 100m, 120m, 1000hPa, 950hPa, 925hPa, 850hPa, 800hPa, 700hPa, 500hPa, 300hPa

Examples

  • Generate a csv file comparing the wind direction at 10m and 700hPa

    https://api.meteomatics.com/todayT00:00:00ZP2D:PT3H/wind_dir_10m:d,wind_dir_700hPa:d/47.412164,9.340652/csv

    validdate;wind_dir_10m:d;wind_dir_700hPa:d
    2017-08-03T00:00:00Z;163.8;250.2
    2017-08-03T03:00:00Z;170;239.2
    2017-08-03T06:00:00Z;191.3;228.8
    2017-08-03T09:00:00Z;244;231.8
    2017-08-03T12:00:00Z;239.4;239
    2017-08-03T15:00:00Z;243.1;241.6
    2017-08-03T18:00:00Z;234.2;247.2
    2017-08-03T21:00:00Z;240.9;250.6
    2017-08-04T00:00:00Z;249.1;248.1
    2017-08-04T03:00:00Z;240.9;221.1
    2017-08-04T06:00:00Z;263.2;226.2
    2017-08-04T09:00:00Z;319.4;236.3
    2017-08-04T12:00:00Z;322.3;257.1
    2017-08-04T15:00:00Z;314.4;255.2
    2017-08-04T18:00:00Z;301.4;256.8
    2017-08-04T21:00:00Z;269.8;260
    2017-08-05T00:00:00Z;172.2;252.3

Wind Speed: u and v components

Gives the immediate wind u and v components at the indicated level.

wind_speed_u_<level>:<unit>

wind_speed_v_<level>:<unit>

Components (surface level, u is positive for a west to east flow, v is positive for a south to north flow).

Available levels: 10m, 80m, 100m, 120m, 1000hPa, 950hPa, 925hPa, 850hPa, 800hPa, 700hPa, 500hPa, 300hPa

Available speed units: ms, kmh, kn

Examples

Interval Wind Speed

Gives the mean wind speed over the specified interval at the indicated level.

wind_speed_mean_<level>_<interval>:<unit>

Available levels: 10m, 80m, 100m, 120m, 1000hPa, 950hPa, 925hPa, 850hPa, 800hPa, 700hPa, 500hPa, 300hPa

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

Available speed units: ms, kmh, kn, bft

Examples

Interval Wind Gusts

Gives the mean, minimum or maximum wind gusts over the specified interval at the indicated level:

wind_gusts_<level>_<interval>:<unit>

Available levels: 10m, 80m, 100m, 120m, 1000hPa, 950hPa, 925hPa, 850hPa, 800hPa, 700hPa, 500hPa, 300hPa

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

Available speed units: ms, kmh, kn, bft

Examples

Interval Wind Direction

Gives the mean wind direction over the specified interval at the indicated height in degrees:

wind_dir_mean_<level>_<interval>:d

Available levels: 10m, 80m, 100m, 120m, 1000hPa, 950hPa, 925hPa, 850hPa, 800hPa, 700hPa, 500hPa, 300hPa

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

Examples

Wind Profile

A vertically interpolated wind speed is available for all heights above ground.

wind_speed_<level>:<unit>

Available levels: continuous from 10m to 10000m
Available units: ms, kmh, kn, bft

Examples

Logarithmic Wind Profile

You can specify to use the logarithmic profile instead of the more generic variant above.
The logarithmic wind profile is defined from 10 to 200 meters. The logarithmic wind profile is considered to be a more reliable estimator than the wind profile power law of mean wind speed for heights between 10 and 20 meters. For heights outside of this range, both methods can produce reasonable predictions of mean wind speed (assuming neutral atmospheric conditions).

wind_speed_log_profile_<level>:<unit>

Available levels: continuous from 10m to 200m
Available units: ms, kmh, kn, bft

Examples

Clouds

Amount of Cloud Cover

Gives the amount of cloud cover in percent or octas.

<level>_cloud_cover:<unit>

Available levels: low, medium, high, total, effective

Available units: octas, p

Examples

  • Generate a csv file containing the amount of cloud cover in octas for every grid point of the specified area.

    https://api.meteomatics.com/todayT12:00:00Z/effective_cloud_cover:octas/50,5_35,20:1,1/csv

    validdate;2017-08-03 12:00:00
    parameter;effective_cloud_cover:octas
    data;5;6;7;8;9;10;11;12;13;14;15;16;17;18;19;20
    50;1;8;4;5;4;8;8;8;8;8;8;8;5;1;0;0
    49;7;5;6;4;8;5;2;4;4;3;8;0;6;0;0;0
    48;3;5;6;6;1;2;5;2;4;1;1;0;1;0;0;0
    47;2;5;3;4;1;0;2;0;1;1;0;0;0;0;0;0
    46;0;0;0;3;0;0;0;0;0;0;0;0;0;0;0;0
    45;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0
    44;0;0;3;0;0;0;0;0;0;0;0;0;0;0;0;2
    43;0;1;0;0;0;0;0;0;1;0;0;0;0;0;2;1
    42;0;1;1;0;0;0;0;0;0;0;0;0;0;0;0;6
    41;0;4;1;0;0;0;0;0;0;0;0;0;0;0;1;1
    40;0;0;0;0;0;0;0;0;0;0;0;0;0;0;1;0
    39;0;0;0;0;0;0;0;0;0;0;0;2;0;0;1;0
    38;2;0;0;0;0;0;0;0;0;0;0;0;0;0;4;0
    37;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0
    36;0;0;0;0;0;0;0;6;0;0;0;0;0;0;0;0
    35;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0
  • Show a GrADS plot of Europe with the amount of total cloud cover in percent.

    https://api.meteomatics.com/now/total_cloud_cover:p/europe/grads?model=ecmwf-ifs

Precipitation

Accumulated precipitation

Gives the amount of precipitation in millimeters that has fallen during the indicated interval.

precip_<interval>:mm

Available intervals: 5min, 10min, 15min, 30min, 1h, 3h, 6h, 12h, 24h

Note: Precipitation interval parameters are right-aligned see Appendix

Examples

Precipitation type

You can query an integer indicating the precipitation type with the parameter

precip_type:idx

The values correspond translate to the type as given in the following table:

IndexPrecipitation Type
0None
1Rain
2Rain and snow mixed
3Snow
4Sleet
5Freezing rain

It is based on the precipitation during the last 5 minutes, where very small amounts are ignored. For hail please refer to the dedicated section below.

Examples

For visualization purposes you may query an image for the parameter

precip_layer_5min:idx

together with the colormap png_precip_type_segmented (the use of other colormaps is highly discouraged). It combines the precipitation type above with the water equivalent of precipitation fallen during the last 5 minutes.

For the interpretation of the image please refer to the following legend graphic:

Example

  • Rain over the North Sea with rain and snow mixed or snow over parts of the Scottish Highlands:

Precipitation probability

Precipitation probability:

prob_precip_<interval>:p

Available intervals: 5min, 10min, 15min, 30min, 1h, 3h, 6h, 12h, 24h

Note: Precipitation interval parameters are right-aligned see Appendix

Examples

Hail

The API features a hail parameter describing the maximum size of the hailstones.

Instantaneous value:

hail:cm

Risk over a temporal interval:

hail_<interval>:cm

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

Examples

Response:

<meteomatics-api-response version="3.0">
<user>meteomatics-admin</user>
<dateGenerated>2018-06-06T19:02:48Z</dateGenerated>
<status>OK</status>
<data>
<parameter name="hail:cm">
<location lat="47.4066" lon="9.17683">
<value date="2018-05-31T16:00:00Z">0.00000</value>
<value date="2018-05-31T16:05:00Z">0.00000</value>
<value date="2018-05-31T16:10:00Z">1.00000</value>
<value date="2018-05-31T16:15:00Z">5.00000</value>
<value date="2018-05-31T16:20:00Z">5.00000</value>
<value date="2018-05-31T16:25:00Z">5.00000</value>
<value date="2018-05-31T16:30:00Z">0.00000</value>
<value date="2018-05-31T16:35:00Z">0.00000</value>
<value date="2018-05-31T16:40:00Z">0.00000</value>
<value date="2018-05-31T16:45:00Z">0.00000</value>
<value date="2018-05-31T16:50:00Z">0.00000</value>
<value date="2018-05-31T16:55:00Z">0.00000</value>
<value date="2018-05-31T17:00:00Z">0.00000</value>
</location>
</parameter>
</data>
</meteomatics-api-response>

Evaporation

Accumulated Evaporation

Gives the accumulated amount of evaporation in millimeters for 1, 3, 6, 12 and 24 hour intervals. The amount of evaporation depends on factors such as cloudiness, air temperature and wind speed.

evaporation_<interval>:<unit>

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

Available units: mm

Examples

  • Show a two day evaporation forecast with a resolution of one hour.

    https://api.meteomatics.com/todayT00:00:00ZP2D:PT1H/evaporation_1h:mm/47.412164,9.340652/html

  • A part of the corresponding csv file

    validdate;evaporation_1h:mm
    2017-08-03T21:00:00Z;-0.01
    2017-08-03T22:00:00Z;-0.01
    2017-08-03T23:00:00Z;-0.01
    2017-08-04T00:00:00Z;-0.01
    2017-08-04T01:00:00Z;-0.02
    2017-08-04T02:00:00Z;-0.02
    2017-08-04T03:00:00Z;-0.02
    2017-08-04T04:00:00Z;-0.04
    2017-08-04T05:00:00Z;-0.04

Atmospheric Stability

Convective available potential energy (CAPE)

The convective available potential energy (given in joules per kilogram air) is the amount of energy a parcel of air would have if lifted a certain distance vertically through the atmosphere. Any value greater than 0 J/kg indicates instability and an increasing probability of thunderstorms and hail.

cape:Jkg

Examples

Lifted Index

The lifted index (given in Kelvin) is the difference between the temperature of the environment and that of an air parcel lifted adiabatically to a given pressure height in the troposphere, usually 500 hPa. The atmosphere at the given height is stable for positive values of the lifted index and unstable for negative values. When the value falls below -2, thunderstorms are anticipated. and for lower values, especially those below -6, severe weather is expected.

lifted_index:K

Examples

Thunderstorm Probabilities

Gives the probability of a thunderstorm to occur.

prob_tstorm_<interval>:mm

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

Examples

  • Show a thunderstorm probability forecast for the next two days.

    https://api.meteomatics.com/todayT00:00:00ZP2D:PT1H/prob_tstorm_1h:p/47.412164,9.340652/html

  • Below is an image of the thunderstorm probabilities on August 1st at 18:00 over Europe (70°,-15° to 35°,30°).

    https://api.meteomatics.com/now/prob_tstorm_1h:p/70,-15_35,30:0.1,0.1/html

  • https://api.meteomatics.com/now/prob_tstorm_12h:p/70,-15_35,30:15,15/json

    {"version":"3.0","user":"api-test","dateGenerated":"2018-02-21T14:51:41Z","status":"OK","data":
    [{"parameter":"prob_tstorm_12h:p","coordinates":
    [{"lat":35,"lon":-15,"dates":[{"date":"2017-08-01T00:00:00Z","value":12.9}]},
    {"lat":35,"lon":0,"dates":[{"date":"2017-08-01T00:00:00Z","value":44.2}]},
    {"lat":35,"lon":15,"dates":[{"date":"2017-08-01T00:00:00Z","value":23.4}]},
    {"lat":35,"lon":30,"dates":[{"date":"2017-08-01T00:00:00Z","value":86.4}]},
    {"lat":50,"lon":-15,"dates":[{"date":"2017-08-01T00:00:00Z","value":16.1}]},
    {"lat":50,"lon":0,"dates":[{"date":"2017-08-01T00:00:00Z","value":14.3}]},
    {"lat":50,"lon":15,"dates":[{"date":"2017-08-01T00:00:00Z","value":22.2}]},
    {"lat":50,"lon":30,"dates":[{"date":"2017-08-01T00:00:00Z","value":11.4}]},
    {"lat":65,"lon":-15,"dates":[{"date":"2017-08-01T00:00:00Z","value":11.8}]},
    {"lat":65,"lon":0,"dates":[{"date":"2017-08-01T00:00:00Z","value":13.6}]},
    {"lat":65,"lon":15,"dates":[{"date":"2017-08-01T00:00:00Z","value":21.5}]},
    {"lat":65,"lon":30,"dates":[{"date":"2017-08-01T00:00:00Z","value":17}]}]}]}

Snow & Frost

Frost Depth

Gives the frost depth in centimeters.

frost_depth:cm

Examples

  • Create a time series showing the frost depth on the “Jungfrau” (a 4,158 meters high mountain in the Bernese Alps) during one day.

    https://api.meteomatics.com/todayT00:00:00ZP1D:PT1H/frost_depth:cm/46.5468,7.9826/html

  • An output of the corresponding csv file.

    validdate;frost_depth:cm
    2017-08-25T00:00:00Z;3
    2017-08-25T01:00:00Z;3.7
    2017-08-25T02:00:00Z;4.5
    2017-08-25T03:00:00Z;4.6
    2017-08-25T04:00:00Z;4.6
    2017-08-25T05:00:00Z;4.7
    2017-08-25T06:00:00Z;4.4
    2017-08-25T07:00:00Z;1.7
    2017-08-25T08:00:00Z;0.4
    2017-08-25T09:00:00Z;0.1
    2017-08-25T10:00:00Z;0

Amount of Snow Melt

Following parameter returns the snow height that melted within the given interval, i.e. the difference in snow height in cm:

snow_melt_<interval>:cm

Following paramter returns the height of the water equivalent of the melted snow in mm (that is the same as l/m²). Please note that it is not the height of the snow cover in mm.

snow_melt_<interval>:mm

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

Examples

Amount of Fresh Snow

Gives the amount in centimeters of fresh snow falling during the indicated time interval.

fresh_snow_<interval>:cm

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

Examples

Snow Depth

Gives the snow depth in centimeters.

snow_depth:cm

Examples

Geopotential Height

Gives the geopotential height in meters at the indicated level. The geopotential height differs from geometric height (elevation above sea level) and takes into account the variation of gravity with latitude and elevation.

geopotential_height_<level>:m

Available levels: 1000hPa, 950hPa, 925hPa, 900hPa, 850hPa, 800hPa, 700hPa, 500hPa, 300hPa

Examples

Radiation

Note: All radiation parameters are normalized on one square meter. The effective unit therefore is W/m2 or J/m2, respectively.

Clear Sky Radiation: Instantaneous Flux

Gives the instantaneous flux of clear sky radiation in Watts per square meter.

clear_sky_rad:W

Examples

Clear Sky Radiation: Accumulated Energy

Gives the accumulated clear sky flux over the given interval in Joules per square meter.

clear_sky_energy_<interval>:J

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

Examples

  • Show the expected accumulated clear sky energy for the next two days.

    https://api.meteomatics.com/todayT00:00:00ZP2D:PT1H/clear_sky_energy_1h:J/47.412164,9.340652/html

  • A short part of the corresponding csv:

    validdate;clear_sky_energy_1h:J
    2018-08-03T03:00:00Z;0
    2018-08-03T04:00:00Z;0
    2018-08-03T05:00:00Z;99322
    2018-08-03T06:00:00Z;595481
    2018-08-03T07:00:00Z;1292134
    2018-08-03T08:00:00Z;1990880.5
    2018-08-03T09:00:00Z;2605813.1
    2018-08-03T10:00:00Z;3082453.7
    2018-08-03T11:00:00Z;3383074.9
    2018-08-03T12:00:00Z;3484897.5

Diffuse Radiation: Instantaneous flux

Gives the instantaneous flux of diffuse radiation in Watts per square meter.

diffuse_rad:W

Examples

Direct Radiation: Instantaneous Flux

Gives the instantaneous flux of direct radiation in Watts per square meter.

direct_rad:W

Examples

Global Radiation: Instantaneous Flux

Gives the instantaneous flux of global radiation (diffuse + direct radiation) in Watts per square meter.

global_rad:W

Examples

Accumulated Energy

Gives the accumulated energy of direct, diffuse or global radiation in Ws, Wh or J per square meter.

<type>_rad_<interval>:<unit>

Available type: global, direct, diffuse

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

Available units: Ws, Wh, J

Examples

  • Show the direct, diffuse and global radiation accumulated over one hour intervals for the next five days.

    https://api.meteomatics.com/todayT00:00:00ZP5D:PT1H/direct_rad_1h:J,diffuse_rad_1h:J,global_rad_1h:J/50,10/html

  • https://api.meteomatics.com/todayT00:00:00ZP1D:PT8H/direct_rad_1h:J,diffuse_rad_1h:J,global_rad_1h:J/50,10/json

    {"version":"3.0","user":"api-test","dateGenerated":"2018-02-07T15:28:54Z","status":"OK","data":
    [{"parameter":"direct_rad_1h:J","coordinates":[{"lat":50,"lon":10,"dates":
    [{"date":"2018-02-05T00:00:00Z","value":0},{"date":"2018-02-05T08:00:00Z","value":60676.4},
    {"date":"2018-02-05T16:00:00Z","value":17505.2},{"date":"2018-02-06T00:00:00Z","value":0}]}]},
    {"parameter":"diffuse_rad_1h:J","coordinates":[{"lat":50,"lon":10,"dates":
    [{"date":"2018-02-05T00:00:00Z","value":0},{"date":"2018-02-05T08:00:00Z","value":40723.3},
    {"date":"2018-02-05T16:00:00Z","value":73051.6},{"date":"2018-02-06T00:00:00Z","value":0}]}]},
    {"parameter":"global_rad_1h:J","coordinates":[{"lat":50,"lon":10,"dates":
    [{"date":"2018-02-05T00:00:00Z","value":0},{"date":"2018-02-05T08:00:00Z","value":101399.7},
    {"date":"2018-02-05T16:00:00Z","value":90556.8},{"date":"2018-02-06T00:00:00Z","value":0}]}]}]}