/climate/tmy
Typical meteorological year (TMY) for a location.
A request costs 500 Meteonorm API tokens.
query Parameters
latnumber · double · min: -90 · max: 90 · requiredLatitude in degrees (North is positive).
Example: 47.3768lonnumber · double · min: -180 · max: 180 · requiredLongitude in degrees (East is positive).
Example: 8.5417altitudestring · 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: 549Default: autosurface_azimuthnumber · double · max: 360Azimuth angle of the surface.
• 0° = oriented towards the north
• 90° = oriented towards the east
• 180° = oriented towards the south
• 270° = oriented towards the westOrientation 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 westExample: 186Default: 0surface_tiltnumber · double · max: 90Tilt angle of the surface.
• 0° = horizontal
• 90° = verticalTilt angle of the solar panel.
• 0° = horizontal
• 90° = verticalDefault: 0situationstring · enumLocal terrain situation.
•
open: Open site, open terrain, north facing incline, no raised skyline. Applies to most sites.
•depression: Depression or very flat valley floor, in which cold air collects. In Switzerland, for example, particularly in the Jura and the Alps.
•cold_air_lake: Extensively cold hollows (above 1000 m).
•sea_lake: Shore of sea or larger lake (up to 1 km from the shore).
•city: Centre of a larger city (over 100’000 inhabitants).
•slope_south: South facing incline (more than approx. 10° inclination, facing between SE–S–SW). At least 200 m above valley floor.
•slope_west_east: West or east facing incline (more than approx. 10° inclination, facing between SW–W–NW or NE–E–SE). At least 200 m above valley floor.
•valley: Valley floor in mountainous valley at higher altitudes. Valley floor inclined (flat valleys are often treated as depressions).
•valley_foehn: Valley floor of Föhn valley (regions with warm descending air currents).
•valley_central_alps: Floor of large central Alpine valley (e.g., Alpine regions of Valais, Switzerland).
•valley_alpine_foothills: Valley floor in northern Alpine foothills.
•valley_slope_south: South facing incline (more than approx. 10° inclination, facing between SE–S–SW) up to 200 m above valley.
•valley_slope_west_east: West or east facing incline (more than approx. 10° inclination, facing between SW–W–NW or NE–E–SE) up to 200 m above valley floor.
•summit: Open summit above 500 m. Overlooking surroundings in all directions.Enum values:opendepressioncold_air_lakesea_lakecityslope_southslope_west_eastvalleyDefault: openhorizonstring · 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,0Default: flatparametersstringComma-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_azimuthExample: global_horizontal_irradiance,global_tilted_irradiance,temperatureDefault: global_horizontal_irradiance,diffuse_horizontal_irradiance,direct_normal_irradiance,temperaturefixed_albedonumber | null · double · min: 0.05 · max: 0.9Specifies 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,5Default: autofrequencystring · enumTemporal resolution of the resulting time series.
Enum values:1_hour1_minuteDefault: 1_hourresponse_formatstring · enumResponse data format.
Enum values:csvepwjsonpvsysttmy3pvsolpolysuntrjDefault: jsonradiation_minute_modelstring · enumRadiation model to be used for minute computation. This option has only an effect when computing minute time series.
Enum values:remundDefault: remunddiffuse_radiation_modelstring · enumAlgorithm to be used to compute diffuse irradiance from global irradiance.
Enum values:perezDefault: pereztilt_radiation_modelstring · enumAlgorithm to be used to compute tilted irradiance.
Enum values:perezDefault: perezrandom_seedinteger · max: 1000Random seed to be used for stochastic processes. Two identical requests with the same random seed will yield identical results.
Default: 0clear_sky_radiation_modelstring · enumAlgorithm to be used to compute clear sky irradiance
Enum values:esrasolisDefault: esraextreme_settingstring · enumProbability-of-exceedance (PoE) reference used to generate TMY GHI and temperature.
• none: Uses median PoE50 values
• poe_10_year: Uses annual PoE10 (90th percentile) values
• poe_90_year: Uses annual PoE90 (10th percentile) values
• poe_10_months: Uses monthly PoE10 values
• poe_90_months: Uses monthly PoE90 values
• worst_case_year: Uses a combination of PoE10 in summer and PoE90 in winter (worst case heating/cooling load with cold/dark winter and hot/sunny summer)Enum values:nonepoe_10_yearpoe_90_yearpoe_10_monthspoe_90_monthsworst_case_yearDefault: nonefuture_scenariostring · enumFuture climate scenario.
• none: climate reference period is 2001–2020.
• ssp1_26: Shared Socioeconomic Pathway (as defined by the IPCC) SSP1-2.6.
• ssp1_45: Shared Socioeconomic Pathway (as defined by the IPCC) SSP1-4.5.
• ssp1_70: Shared Socioeconomic Pathway (as defined by the IPCC) SSP1-7.0.Enum values:nonessp1_26ssp2_45ssp3_70Default: nonefuture_yearinteger · enumMiddle year of a 20-year reference period in the future. For example, the year 2040 represents the period 2031–2050.
Enum values:2030204020502060207020802090Default: 2050
Responses
OK
start_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
end_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
valuesobject · requiredTime series of a climate response.
quality_parametersobject · requiredQuality parameters for the TMY climate data.
metaobject · required
/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.
A request costs 1000 Meteonorm API tokens.
query Parameters
latnumber · double · min: -90 · max: 90 · requiredLatitude in degrees (North is positive).
Example: 47.3768lonnumber · double · min: -180 · max: 180 · requiredLongitude in degrees (East is positive).
Example: 8.5417startstring · pattern:^[0-9]{4}-[0-9]{2}$· requiredStart month of an actual meteorological year (AMY).
A year-month string in the format YYYY-MM.
Examples:
2020-01
2023-12Example: 2020-01altitudestring · 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: 549Default: autosurface_azimuthnumber · double · max: 360Azimuth angle of the surface.
• 0° = oriented towards the north
• 90° = oriented towards the east
• 180° = oriented towards the south
• 270° = oriented towards the westOrientation 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 westExample: 186Default: 0surface_tiltnumber · double · max: 90Tilt angle of the surface.
• 0° = horizontal
• 90° = verticalTilt angle of the solar panel.
• 0° = horizontal
• 90° = verticalDefault: 0situationstring · enumLocal terrain situation.
•
open: Open site, open terrain, north facing incline, no raised skyline. Applies to most sites.
•depression: Depression or very flat valley floor, in which cold air collects. In Switzerland, for example, particularly in the Jura and the Alps.
•cold_air_lake: Extensively cold hollows (above 1000 m).
•sea_lake: Shore of sea or larger lake (up to 1 km from the shore).
•city: Centre of a larger city (over 100’000 inhabitants).
•slope_south: South facing incline (more than approx. 10° inclination, facing between SE–S–SW). At least 200 m above valley floor.
•slope_west_east: West or east facing incline (more than approx. 10° inclination, facing between SW–W–NW or NE–E–SE). At least 200 m above valley floor.
•valley: Valley floor in mountainous valley at higher altitudes. Valley floor inclined (flat valleys are often treated as depressions).
•valley_foehn: Valley floor of Föhn valley (regions with warm descending air currents).
•valley_central_alps: Floor of large central Alpine valley (e.g., Alpine regions of Valais, Switzerland).
•valley_alpine_foothills: Valley floor in northern Alpine foothills.
•valley_slope_south: South facing incline (more than approx. 10° inclination, facing between SE–S–SW) up to 200 m above valley.
•valley_slope_west_east: West or east facing incline (more than approx. 10° inclination, facing between SW–W–NW or NE–E–SE) up to 200 m above valley floor.
•summit: Open summit above 500 m. Overlooking surroundings in all directions.Enum values:opendepressioncold_air_lakesea_lakecityslope_southslope_west_eastvalleyDefault: openhorizonstring · 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,0Default: flatparametersstringComma-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_azimuthExample: global_horizontal_irradiance,global_tilted_irradiance,temperatureDefault: global_horizontal_irradiance,diffuse_horizontal_irradiance,direct_normal_irradiance,temperaturefixed_albedonumber | null · double · min: 0.05 · max: 0.9Specifies 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,5Default: autofrequencystring · enumTemporal resolution of the resulting time series.
Enum values:1_hour1_minuteDefault: 1_hourresponse_formatstring · enumResponse data format.
Enum values:csvjsonDefault: jsonradiation_minute_modelstring · enumRadiation model to be used for minute computation. This option has only an effect when computing minute time series.
Enum values:remundDefault: remunddiffuse_radiation_modelstring · enumAlgorithm to be used to compute diffuse irradiance from global irradiance.
Enum values:perezDefault: pereztilt_radiation_modelstring · enumAlgorithm to be used to compute tilted irradiance.
Enum values:perezDefault: perezclear_sky_radiation_modelstring · enumAlgorithm to be used to compute clear sky irradiance
Enum values:esrasolisDefault: esra
Responses
OK
start_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
end_timesstring[] · requiredStart or end ISO 8601 date-time strings of each time series interval.
valuesobject · requiredTime series of a climate response.
metaobject · required