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/realtime time series. The end time is exclusive.

    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.

    Time series frequency

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

    Response data format.

    Enum values:
    json
    csv
    Default: json
  • 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
  • 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

/observation/realtime › Responses

Response

  • 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 an observation response.

  • metaobject · required

/observation/training

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

Available time period: the current year excluding the last 7 days, plus the latest two full calendar years.

/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
  • response_formatstring · enum

    Response data format.

    Enum values:
    json
    csv
    Default: json
  • endstring · pattern: ^now|[-\+]\d+(hours|…

    End time (UTC) of observation/training time series. The end time is exclusive.

    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.

    Time series frequency

    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

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

/observation/training › Responses

Response

  • 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 an observation response.

  • metaobject · required

/observation/historical

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

Historical irradiance based on weather satellites and re-analysis products. Available time period: from 2020 onwards, excluding the last 7 days.

/observation/historical › 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: ^now|[-\+]\d+(hours|… · required

    Start time (UTC) of observation/historical 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: 2020-01-15T12:00Z
  • endstring · pattern: ^now|[-\+]\d+(hours|… · required

    End time (UTC) of observation/historical time series. The end time is exclusive.

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

    Temporal resolution of the resulting time series.

    Time series frequency

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

    Response data format.

    Enum values:
    json
    csv
    Default: json
  • 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
  • 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

/observation/historical › Responses

Response

  • 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 an observation response.

  • metaobject · required
forecasthorizon