History & Climate Data
Historical Data Packages
The historical data of meteoblue is built up through archiving the raw weather model output once a day (forecast hours 12 till 36). Generally, the delivered data is from the model with the highest resolution for the given location and time.
The data packages deliver time series of historical weather data of maximum one year per call. You can set a start and end date (YYYY-MM-DD). If the time range between start and end date is bigger than one year, the API will check the end date only and deliver data for 366 days backwards.
Example:
- &startdate=2000-01-01&enddate=2015-12-31: You will get data from 2014-12-31 until 2015-12-31
- &startdate=2015-01-01&enddate=2015-01-31: You will get data from 2015-01-01 until 2015-01-31
History Basic
The History Basic data package contains historical data for the most common weather variables.
| Variable | Units | Description | Intervals | Aggregations (day) |
|---|---|---|---|---|
| Temperature | °C, °F | 2m above ground | 1h, day | Min, max, mean |
| Sea level pressure | hPa | Corrected for sea level | 1h, day | Min, max, mean |
| Precipitation | mm, inch | Water amount | 1h, day | Sum |
| Snow fraction | 0, 1 | information whether precipitation fell as rain or snow: 0 = rain, 1 = snow | 1h, day | Hourly: 0 or 1, aggregations: range from 0 till 1 (mean of hourly values) |
| Wind direction | °, 2 char, 3 char | 10m above ground | 1h, day | Dominant |
| Wind speed | m/s, km/h, kn, mph, bf | 10m above ground | 1h, day | Min, max, mean |
| Relative humidity | % | Air humidity | 1h, day | Min, max, mean |
History Agro
The History Agro data package contains historical data of soil and vegetation related weather variables.
| Variable | Units | Description | Intervals | Aggregations (day) |
|---|---|---|---|---|
| Soil temperature (0 - 10 cm) | °C, °F | Assuming typical soil | 1h, day | Min, max, mean |
| Soil moisture (0 - 10 cm) | % | Assuming typical soil | 1h, day | Min, max, mean |
| Skin / surface temperature | °C, °F | Soil surface or skin | 1h, day | Min, max, mean |
| Evapotranspiration | mm | Assuming typical soil and vegetation | 1h, day | Sum |
| Reference evapotranspiration (ET$_0$) | mm | 1h, day | Sum | |
| Dewpoint temperature | °C, °F | 2m above ground | 1h, day | Min, max, mean |
| Wetbulb temperature | °C, °F | 2m above ground | 1h, day | Min, max, mean |
History Wind
The History Wind data package contains historical data of specific wind variables for the wind energy sector.
| Variable | Units | Description | Intervals | Aggregations (day) |
|---|---|---|---|---|
| Wind speed 80m | m/s, km/h, kn, bf, mph | 80m above ground | 1h, day | Min, max, mean |
| Wind direction 80m | °, 2 char 3 char | 80m above ground | 1h, day | Dominant |
| Wind gusts | m/s, km/h, kn, bf, mph | m/s, km/h, kn, bf, mph | 1h, day | Min, max, mean |
History Wind Power
The History Wind Power data package contains historical data of wind power at a height of 80m.
| Variable | Units | Description | Intervals |
|---|---|---|---|
| Wind Power | kW | 80m above ground | 1h |
Special Parameters:
| Name | Description | Example | Default |
|---|---|---|---|
| Turbine ID | Turbine type* | &turbineid=-1 | Mandatory parameter |
| Power efficiency | Power efficiency of wind turbine | &power_efficiency=0.9 | 1 |
| Number of turbines | Number of turbines | numberofturbines=10 | 1 |
| Kwp** | Kilowatt peak production | &kwp=1 | 1 |
* You can find the list of the turbine IDs / types here.
** only applicable for standard turbine (turbineid=-1)
History Clouds
The History Clouds data package contains historical data of cloud layer and sunshine duration.
| Variable | Units | Description | Intervals | Aggregations (day) |
|---|---|---|---|---|
| Total cloud cover | % | Cover of the sky, analogue to METAR 0 - 8 | 1h, day | Min, max, mean |
| Low clouds | % | Cover of the sky | 1h, day | Min, max, mean |
| Mid clouds | % | Cover of the sky | 1h, day | Min, max, mean |
| High clouds | % | Cover of the sky | 1h, day | Min, max, mean |
| Sunshine time | min/h | Direct sunlight, also depends on day length | 1h, day | min/Interval |
History Solar
The History Solar data package contains historical data of specific solar radiation variables for the solar energy sector.
| Variable | Units | Description | Intervals | Aggregations (day) |
|---|---|---|---|---|
| GHI (solar radiation) | W/m$^2$, J/cm | Global horizontal radiation | 1h, day | Sum, backwards |
| DIF | W/m$^2$, J/cm | Diffuse radiation | 1h, day | Sum, backwards |
| DNI | W/m$^2$, J/cm | Direct normalized irradiance (radiation) | 1h, day | Sum, backwards |
| GNI | W/m$^2$, J/cm | Global normalized irradiance (radiation) | 1h, day | Sum, backwards |
| Extraterrestrial radiation | W/m$^2$, J/cm | Extraterrestrial solar radiation | 1h, day | Sum, backwards |
History Photovoltaic
The History Photovoltaic data package contains historical data of solar power production, based on kilowatt peak as well as panel inclination and orientation.
| Variable | Units | Description | Intervals | Aggregations (day) |
|---|---|---|---|---|
| PV power | kWh | Photovoltaic power backwards | 1h, day | sum |
Special Parameters:
| Name | Description | Example | Default |
|---|---|---|---|
| Kwp | Kilowatt peak production | &kwp=1 | Null |
| Slope | Inclination of solar panel | &slope=20 | Null |
| Facing | Orientation of solar panel | &facing=180 | Null |
| Power efficiency | Power efficiency of pv module | &power_efficiency=0.9 | 0.85 |
| Tracker | For solar panels using a sun tracker* | &tracker=1 | Null |
* Sun Tracker Definition:
| Mode | Description |
|---|---|
| 1 | Daily vertical axis tracker |
| 2 | Daily 2-axis tracker |
| 3 | Yearly horizontal tracker |
| 4 | Daily DNI tracker |
| 5 | Daily horizontal axis tracker |
History Precipitation Single Model
The History Precipitation Single Model data package contains historical precipitation data from a single weather model domain.
| Variable | Units | Description | Intervals | Aggregations (day) |
|---|---|---|---|---|
| Precipitation | mm, inch | Water amount | 1h, day | Sum |
Required parameter:
| Name | Description | Example | Default |
|---|---|---|---|
| Domain | Model domain from which the data is desired | &domain=NEMS4 | Mandatory parameter |
More information about the available domains is available here.
Climate Data Packages
The climate data packages are giving back long term averages of the last 35 years to describe the climate conditions of a specific location.
Modelclimate
The Modelclimate data package contains climate simulation data of the last 35 years.
| Variable | Units | Description |
|---|---|---|
| Precipitation monthly mean | mm, inch | |
| Temperature monthly mean | °C, °F | |
| Temperature mean monthly max | °C, °F | "Hot days" |
| Temperature mean monthly min | °C, °F | "Cold days" |
| Temperature mean daily max | °C, °F | |
| Temperature mean daily min | °C, °F | |
| Wind speed monthly mean | m/s, km/h, kn, mph, bf | |
| Wind speed mean monthly max | m/s, km/h, kn, mph, bf | "Windy days" |
| Wind speed mean monthly min | m/s, km/h, kn, mph, bf | |
| Wind speed mean daily max | m/s, km/h, kn, mph, bf | |
| Wind speed mean daily min | m/s, km/h, kn, mph, bf | |
| Precipitation days monthly mean | 0 - 31 | Number of days with more than 0.2 mm precipitation |
| Snow days monthly mean | 0 - 31 | |
| Frost days monthly mean | 0 - 31 | Number of days with temperatures below 0°C |
| Sunshine days monthly mean | 0 - 31 | Number of sunshine days per month |
| Cloudy days monthly mean | 0 - 31 | Number of cloudy days per month |
| Overcast days monthly mean | 0 - 31 | Number of overcast days per month |
Climate Wind Rose
The Climate Wind Rose data package contains historical data of wind speed and direction over 30 years, and describes how many hours per year the wind blows from the indicated direction and at the indicated speed. The data is accumulated from 30 years of historical weather simulation data from the global meteoblue model NEMSGLOBAL, which has a resolution of 30km.
Example SW: Wind is blowing from South-West (SW) to North-East (NE).
Example URL: http://my.meteoblue.com/yearlyarchive/windrose?lat=47.558&lon=7.573&format=json&apikey=DEMOKEY