API Documentation

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.
Code(sh)
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"

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

Code(sh)
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"

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.

Last modified on