Meteonorm API

​observation

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

​/observation/realtime

GET
https://api.meteonorm.com/v1
/observation/realtime

Real-time irradiance data for the past 7 days, based on weather satellites. Updated every 15 minutes.

​/observation/realtime › 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
  • 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
    • temperature
    • snow_depth

    Example: global_horizontal_irradiance,global_tilted_irradiance,temperature
    Default: global_horizontal_irradiance,temperature
  • startstring · pattern: ^now|[-\+]\d+(hours|…

    Start time (UTC) of observation/realtime time series.

    Either an ISO 8601 date-time string in the format YYYY-mm-ddTHH:MMZ or YYYY-mm-ddTHH:MM:SSZ, or a relative date/time string (relative with respect to the current time).

    Examples:

    now
    -24hours
    -5days
    2025-05-15T12:00Z
    2025-05-15T12:00:00Z

    Example: 2025-01-15T12:00Z
    Default: -24hours
  • endstring · pattern: ^now|[-\+]\d+(hours|…

    End time (UTC) of observation time series.

    Either an ISO 8601 date-time string in the format YYYY-mm-ddTHH:MMZ or YYYY-mm-ddTHH:MM:SSZ, or a relative date/time string (relative with respect to the current time).

    Examples:

    now
    -3hours
    -1days
    2025-05-15T12:00Z
    2025-05-15T12:00:00Z

    Example: 2025-01-15T12:00Z
    Default: now
  • frequencystring · enum

    Temporal resolution of the resulting time series.

    Enum values:
    1_hour
    15_minutes
    1_minute
    Default: 15_minutes
  • 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

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

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

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

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

​/observation/realtime › Responses

    • 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

​/observation/training

GET
https://api.meteonorm.com/v1
/observation/training

Available time period: from 2010 until now.

​/observation/training › 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
  • 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
    • temperature
    • snow_depth

    Example: global_horizontal_irradiance,global_tilted_irradiance,temperature
    Default: global_horizontal_irradiance,temperature
  • startstring · pattern: ^now|[-\+]\d+(hours|…

    Start time (UTC) of observation/training time series.

    Either an ISO 8601 date-time string in the format YYYY-mm-ddTHH:MMZ or YYYY-mm-ddTHH:MM:SSZ, or a relative date/time string (relative with respect to the current time).

    Examples:

    2025-05-15T12:00Z
    2025-05-15T12:00:00Z -200days

    Example: 2025-01-15T12:00Z
    Default: -365days
  • endstring · pattern: ^now|[-\+]\d+(hours|…

    End time (UTC) of observation time series.

    Either an ISO 8601 date-time string in the format YYYY-mm-ddTHH:MMZ or YYYY-mm-ddTHH:MM:SSZ, or a relative date/time string (relative with respect to the current time).

    Examples:

    2025-05-15T12:00Z
    2025-05-15T12:00:00Z -200days

    Example: 2025-01-15T12:00Z
    Default: -7days
  • frequencystring · enum

    Temporal resolution of the resulting time series.

    Enum values:
    1_hour
    15_minutes
    1_minute
    Default: 15_minutes
  • 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

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

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

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

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

​/observation/training › Responses

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