Technical Documentation

Technical Documentation

  • Weather APIs
  • Services
  • Meteo
  • Blog

›Package API

Introduction

  • Overview
  • Availability

API+

  • Introduction
  • API Key Management
  • Forecast API Configurator

Package API

  • Introduction
  • Forecast Data
  • History & Climate Data

Image API

  • Introduction
  • Forecast Images
  • History & Climate Images

Dataset API

  • Dataset API
  • Dataset API Configurator

Maps API

  • Overview
  • Maps API Configurator
  • Maps Plugin
  • Tile API
  • Radar and Satellite Tile API
  • Inventory API
  • Time API
  • Weather Model Domains
  • Examples

Further APIs

  • Location Search API
  • Account API
  • PNG Maps API

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.

Example URL: http://my.meteoblue.com/packages/historybasic-1h_historybasic-day?lat=47.558&lon=7.573&startdate=2020-01-01&enddate=2020-01-31&apikey=DEMOKEY

VariableUnitsDescriptionIntervalsAggregations (day)
Temperature°C, °F2m above ground1h, dayMin, max, mean
Sea level pressurehPaCorrected for sea level1h, dayMin, max, mean
Precipitationmm, inchWater amount1h, daySum
Snow fraction0, 1information whether precipitation fell as rain or snow: 0 = rain, 1 = snow1h, dayHourly: 0 or 1, aggregations: range from 0 till 1 (mean of hourly values)
Wind direction°, 2 char, 3 char10m above ground1h, dayDominant
Wind speedm/s, km/h, kn, mph, bf10m above ground1h, dayMin, max, mean
Relative humidity%Air humidity1h, dayMin, max, mean

History Agro

The History Agro data package contains historical data of soil and vegetation related weather variables.

Example URL: http://my.meteoblue.com/packages/historyagro-1h_historyagro-day?lat=47.558&lon=7.573&startdate=2020-01-01&enddate=2020-01-31&apikey=DEMOKEY

VariableUnitsDescriptionIntervalsAggregations (day)
Soil temperature (0 - 10 cm)°C, °FAssuming typical soil1h, dayMin, max, mean
Soil moisture (0 - 10 cm)%Assuming typical soil1h, dayMin, max, mean
Skin / surface temperature°C, °FSoil surface or skin1h, dayMin, max, mean
EvapotranspirationmmAssuming typical soil and vegetation1h, daySum
Reference evapotranspiration (ET$_0$)mm1h, daySum
Dewpoint temperature°C, °F2m above ground1h, dayMin, max, mean
Wetbulb temperature°C, °F2m above ground1h, dayMin, max, mean

History Wind

The History Wind data package contains historical data of specific wind variables for the wind energy sector.

Example URL: http://my.meteoblue.com/packages/historywind-1h_historywind-day?lat=47.558&lon=7.573&startdate=2020-01-01&enddate=2020-01-31&apikey=DEMOKEY

VariableUnitsDescriptionIntervalsAggregations (day)
Wind speed 80mm/s, km/h, kn, bf, mph80m above ground1h, dayMin, max, mean
Wind direction 80m°, 2 char 3 char80m above ground1h, dayDominant
Wind gustsm/s, km/h, kn, bf, mphm/s, km/h, kn, bf, mph1h, dayMin, max, mean

History Wind Power

The History Wind Power data package contains historical data of wind power at a height of 80m.

Example URL: http://my.meteoblue.com/packages/historywindpower-1h?lat=47.558&lon=7.573&turbineid=-1&kwp=10&startdate=2020-01-01&enddate=2020-01-31&apikey=DEMOKEY

VariableUnitsDescriptionIntervals
Wind PowerkW80m above ground1h

Special Parameters:

NameDescriptionExampleDefault
Turbine IDTurbine type*&turbineid=-1Mandatory parameter
Power efficiencyPower efficiency of wind turbine&power_efficiency=0.91
Number of turbinesNumber of turbinesnumberofturbines=101
Kwp**Kilowatt peak production&kwp=11

* 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.

Example URL: http://my.meteoblue.com/packages/historyclouds-1h_historyclouds-day?lat=47.558&lon=7.573&startdate=2020-01-01&enddate=2020-01-31&apikey=DEMOKEY

VariableUnitsDescriptionIntervalsAggregations (day)
Total cloud cover%Cover of the sky, analogue to METAR 0 - 81h, dayMin, max, mean
Low clouds%Cover of the sky1h, dayMin, max, mean
Mid clouds%Cover of the sky1h, dayMin, max, mean
High clouds%Cover of the sky1h, dayMin, max, mean
Sunshine timemin/hDirect sunlight, also depends on day length1h, daymin/Interval

History Solar

The History Solar data package contains historical data of specific solar radiation variables for the solar energy sector.

Example URL: http://my.meteoblue.com/packages/historysolar-1h_historysolar-day?lat=47.558&lon=7.573&startdate=2020-01-01&enddate=2020-01-31&apikey=DEMOKEY

VariableUnitsDescriptionIntervalsAggregations (day)
GHI (solar radiation)W/m$^2$, J/cmGlobal horizontal radiation1h, daySum, backwards
DIFW/m$^2$, J/cmDiffuse radiation1h, daySum, backwards
DNIW/m$^2$, J/cmDirect normalized irradiance (radiation)1h, daySum, backwards
GNIW/m$^2$, J/cmGlobal normalized irradiance (radiation)1h, daySum, backwards
Extraterrestrial radiationW/m$^2$, J/cmExtraterrestrial solar radiation1h, daySum, 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.

Example URL: http://my.meteoblue.com/packages/historypv-1h_historypv-day?lat=47.558&lon=7.573&startdate=2020-01-01&enddate=2020-01-31&kwp=1&slope=20&facing=180&power_efficiency=0.9&tracker=1&apikey=DEMOKEY

VariableUnitsDescriptionIntervalsAggregations (day)
PV powerkWhPhotovoltaic power backwards1h, daysum

Special Parameters:

NameDescriptionExampleDefault
KwpKilowatt peak production&kwp=1Null
SlopeInclination of solar panel&slope=20Null
FacingOrientation of solar panel&facing=180Null
Power efficiencyPower efficiency of pv module&power_efficiency=0.90.85
TrackerFor solar panels using a sun tracker*&tracker=1Null

* Sun Tracker Definition:

ModeDescription
1Daily vertical axis tracker
2Daily 2-axis tracker
3Yearly horizontal tracker
4Daily DNI tracker
5Daily horizontal axis tracker

History Precipitation Single Model

The History Precipitation Single Model data package contains historical precipitation data from a single weather model domain.

Example URL: http://my.meteoblue.com/packages/historyprecipsinglemodel-1h_historyprecipsinglemodel-day?lat=47.558&lon=7.573&domain=NEMS4&startdate=2020-01-01&enddate=2020-01-31&apikey=DEMOKEY

VariableUnitsDescriptionIntervalsAggregations (day)
Precipitationmm, inchWater amount1h, daySum

Required parameter:

NameDescriptionExampleDefault
DomainModel domain from which the data is desired&domain=NEMS4Mandatory 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

Example URL: http://my.meteoblue.com/packages/modelclimate-day?lat=47.558&lon=7.573&domain=NEMS4&startdate=2020-01-01&enddate=2020-01-31&apikey=DEMOKEY

The Modelclimate data package contains climate simulation data of the last 35 years.

VariableUnitsDescription
Precipitation monthly meanmm, 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 meanm/s, km/h, kn, mph, bf
Wind speed mean monthly maxm/s, km/h, kn, mph, bf"Windy days"
Wind speed mean monthly minm/s, km/h, kn, mph, bf
Wind speed mean daily maxm/s, km/h, kn, mph, bf
Wind speed mean daily minm/s, km/h, kn, mph, bf
Precipitation days monthly mean0 - 31Number of days with more than 0.2 mm precipitation
Snow days monthly mean0 - 31
Frost days monthly mean0 - 31Number of days with temperatures below 0°C
Sunshine days monthly mean0 - 31Number of sunshine days per month
Cloudy days monthly mean0 - 31Number of cloudy days per month
Overcast days monthly mean0 - 31Number 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

Last updated on 1/24/2023
← Forecast DataIntroduction →
  • Historical Data Packages
    • History Basic
    • History Agro
    • History Wind
    • History Wind Power
    • History Clouds
    • History Solar
    • History Photovoltaic
    • History Precipitation Single Model
  • Climate Data Packages
    • Modelclimate
    • Climate Wind Rose
meteoblue
WebsiteB2C ProductsAPI ProductsAPI Pricing
Weather APIs
IntroductionAPI+Package APIImage APIDataset APIMaps APIFurther APIs
Services
EnergyWeather StationsClimateOther Transmissions
Meteo
VariablesData Sources
Other
BlogContact
Imprint | Privacy | Contact | ISO 9001:2015 certificate
meteoblue AG © 2006 - 2023