Meteonorm API

​forecast

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

​/forecast/basic

GET
https://api.meteonorm.com/v1
/forecast/basic

Solar forecast with medium accuracy. Based on global numerical weather prediction models.

​/forecast/basic › 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
    • precipitation
    • temperature
    • dew_point_temperature
    • snow_depth
    • cloud_cover
    • relative_humidity
    • pressure
    • wind_speed
    • wind_direction
    • wind_gusts
    • weather_symbol

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

    Start time (UTC) of the forecast 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 (note that the plus sign must be url-encoded):

    now
    +12hours
    2025-05-15T12:00Z
    2025-05-15T12:00:00Z

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

    End time (UTC) of the forecast 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 (note that the plus sign must be url-encoded):

    +3hours
    +72hours
    +7days
    2025-05-15T12:00Z
    2025-05-15T12:00:00Z

    Example: 2025-01-15T12:00Z
    Default: +3days
  • 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

​/forecast/basic › 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

​/forecast/precision

GET
https://api.meteonorm.com/v1
/forecast/precision

Solar forecast with high accuracy. For the next few hours, the forecast is based on our nowcasting technology.

​/forecast/precision › 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
    • precipitation
    • temperature
    • dew_point_temperature
    • snow_depth
    • cloud_cover
    • relative_humidity
    • pressure
    • wind_speed
    • wind_direction
    • wind_gusts
    • weather_symbol

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

    Start time (UTC) of the forecast 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 (note that the plus sign must be url-encoded):

    now
    +12hours
    2025-05-15T12:00Z
    2025-05-15T12:00:00Z

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

    End time (UTC) of the forecast 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 (note that the plus sign must be url-encoded):

    +3hours
    +72hours
    +7days
    2025-05-15T12:00Z
    2025-05-15T12:00:00Z

    Example: 2025-01-15T12:00Z
    Default: +3days
  • 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

​/forecast/precision › 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
climateobservation