API Documentation

Querying Observations

Irradiance and Expected PV Production

The /observation/realtime endpoint provides near real-time irradiance measurements. The following request returns

  • various irradiance parameters and the "expected" PV production,
  • for a south-facing (180°) solar panel with a tilt of 25°,
  • for the past 24 hours,
  • 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,\ direct_tilted_irradiance,\ direct_tilted_irradiance_with_shading,\ diffuse_tilted_irradiance,\ diffuse_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 "start=-24hours" \ --data "end=now" \ --data "surface_azimuth=180" \ --data "surface_tilt=25" \ --data "horizon=auto" \ --data "parameters=$PARAMETERS" \ "https://demo.meteonorm.com/v1/observation/realtime"

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.

Training Data for ML Models

The /observation/training endpoint provides the same parameters as /observation/realtime, but for a longer time period, i.e., for the current year excluding the last 7 days, plus the last two full calendar years.

Code(sh)
PARAMETERS="global_horizontal_irradiance,\ global_horizontal_irradiance_with_shading,\ global_tilted_irradiance,\ global_tilted_irradiance_with_shading,\ direct_tilted_irradiance,\ direct_tilted_irradiance_with_shading,\ diffuse_tilted_irradiance,\ diffuse_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 "start=-365days" \ --data "end=-7days" \ --data "surface_azimuth=180" \ --data "surface_tilt=25" \ --data "horizon=auto" \ --data "parameters=$PARAMETERS" \ "https://demo.meteonorm.com/v1/observation/training"
Last modified on