Cloud API Parameters

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

Note: A value of -666 denotes that there are no clouds present.

low cloud cover corresponds approximately to levels between 0 and 1800m above ground level.

medium cloud cover corresponds approximately to levels between 1800m and 6300m above ground level.

high cloud cover corresponds approximately to levels higher than 6300m above ground level.

total cloud cover is the fraction of the sky covered by cloud at any height. Due to overlapping clouds at different heights, it may not correspond to the sum of the low, medium and high cloud covers.

effective cloud cover is a weighted sum of the low, medium and high level cloud covers relevant for solar energy forecasts. The low and medium level clouds have a higher weight than the high level clouds as the low and medium level clouds block more radiation.

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/2024-12-19T12: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

Chart showing total cloud cover created in MetX:

Interval Values of Cloud Cover

Gives the mean cloud cover over the indicated duration.

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

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

Available measures: mean

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

Available units: octas, p

Example:

Current situation:
https://api.meteomatics.com/2024-12-19T00:00:00ZP3D:PT1H/total_cloud_cover_mean_12h:p/47.470301,8.540186/html?source=mix

Mean Amount of Cloud Cover over the Last 10 Years

Gives the mean amount of cloud cover over the last 10 years on a certain date at a specific location.

<level>_cloud_cover_10y_mean:p

Available levels: low, medium, high, total

low cloud cover corresponds approximately to levels between 0 and 1800m above ground level.

medium cloud cover corresponds approximately to levels between 1800m and 6300m above ground level.

high cloud cover corresponds approximately to levels higher than 6300m above ground level.

Examples:

Compare the mean amount of total cloud cover of the last ten years with the mean amount of total cloud cover of 2022.

Current situation:
https://api.meteomatics.com/2024-12-19T12:00:00ZP30D:P1D/total_cloud_cover_10y_mean:p,total_cloud_cover:p/50,10/html
The amount of total cloud cover of December compared to the 10 years mean:
```
validdate;total_cloud_cover_10y_mean:p;total_cloud_cover:p
2021-12-01T12:00:00Z;95.6;100.0
2021-12-11T12:00:00Z;92.6;100.0
2021-12-21T12:00:00Z;89.2;0.0
2021-12-31T12:00:00Z;86.8;99.4
```
Current situation:
https://api.meteomatics.com/2024-12-19T12:00:00ZP1M:P10D/total_cloud_cover_10y_mean:p,total_cloud_cover:p/50,10/csv

Ceiling Height

The ceiling height above ground level is an important parameter in aviation and is defined as the height of the lowest cloud layer covering more than half of the sky or where clouds are present above 6000m. The ceiling height is also available as a mean, maximum or minimum value over a specified time interval.

ceiling_height_agl:<unit>

ceiling_height_agl_<measure>_<interval>:<unit>

Units: m, ft

Measures: max, mean, min

Intervals: 1h, 2h, 3h, 6h, 12h, 24h, 48h

Note: A value of -666 denotes that there are no clouds present and hence no ceiling height or cloud base can be determined. If a value of -666 occurs during the specified time interval, this value is disregarded and is not taken into account when determining the chosen statistical measure.

Examples

The evolution of the ceiling height in the end of October, 2020 at Zurich Airport:

Current situation:
https://api.meteomatics.com/2024-12-19T00:00:00ZP3D:PT1H/ceiling_height_agl:m/47.470301,8.540186/html?source=mix

Cloud Base

The cloud base above ground level gives the lowest altitude of the visible portion of a cloud.

cloud_base_agl:<unit>

cloud_base_agl_<measure>_<interval>:<unit>

Units: m, ft

Measures: max, mean, min

Intervals: 1h, 2h, 3h, 6h, 12h, 24h, 48h

Examples

The evolution of the cloud base in the end of October, 2020 at Zurich Airport:

Current situation:
https://api.meteomatics.com/2024-12-19T00:00:00ZP3D:PT1H/cloud_base_agl:m:m/47.470301,8.540186/html?source=mix

Convective Cloud Top Height

This parameter gives the height of convective cloud tops in metres above ground level. A value is only returned if convective clouds are likely to be present. Where no convective clouds are present, a value of -666 is returned.

convective_cloud_top_height_agl:<unit>

convective_cloud_top_height_agl_<measure>_<interval>:<unit>

Units: m

Measures: max, mean, min

Intervals: 1h, 2h, 3h, 6h, 12h, 24h, 48h

Note: If a value of -666 occurs during the specified time interval, this value is disregarded and is not taken into account when determining the chosen statistical measure.

Example:

Current situation in Granada, Spain:
https://api.meteomatics.com/2024-12-19T00:00:00ZP3D:PT1H/convective_cloud_top_height_agl:m/37.15640,-3.63466/html?source=mix

Cloud Top Temperature

This parameter gives the temperature at the top of the highest cloud level. Where no clouds are present, a value of -666 is returned.

t_cloud_top:<unit>

Units: C, F, K

Example:

Cloud top temperature in January in Manchester, England:
https://api.meteomatics.com/2023-01-12T00:00:00ZP3D:PT1H/t_cloud_top:C/53.4808,2.2426/html?source=mix

Probability for Contrails

This parameter gives the probability for contrails (artificial cirrus clouds produced by airplanes) on a specific level. It depends on the formation probability, that is based on the critical air temperature and on the persistance probability, that is based on the relative humidity over ice.

contrail_<level>:p

Available altitude levels: 2m to 20'000m (continuously), 5ft - 65600ft (continuously)

Available pressure levels: 1000hPa, 950hPa, 925hPa, 900hPa, 850hPa, 800hPa, 700hPa, 600hPa, 500hPa, 400hPa, 300hPa, 250hPa, 200hPa, 150hPa, 100hPa, 70hPa

Available flight levels: FL10 - FL600 (continuously)

Example:

Probability of contrails for Frankfurt, Germany at a pressure level of 250hPa:
https://api.meteomatics.com/2022-01-30T0000Z--2022-02-15T0000Z:PT1H/contrail_250hPa:p/50.1109,8.6821/html?source=mix

Example:

Probability of contrails for Europe at a pressure level of 300hPa in MetX: