Formats and Units

Meteostat uses the metric system. Both the JSON API and the Bulk Data interface use the formats and units listed below.

Time Format

Date and time statements follow the ISO 8601 standard (e.g. 2016-12-31 for December 31st 2016 and 23:59:58 for 23 hours, 59 minutes, and 58 seconds). The time zone used by Meteostat is Coordinated Universal Time (UTC).

Time Ranges

Many JSON API endpoints require the specification of a time range using the start and end parameters. For these parameters please always provide dates in this format: YYYY-MM-DD.

Meteorological Parameters

The Meteostat API uses abbreviations to describe meteorological parameters:

CodeMeaning
TEMPTemperature
TAVGAverage Temperature
TMINMinimum Temperature
TMAXMaximum Temperature
DWPTDew Point
PRCPTotal Precipitation
WDIRWind Direction
WSPDAverage Wind Speed
WPGTWind Peak Gust
RHUMRelative Humidity
PRESSea-Level Air Pressure
SNOWSnow Depth
TSUNTotal Sunshine Duration
COCOWeather Condition Code

Meteorological Measurement Units

Parameter(s)Unit
Temperature°C
Precipitationmm
Sunshine DurationMinutes, Hours
Air PressurehPa
Wind Speed, Peak Wind Gustkm/h
Wind DirectionDegrees
Visibility, Cloud Heightm
Relative Humidity%

Weather Condition Codes

Hourly weather data may include information on the observed weather condition. Please note that the weather condition is not a key parameter for the Meteostat project. METAR reports issued by weather stations located at airports only report significant weather events. Also, some weather stations do not provide weather condition data at all.

Weather conditions are indicated by an integer value between 1 and 27 according to this list:

CodeWeather Condition
1Clear
2Fair
3Cloudy
4Overcast
5Fog
6Freezing Fog
7Light Rain
8Rain
9Heavy Rain
10Freezing Rain
11Heavy Freezing Rain
12Sleet
13Heavy Sleet
14Light Snowfall
15Snowfall
16Heavy Snowfall
17Rain Shower
18Heavy Rain Shower
19Sleet Shower
20Heavy Sleet Shower
21Snow Shower
22Heavy Snow Shower
23Lightning
24Hail
25Thunderstorm
26Heavy Thunderstorm
27Storm