Meteonorm API

​Schemas

​ErrorResponse

  • errorobject · required

​Error

  • messagestring · required

​Latitude

number · double · min: -90 · max: 90
Example: 47.3768

​Longitude

number · double · min: -180 · max: 180
Example: 8.5417

​AltitudeOption

string · pattern: ^(auto|-?[0-9]+(\.[0…

Altitude in meters above sea level. • auto: Automatic • number: altitude in meters

Example: 549
Default: auto

​Altitude

number · double · min: -1000 · max: 10000

Altitude in meters above sea level.

​SurfaceAzimuth

number · double · max: 360

Orientation of the solar panel. North Azimuth.
Conventions:
• 0° = oriented towards the north
• 90° = oriented towards the east
• 180° = oriented towards the south
• 270° = oriented towards the west

Example: 186
0

​SurfaceTilt

number · double · max: 90

Tilt angle of the solar panel.
• 0° = horizontal
• 90° = vertical

​TimeZone

number · enum · double
Enum values:
-12
-11
-10
-9.5
-9
-8
-7
-6

UTC offset in hours.

​Horizon

string · pattern: ^(auto|flat|[0-9]+(,…

Horizon of the requested location.
• flat: Flat horizon (all values are 0°).
• auto: Horizon is determined automatically using a global 30m digital elevation model.
• [comma-separated values]
[comma-separated values]: provide 360 integer values representing elevation angles (in degrees) of the horizon in 360 directions. Elevation angles must be ≥0° and <90°. Index corresponds to azimuth:
Index 0 = 0° (North)
Index 90 = 90° (East)
Index 180 = 180° (South)
Index 270 = 270° (West)
Each value indicates the elevation angle at the corresponding azimuth.

Example: 0,0,0,2,4,4,6,10,...,9,7,8,6,5,3,0
Default: flat

​HorizonAzimuth

integer[] · minItems: 360 · maxItems: 360
integer

​HorizonElevation

integer[] · minItems: 360 · maxItems: 360
integer

​Situation

string · enum
Enum values:
open
depression
cold_air_lake
sea_lake
city
slope_south
slope_west_east
valley

Local terrain situation.

Default: open

​Albedo

number · double · min: 0.05 · max: 0.9

Local albedo

Default: 0.2

​Turbidity

string · pattern: ^(auto|[0-9]*\.?[0-9…

Monthly atmospheric turbidity.

• auto: turbidity is taken from the Meteonorm database.
• [comma-separated values]: 12 floating point values representing monthly atmospheric turbidity.

Example: 5.2,4,3,3.1,3.0,2.8,3.14,3.0,3,3,4,5
Default: auto

​DataVersion

string · enum
Enum values:
latest
v9.0
Default: latest

​FutureScenario

string · enum
Enum values:
none
ssp1_26
ssp2_45
ssp3_70
Default: none

​FutureYear

integer · min: 2030 · max: 2090
Default: 2050

​ClimateFrequency

string · enum
Enum values:
1_hour
1_minute
Default: 1_hour

​Frequency

string · enum
Enum values:
1_hour
15_minutes
1_minute

​RadiationMinuteModel

string · enum
Enum values:
remund
Default: remund

​DiffuseRadiationModel

string · enum
Enum values:
perez
Default: perez

​TiltRadiationModel

string · enum
Enum values:
perez
Default: perez

​ClearSkyModel

string · enum
Enum values:
esra
solis
Default: esra

​RandomSeed

integer · max: 1000

​ExtremeSetting

string · enum
Enum values:
none
Default: none

​ResponseFormat

string · enum
Enum values:
json
Default: json

​ClimateParameters

string
Example: global_horizontal_irradiance,global_tilted_irradiance,temperature
Default: global_horizontal_irradiance,diffuse_horizontal_irradiance,direct_normal_irradiance,temperature

​ForecastParameters

string
Example: global_horizontal_irradiance,global_tilted_irradiance,temperature
Default: global_horizontal_irradiance,temperature

​ObservationParameters

string
Example: global_horizontal_irradiance,global_tilted_irradiance,temperature
Default: global_horizontal_irradiance,temperature

​ClimateResponse

  • start_timesstring[] · required

    Start or end date/time of each time series interval.

  • end_timesstring[] · required

    Start or end date/time of each time series interval.

  • valuesobject · required

    Time series values.

  • quality_parametersobject · required
  • metaobject · required

​ForecastResponse

  • start_timesstring[] · required

    Start or end date/time of each time series interval.

  • end_timesstring[] · required

    Start or end date/time of each time series interval.

  • valuesobject · required

    Time series values.

  • metaobject · required

​ObservationResponse

  • start_timesstring[] · required

    Start or end date/time of each time series interval.

  • end_timesstring[] · required

    Start or end date/time of each time series interval.

  • valuesobject · required

    Time series values.

  • metaobject · required

​TimePoints

string[]
string · date-time

​TimePoint

string · date-time
Example: 2025-01-01T00:00:00Z

​Metadata

  • frequencystring · enum · required
    Enum values:
    1_hour
    15_minutes
    1_minute
  • parametersobject[] · required
  • latnumber · double · min: -90 · max: 90 · required
    Example: 47.3768
  • lonnumber · double · min: -180 · max: 180 · required
    Example: 8.5417
  • altitudenumber · double · min: -1000 · max: 10000 · required

    Altitude in meters above sea level.

  • surface_azimuthnumber · double · max: 360 · required

    Orientation of the solar panel. North Azimuth.
    Conventions:
    • 0° = oriented towards the north
    • 90° = oriented towards the east
    • 180° = oriented towards the south
    • 270° = oriented towards the west

    Example: 186
    0
  • surface_tiltnumber · double · max: 90 · required

    Tilt angle of the solar panel.
    • 0° = horizontal
    • 90° = vertical

  • time_zonenumber · enum · double

    UTC offset in hours.

    Enum values:
    -12
    -11
    -10
    -9.5
    -9
    -8
    -7
    -6

​Parameter

  • descriptionstring · required

    Description of parameter

    Example: Global horizontal irradiance
  • namestring · required

    unique name of parameter

    Example: global_horizontal_irradiance
  • unitobject · required
  • aggregation_methodstring · enum · required
    Enum values:
    average
    instant
    min
    max
    sum
    Example: average

​Values

number,null[]

​Unit

  • namestring · required

    string representation of unit

    Example: W/m**2
  • descriptionstring · required

    description of unit

    Example: Watt per square meter

​AltitudeResponse

  • altitudenumber · double · min: -1000 · max: 10000 · required

    Altitude in meters above sea level.

​HorizonResponse

  • azimuthinteger[] · minItems: 360 · maxItems: 360 · required

    Azimuth angles (in degrees) corresponding to horizon elevation angles in "HorizonElevation".

    0° = north, 90° = east, 180° = south, 270° = west.

  • elevationinteger[] · minItems: 360 · maxItems: 360 · required

    360 integer values representing elevation angles (0° to 90°) of the horizon. Array indices correspond to azimuths, e.g., Index 0 corresponds to azimuth 0°. Each value indicates the elevation angle at the corresponding azimuth. The given example corresponds to a "20° mountain" in the north and a flat horizon in all other directions.

    Example: [20,20,20,19,18,17,...,0,0,0,0,0,0,...,18,19,20,20,20,20]