Querying Climate Data

There are two ways to query climate data from the Meteonorm API:

  1. /climate/tmy. Typical meteorological years, based on climatological data.
  2. /climate/historic. Historical time series, based on measurements (ground stations and satellites) and reanalysis data. COMING SOON.

TMYs

Here's how you generate a TMY for:

  • a south-facing (180°) surface with a tilt of 30°,
  • a temporal resolution (frequency) of 1 minute,
  • parameters global horizontal and tilted irradiance, PV production, and temperature,
  • taking into account shading caused by the surrounding terrain/horizon.
PARAMETERS="global_horizontal_irradiance,\
global_horizontal_irradiance_with_shading,\
global_tilted_irradiance,\
global_tilted_irradiance_with_shading,\
pv_production,\
pv_production_with_shading,\
temperature"

curl -H "Authorization: Bearer demo0000-0000-0000-0000-000000000000" \
    --get \
    --data "lat=50" \
    --data "lon=10" \
    --data "surface_azimuth=180" \
    --data "surface_tilt=30" \
    --data "horizon=auto" \
    --data "frequency=1_minute" \
    --data "parameters=$PARAMETERS" \
    "https://demo.meteonorm.com/v1/climate/tmy"
sh

To generate a TMY for, e.g., the year 2060 based on climate change scenario SSP245, use the arguments future_scenario and future_year:

curl -H "Authorization: Bearer demo0000-0000-0000-0000-000000000000" \
    --get \
    --data "lat=50" \
    --data "lon=10" \
    --data "future_scenario=ssp2_45" \
    --data "future_year=2060" \
    --data "parameters=global_horizontal_irradiance,temperature,precipitation" \
    "https://demo.meteonorm.com/v1/climate/tmy"
sh

See the API Reference for a complete list of options.

Note: These examples use our demo API URL. No registration required! See Free lat/lon locations for more information on how you can test the Meteonorm API free of charge. For operational use, replace demo.meteonorm.com with api.meteonorm.com.