API Overview

Querying Observations

Real-time Observations

The /observation/realtime endpoint provides near real-time irradiance measurements for the past 7 days. The following example 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.

Historical Observations

The /observation/historical 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, back to the year 2020.

The following example returns observations for the first half of 2020.

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=2020-01-01T00:00:00Z" \
    --data "end=2020-07-01T00:00:00Z" \
    --data "surface_azimuth=180" \
    --data "surface_tilt=25" \
    --data "horizon=auto" \
    --data "parameters=$PARAMETERS" \
    "https://demo.meteonorm.com/v1/observation/historical"
Last modified on
Querying climate dataQuerying forecasts