Meteonorm API

climate

Endpoint:https://api.meteonorm.com/v1

/climate/tmy

GET
https://api.meteonorm.com/v1
/climate/tmy

Typical meteorological year (TMY) for a location.

/climate/tmy › query Parameters

  • latnumber · double · min: -90 · max: 90 · required

    Latitude in degrees (North is positive).

    Example: 47.3768
  • lonnumber · double · min: -180 · max: 180 · required

    Longitude in degrees (East is positive).

    Example: 8.5417
  • altitudestring · pattern: ^(auto|-?[0-9]+(\.[0…

    Altitude in meters above mean sea level or "auto".

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

    Example: 549
    Default: auto
  • surface_azimuthnumber · double · max: 360

    Azimuth angle of the surface.
    • 0° = oriented towards the north
    • 90° = oriented towards the east
    • 180° = oriented towards the south
    • 270° = oriented towards the west

    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

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

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

    Default: 0
  • situationstring · enum

    Local terrain situation.

    Local terrain situation.

    Enum values:
    open
    depression
    cold_air_lake
    sea_lake
    city
    slope_south
    slope_west_east
    valley
    Default: open
  • horizonstring · pattern: ^(auto|flat|[0-9]+(,…

    Horizon of the requested location.
    • flat: Flat horizon (all horizon elevations are 0°).
    • auto: Horizon is determined automatically using a high-resolution digital elevation model with a spatial resolution of approx. 30m.
    • [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.

    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
  • parametersstring

    Comma-separated list of parameter names, or the string "all".

    Parameters:
    • global_horizontal_irradiance
    • global_horizontal_irradiance_with_shading
    • direct_horizontal_irradiance
    • direct_horizontal_irradiance_with_shading
    • diffuse_horizontal_irradiance
    • diffuse_horizontal_irradiance_with_shading
    • direct_normal_irradiance
    • direct_normal_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
    • global_clear_sky_irradiance
    • direct_horizontal_clear_sky_irradiance
    • diffuse_clear_sky_irradiance
    • direct_normal_clear_sky_irradiance
    • precipitation
    • temperature
    • dew_point_temperature
    • snow_depth
    • global_extraterrestrial_irradiance
    • global_extraterrestrial_normal_irradiance
    • downwelling_longwave_irradiance
    • upwelling_longwave_irradiance
    • vertical_longwave_irradiance
    • photo_active_irradiance
    • radiation_balance
    • global_illuminance
    • direct_illuminance
    • diffuse_illuminance
    • linke_turbidity_factor
    • aerosol_optical_depth
    • cloud_cover
    • albedo
    • surface_temperature
    • sky_temperature
    • wet_bulb_temperature
    • mixing_ratio
    • relative_humidity
    • precipitable_water
    • driving_rain
    • pressure
    • wind_speed
    • wind_direction
    • solar_elevation
    • solar_azimuth

    Example: global_horizontal_irradiance,global_tilted_irradiance,temperature
    Default: global_horizontal_irradiance,diffuse_horizontal_irradiance,direct_normal_irradiance,temperature
  • fixed_albedonumber | null · double · min: 0.05 · max: 0.9

    Specifies a fixed albedo value. If not provided, a default albedo of 0.2 is used, with snow cover dynamically influencing the albedo.

    Local albedo

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

    Monthly mean atmospheric Linke turbidity.

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

    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
  • frequencystring · enum

    Temporal resolution of the resulting time series.

    Enum values:
    1_hour
    1_minute
    Default: 1_hour
  • response_formatstring · enum

    Response data format.

    Enum values:
    csv
    epw
    json
    pvsyst
    tmy3
    pvsol
    polysun
    ida_ice_v4
    Default: json
  • radiation_minute_modelstring · enum

    Radiation model to be used for minute computation. This option has only an effect when computing minute time series.

    Enum values:
    remund
    Default: remund
  • diffuse_radiation_modelstring · enum

    Algorithm to be used to compute diffuse irradiance from global irradiance.

    Enum values:
    perez
    Default: perez
  • tilt_radiation_modelstring · enum

    Algorithm to be used to compute tilted irradiance.

    Enum values:
    perez
    Default: perez
  • random_seedinteger · max: 1000

    Random seed to be used for stochastic processes. Two identical requests with the same random seed will yield identical results.

    Default: 0
  • clear_sky_radiation_modelstring · enum

    Algorithm to be used to compute clear sky irradiance

    Enum values:
    esra
    solis
    Default: esra
  • extreme_settingstring · enum

    Probability-of-exceedance (PoE) reference used to generate TMY GHI and temperature.

    • none: Uses median PoE50 values
    • (coming soon) poe_10_year: Uses annual PoE10 (90th percentile) values
    • (coming soon) poe_90_year: Uses annual PoE90 (10th percentile) values
    • (coming soon) poe_10_months: Uses monthly PoE10 values
    • (coming soon) poe_90_months: Uses monthly PoE90 values
    • (coming soon) worst_case_year: Uses a combination of PoE10 in summer and PoE90 in winter

    Enum values:
    none
    poe_10_year
    poe_90_year
    poe_10_months
    poe_90_months
    worst_case_year
    Default: none
  • data_versionstring · enum

    Version of Meteonorm climatological data to be used. Allows to compute TMYs based on the data of older Meteonorm versions.

    Enum values:
    latest
    v9.0
    Default: latest
  • future_scenariostring · enum

    Future climate scenario.

    Enum values:
    none
    ssp1_26
    ssp2_45
    ssp3_70
    Default: none
  • future_yearinteger · enum

    Central year for a 20-year reference period in the future.

    Enum values:
    2030
    2040
    2050
    2060
    2070
    2080
    2090
    Default: 2050

/climate/tmy › Responses

OK

  • start_timesstring[] · required

    Start or end ISO 8601 date-time strings of each time series interval.

  • end_timesstring[] · required

    Start or end ISO 8601 date-time strings of each time series interval.

  • valuesobject · required

    Time series of a climate response.

  • quality_parametersobject · required

    Quality parameters for the TMY climate data.

  • metaobject · required

/climate/amy

GET
https://api.meteonorm.com/v1
/climate/amy

Actual meteorological year (AMY) for a location. Available time period: from 2020 onwards. AMY that include the past month are only available on the 8th day of the current month.

/climate/amy › query Parameters

  • latnumber · double · min: -90 · max: 90 · required

    Latitude in degrees (North is positive).

    Example: 47.3768
  • lonnumber · double · min: -180 · max: 180 · required

    Longitude in degrees (East is positive).

    Example: 8.5417
  • startstring · pattern: ^[0-9]{4}-[0-9]{2}$ · required

    Start month of an actual meteorological year (AMY).

    A year-month string in the format YYYY-MM.

    Examples:

    2020-01
    2023-12

    Example: 2020-01
  • altitudestring · pattern: ^(auto|-?[0-9]+(\.[0…

    Altitude in meters above mean sea level or "auto".

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

    Example: 549
    Default: auto
  • surface_azimuthnumber · double · max: 360

    Azimuth angle of the surface.
    • 0° = oriented towards the north
    • 90° = oriented towards the east
    • 180° = oriented towards the south
    • 270° = oriented towards the west

    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

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

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

    Default: 0
  • situationstring · enum

    Local terrain situation.

    Local terrain situation.

    Enum values:
    open
    depression
    cold_air_lake
    sea_lake
    city
    slope_south
    slope_west_east
    valley
    Default: open
  • horizonstring · pattern: ^(auto|flat|[0-9]+(,…

    Horizon of the requested location.
    • flat: Flat horizon (all horizon elevations are 0°).
    • auto: Horizon is determined automatically using a high-resolution digital elevation model with a spatial resolution of approx. 30m.
    • [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.

    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
  • parametersstring

    Comma-separated list of parameter names, or the string "all".

    Parameters:
    • global_horizontal_irradiance
    • global_horizontal_irradiance_with_shading
    • direct_horizontal_irradiance
    • direct_horizontal_irradiance_with_shading
    • diffuse_horizontal_irradiance
    • diffuse_horizontal_irradiance_with_shading
    • direct_normal_irradiance
    • direct_normal_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
    • global_clear_sky_irradiance
    • direct_horizontal_clear_sky_irradiance
    • diffuse_clear_sky_irradiance
    • direct_normal_clear_sky_irradiance
    • precipitation
    • temperature
    • dew_point_temperature
    • snow_depth
    • global_extraterrestrial_irradiance
    • global_extraterrestrial_normal_irradiance
    • downwelling_longwave_irradiance
    • upwelling_longwave_irradiance
    • vertical_longwave_irradiance
    • photo_active_irradiance
    • radiation_balance
    • global_illuminance
    • direct_illuminance
    • diffuse_illuminance
    • linke_turbidity_factor
    • aerosol_optical_depth
    • cloud_cover
    • albedo
    • surface_temperature
    • sky_temperature
    • wet_bulb_temperature
    • mixing_ratio
    • relative_humidity
    • precipitable_water
    • driving_rain
    • pressure
    • wind_speed
    • wind_direction
    • solar_elevation
    • solar_azimuth

    Example: global_horizontal_irradiance,global_tilted_irradiance,temperature
    Default: global_horizontal_irradiance,diffuse_horizontal_irradiance,direct_normal_irradiance,temperature
  • fixed_albedonumber | null · double · min: 0.05 · max: 0.9

    Specifies a fixed albedo value. If not provided, a default albedo of 0.2 is used, with snow cover dynamically influencing the albedo.

    Local albedo

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

    Monthly mean atmospheric Linke turbidity.

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

    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
  • frequencystring · enum

    Temporal resolution of the resulting time series.

    Enum values:
    1_hour
    1_minute
    Default: 1_hour
  • response_formatstring · enum

    Response data format.

    Enum values:
    csv
    json
    Default: json
  • radiation_minute_modelstring · enum

    Radiation model to be used for minute computation. This option has only an effect when computing minute time series.

    Enum values:
    remund
    Default: remund
  • diffuse_radiation_modelstring · enum

    Algorithm to be used to compute diffuse irradiance from global irradiance.

    Enum values:
    perez
    Default: perez
  • tilt_radiation_modelstring · enum

    Algorithm to be used to compute tilted irradiance.

    Enum values:
    perez
    Default: perez
  • clear_sky_radiation_modelstring · enum

    Algorithm to be used to compute clear sky irradiance

    Enum values:
    esra
    solis
    Default: esra

/climate/amy › Responses

OK

  • start_timesstring[] · required

    Start or end ISO 8601 date-time strings of each time series interval.

  • end_timesstring[] · required

    Start or end ISO 8601 date-time strings of each time series interval.

  • valuesobject · required

    Time series of a climate response.

  • metaobject · required
forecast