/climate/tmy
Typical meteorological year (TMY) for a location.
query Parameters
lat
number · double · min: -90 · max: 90 · requiredLatitude in degrees (North is positive).
Example: 47.3768lon
number · double · min: -180 · max: 180 · requiredLongitude in degrees (East is positive).
Example: 8.5417altitude
string · pattern:^(auto|-?[0-9]+(\.[0…
Altitude in meters above mean sea level or "auto".
Example: 549Default: autosurface_azimuth
number · 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 westExample: 1860surface_tilt
number · double · max: 90Tilt angle of the surface.
• 0° = horizontal
• 90° = verticalsituation
string · enumLocal terrain situation.
Enum values:opendepressioncold_air_lakesea_lakecityslope_southslope_west_eastvalleyDefault: openhorizon
string · 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.Example: 0,0,0,2,4,4,6,10,...,9,7,8,6,5,3,0Default: flatparameters
stringComma-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_albedo
number · double · min: 0.05 · max: 0.9Fixed albedo to use. If not set, a default albedo of 0.2 is assumed and albedo changes due to snow fall are modelled.
Default: 0.2turbidity
string · 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.Example: 5.2,4,3,3.1,3.0,2.8,3.14,3.0,3,3,4,5Default: autofrequency
string · enumTemporal resolution of the resulting time series.
Enum values:1_hour1_minuteDefault: 1_hourresponse_format
string · enumResponse data format.
Enum values:jsonDefault: jsonradiation_minute_model
string · enumRadiation model to be used for minute computation. This option has only an effect when computing minute time series.
Enum values:remundDefault: remunddiffuse_radiation_model
string · enumAlgorithm to be used to compute diffuse irradiance from global irradiance.
Enum values:perezDefault: pereztilt_radiation_model
string · enumAlgorithm to be used to compute tilted irradiance.
Enum values:perezDefault: perezrandom_seed
integer · max: 1000Random seed to be used for stochastic processes. Two identical requests with the same random seed will yield identical results.
clear_sky_radiation_model
string · enumAlgorithm to be used to compute clear sky irradiance
Enum values:esrasolisDefault: esraextreme_setting
string · enumProbability-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 winterEnum values:noneDefault: nonedata_version
string · enumVersion of Meteonorm climatological data to be used. Allows to compute TMYs based on the data of older Meteonorm versions.
Enum values:latestv9.0Default: latestfuture_scenario
string · enumFuture climate scenario.
Enum values:nonessp1_26ssp2_45ssp3_70Default: nonefuture_year
integer · min: 2030 · max: 2090Central year for a 20-year reference period in the future.
Default: 2050
Responses
start_times
string[] · requiredStart or end date/time of each time series interval.
end_times
string[] · requiredStart or end date/time of each time series interval.
values
object · requiredTime series values.
quality_parameters
object · requiredmeta
object · required