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
Querying climate dataQuerying forecasts