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
Default: 0

SurfaceTilt

number · double · max: 90

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

Default: 0

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

HorizonElevation

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 | null · double · min: 0.05 · max: 0.9

Local albedo

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
Default: 0

ExtremeSetting

string · enum
Enum values:
none
Default: none

ResponseFormat

string · enum
Enum values:
json
tmy3
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

ValuesClimate

  • global_horizontal_irradiance(number | null)[] · required
  • global_horizontal_irradiance_with_shading(number | null)[] · required
  • direct_horizontal_irradiance(number | null)[] · required
  • direct_horizontal_irradiance_with_shading(number | null)[] · required
  • diffuse_horizontal_irradiance(number | null)[] · required
  • diffuse_horizontal_irradiance_with_shading(number | null)[] · required
  • direct_normal_irradiance(number | null)[] · required
  • direct_normal_irradiance_with_shading(number | null)[] · required
  • global_tilted_irradiance(number | null)[] · required
  • global_tilted_irradiance_with_shading(number | null)[] · required
  • direct_tilted_irradiance(number | null)[] · required
  • direct_tilted_irradiance_with_shading(number | null)[] · required
  • diffuse_tilted_irradiance(number | null)[] · required
  • diffuse_tilted_irradiance_with_shading(number | null)[] · required
  • pv_production(number | null)[] · required
  • pv_production_with_shading(number | null)[] · required
  • global_clear_sky_irradiance(number | null)[] · required
  • direct_horizontal_clear_sky_irradiance(number | null)[] · required
  • diffuse_clear_sky_irradiance(number | null)[] · required
  • direct_normal_clear_sky_irradiance(number | null)[] · required
  • precipitation(number | null)[] · required
  • temperature(number | null)[] · required
  • dew_point_temperature(number | null)[] · required
  • snow_depth(number | null)[] · required
  • global_extraterrestrial_irradiance(number | null)[] · required
  • global_extraterrestrial_normal_irradiance(number | null)[] · required
  • downwelling_longwave_irradiance(number | null)[] · required
  • upwelling_longwave_irradiance(number | null)[] · required
  • vertical_longwave_irradiance(number | null)[] · required
  • photo_active_irradiance(number | null)[] · required
  • radiation_balance(number | null)[] · required
  • global_illuminance(number | null)[] · required
  • direct_illuminance(number | null)[] · required
  • diffuse_illuminance(number | null)[] · required
  • linke_turbidity_factor(number | null)[] · required
  • aerosol_optical_depth(number | null)[] · required
  • cloud_cover(number | null)[] · required
  • albedo(number | null)[] · required
  • surface_temperature(number | null)[] · required
  • sky_temperature(number | null)[] · required
  • wet_bulb_temperature(number | null)[] · required
  • mixing_ratio(number | null)[] · required
  • relative_humidity(number | null)[] · required
  • precipitable_water(number | null)[] · required
  • driving_rain(number | null)[] · required
  • pressure(number | null)[] · required
  • wind_speed(number | null)[] · required
  • wind_direction(number | null)[] · required
  • solar_elevation(number | null)[] · required
  • solar_azimuth(number | null)[] · required

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 of a climate response.

  • quality_parametersobject · required
  • metaobject · required

ValuesForecast

  • global_horizontal_irradiance(number | null)[] · required
  • global_horizontal_irradiance_with_shading(number | null)[] · required
  • direct_horizontal_irradiance(number | null)[] · required
  • direct_horizontal_irradiance_with_shading(number | null)[] · required
  • diffuse_horizontal_irradiance(number | null)[] · required
  • diffuse_horizontal_irradiance_with_shading(number | null)[] · required
  • direct_normal_irradiance(number | null)[] · required
  • direct_normal_irradiance_with_shading(number | null)[] · required
  • global_tilted_irradiance(number | null)[] · required
  • global_tilted_irradiance_with_shading(number | null)[] · required
  • direct_tilted_irradiance(number | null)[] · required
  • direct_tilted_irradiance_with_shading(number | null)[] · required
  • diffuse_tilted_irradiance(number | null)[] · required
  • diffuse_tilted_irradiance_with_shading(number | null)[] · required
  • pv_production(number | null)[] · required
  • pv_production_with_shading(number | null)[] · required
  • global_clear_sky_irradiance(number | null)[] · required
  • precipitation(number | null)[] · required
  • temperature(number | null)[] · required
  • dew_point_temperature(number | null)[] · required
  • snow_depth(number | null)[] · required
  • cloud_cover(number | null)[] · required
  • relative_humidity(number | null)[] · required
  • pressure(number | null)[] · required
  • wind_speed(number | null)[] · required
  • wind_direction(number | null)[] · required
  • wind_gusts(number | null)[] · required
  • weather_symbolinteger[] · 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 of a forecast response.

  • metaobject · required

ValuesObservation

  • global_horizontal_irradiance(number | null)[] · required
  • global_horizontal_irradiance_with_shading(number | null)[] · required
  • direct_horizontal_irradiance(number | null)[] · required
  • direct_horizontal_irradiance_with_shading(number | null)[] · required
  • diffuse_horizontal_irradiance(number | null)[] · required
  • diffuse_horizontal_irradiance_with_shading(number | null)[] · required
  • direct_normal_irradiance(number | null)[] · required
  • direct_normal_irradiance_with_shading(number | null)[] · required
  • global_tilted_irradiance(number | null)[] · required
  • global_tilted_irradiance_with_shading(number | null)[] · required
  • direct_tilted_irradiance(number | null)[] · required
  • direct_tilted_irradiance_with_shading(number | null)[] · required
  • diffuse_tilted_irradiance(number | null)[] · required
  • diffuse_tilted_irradiance_with_shading(number | null)[] · required
  • pv_production(number | null)[] · required
  • pv_production_with_shading(number | null)[] · required
  • global_clear_sky_irradiance(number | null)[] · required
  • temperature(number | null)[] · required
  • snow_depth(number | null)[] · 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 of an observation response.

  • metaobject · required

TimePoints

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
    Default: 0
  • surface_tiltnumber · double · max: 90 · required

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

    Default: 0
  • 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 · double

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]