# Hourly Data
This endpoint provides historical hourly observations for a geographic location. Furthermore, gaps in the time series can be filled in with statistically optimized model data. The data provided through this endpoint is aggregated from multiple governmental interfaces.
Hourly observations are coming in with an offset of about two to three hours. However, some data might be added multiple days or even months later, depending on how the different weather services are updating their datasets.
Hourly data can be queried for a maximum of 10 days per request.
# Endpoint
Hourly data is provided through this endpoint:
GET https://api.meteostat.net/v2/point/hourly
# Parameters
In order to query data for any location you’ll need to specify the lat
and lon
parameters. You will probably also want to add the alt
parameter to your request to make the output more precise. If you do not set the alt
parameter, Meteostat will detect the elevation using its own elevation model.
Parameter | Description | Type | Required | Default |
---|---|---|---|---|
lat | The latitude of the geographic location | Float | Yes | undefined |
lon | The longitude of the geographic location | Float | Yes | undefined |
alt | The elevation of the geographic location | Integer | No | 0 |
start | The start date of the query (format: YYYY-MM-DD) | String | Yes | undefined |
end | The end date of the query (format: YYYY-MM-DD) | String | Yes | undefined |
tz | The time zone according to the tz database | String | No | UTC |
# Response
The response body includes the following properties.
Parameter | Description | Type |
---|---|---|
time | UTC time stamp (format: YYYY-MM-DD hh:mm:ss) | String |
time_local | Local time stamp (format: YYYY-MM-DD hh:mm:ss); only provided if tz is set | String |
temp | The air temperature in °C | Float |
dwpt | The dew point in °C | Float |
rhum | The relative humidity in percent (%) | Integer |
prcp | The one hour precipitation total in mm | Float |
snow | The snow depth in mm | Integer |
wdir | The wind direction in degrees (°) | Integer |
wspd | The average wind speed in km/h | Float |
wpgt | The peak wind gust in km/h | Float |
pres | The sea-level air pressure in hPa | Float |
tsun | The one hour sunshine total in minutes (m) | Integer |
coco | The weather condition code | Integer |
More information on the data formats and weather condition codes is available here.
# Example
The following example requires the cURL command-line interface. Alternatively, you can use an API client like Postman.
curl --header "x-api-key: {key}" "https://api.meteostat.net/v2/point/hourly?lat=49.4967&lon=8.4795&alt=104&start=2020-01-01&end=2020-01-01&tz=Europe/Berlin"
Please replace {key}
with your personal API key.
# Data Response
The data output returns one object per hour. Have a look at this example:
{
"time": "2019-12-31 23:00:00",
"time_local": "2020-01-01 00:00:00",
"temp": 1.6,
"dwpt": 0.1,
"rhum": 90,
"prcp": 0,
"snow": 0,
"wdir": 300,
"wspd": 5,
"wpgt": 10,
"pres": 1036.4,
"tsun": 0,
"coco": 4
}
← Overview Daily Data →