Solar Radiation Forecast

Provide solar radiation forecasts and related data at 15-minute intervals for any location worldwide, up to 60 hours ahead, with a spatial resolution of 1×1 km.

Endpoint#

GET /solarradiation/v1/forecast/{latitude}/{longitude}

Parameters#

Path parameters

  • latitude required
    number
    Latitude of the requested location in decimal degrees
  • longitude required
    number
    Longitude of the requested location in decimal degrees

Query parameters

  • hours
    integer
    Forecast hours, supports 1-60 hours, default is 24. For example: hours=12
  • interval
    integer
    Interval of forecast data, supports 15, 30, 60 minutes, default is 60. For example: interval=15
  • tilt
    integer
    The tilt angle of the PV system (range 0-90, integer). Required when extra=poa. For example: tilt=30
  • azimuth
    integer
    The azimuth angle of the PV system (range 0-359, integer, 0 = North). Required when extra=poa. For example: azimuth=180
  • extra
    string
    Additional data to include in the solar radiation forecast response. Supported values: weather (basic weather data) and poa (plane-of-array irradiance; requires both tilt and azimuth). Separate multiple values with commas. Example: extra=weather
  • localTime
    boolean

    Whether to return local time for the requested location

    Possible values: false UTC time (default), true location's local time

Request example#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/solarradiation/v1/forecast/39.92/116.41'

Replace your_token and your_api_host with your JWT Authentication and API Host

Try it

Response#

{
  "metadata": {
    "tag": "c4ca4238a0b923820dcc509a6f75849b"
  },
  "forecasts": [
    {
      "forecastTime": "2023-10-15T11:30Z",
      "solarAngle": {
        "azimuth": 184,
        "elevation": 40
      },
      "dni": {
        "value": 25.16,
        "unit": "W/m²"
      },
      "dhi": {
        "value": 136.29,
        "unit": "W/m²"
      },
      "ghi": {
        "value": 152.57,
        "unit": "W/m²"
      },
      "weather": {
        "temperature": {
          "value": 18.6,
          "unit": "°C"
        },
        "windSpeed": {
          "value": 2.78,
          "unit": "m/s"
        },
        "humidity": 76
      },
      "poa": {
        "global": {
          "value": 134.39,
          "unit": "W/m²"
        },
        "direct": {
          "value": 9.35,
          "unit": "W/m²"
        },
        "diffuse": {
          "value": 125.04,
          "unit": "W/m²"
        },
        "reflected": {
          "value": 1.52,
          "unit": "W/m²"
        }
      }
    },
    {
      "forecastTime": "2023-10-15T11:45Z",
      "solarAngle": {
        "azimuth": 189,
        "elevation": 40
      },
      "dni": {
        "value": 20.71,
        "unit": "W/m²"
      },
      "dhi": {
        "value": 132.14,
        "unit": "W/m²"
      },
      "ghi": {
        "value": 145.47,
        "unit": "W/m²"
      },
      "weather": {
        "temperature": {
          "value": 18.27,
          "unit": "°C"
        },
        "windSpeed": {
          "value": 2.98,
          "unit": "m/s"
        },
        "humidity": 76
      },
      "poa": {
        "global": {
          "value": 128.26,
          "unit": "W/m²"
        },
        "direct": {
          "value": 7.28,
          "unit": "W/m²"
        },
        "diffuse": {
          "value": 120.98,
          "unit": "W/m²"
        },
        "reflected": {
          "value": 1.45,
          "unit": "W/m²"
        }
      }
    },
    {
      "forecastTime": "2023-10-15T12:00Z",
      "solarAngle": {
        "azimuth": 194,
        "elevation": 40
      },
      "dni": {
        "value": 15.58,
        "unit": "W/m²"
      },
      "dhi": {
        "value": 127.72,
        "unit": "W/m²"
      },
      "ghi": {
        "value": 137.65,
        "unit": "W/m²"
      },
      "weather": {
        "temperature": {
          "value": 17.94,
          "unit": "°C"
        },
        "windSpeed": {
          "value": 3.17,
          "unit": "m/s"
        },
        "humidity": 76
      },
      "poa": {
        "global": {
          "value": 121.85,
          "unit": "W/m²"
        },
        "direct": {
          "value": 5.14,
          "unit": "W/m²"
        },
        "diffuse": {
          "value": 116.72,
          "unit": "W/m²"
        },
        "reflected": {
          "value": 1.37,
          "unit": "W/m²"
        }
      }
    },
    {
      "forecastTime": "2023-10-15T12:15Z",
      "solarAngle": {
        "azimuth": 198,
        "elevation": 39
      },
      "dni": {
        "value": 10.1,
        "unit": "W/m²"
      },
      "dhi": {
        "value": 124.08,
        "unit": "W/m²"
      },
      "ghi": {
        "value": 130.43,
        "unit": "W/m²"
      },
      "weather": {
        "temperature": {
          "value": 17.63,
          "unit": "°C"
        },
        "windSpeed": {
          "value": 3.3,
          "unit": "m/s"
        },
        "humidity": 76
      },
      "poa": {
        "global": {
          "value": 118.87,
          "unit": "W/m²"
        },
        "direct": {
          "value": 3.1,
          "unit": "W/m²"
        },
        "diffuse": {
          "value": 115.77,
          "unit": "W/m²"
        },
        "reflected": {
          "value": 1.3,
          "unit": "W/m²"
        }
      }
    }
  ]
}
  • metadata
    object
    Metadata for this response
    • tag
      string
      Unique data identifier
    • attributions
      array
      Data attribution or statements that must be displayed with the response data
  • forecasts
    array
    Solar irradiance forecast data
    • forecastTime
      date-time
      Forecast time in ISO 8601 format
    • solarAngle
      object
      Solar angle
      • azimuth
        number
        Solar azimuth angle, 0 degree for North
      • elevation
        number
        Solar elevation angle
    • dni
      object
      Direct normal irradiance
      • value
        number
        Value
      • unit
        string
        Unit
    • dhi
      object
      Diffuse horizontal irradiance
      • value
        number
        Value
      • unit
        string
        Unit
    • ghi
      object
      Global horizontal irradiance
      • value
        number
        Value
      • unit
        string
        Unit
    • weather
      object
      Weather data. Returned only when extra=weather
      • temperature
        object
        Temperature
        • value
          number
          Value
        • unit
          string
          Unit
      • windSpeed
        object
        Wind speed
        • value
          number
          Value
        • unit
          string
          Unit
      • humidity
        number
        Relative humidity
    • poa
      object
      Plane-of-array irradiance. Returned only when extra=poa
      • global
        object
        Global irradiance for the plane-of-array
        • value
          number
          Value
        • unit
          string
          Unit
      • direct
        object
        Direct solar radiation for the plane-of-array
        • value
          number
          Value
        • unit
          string
          Unit
      • diffuse
        object
        Diffuse solar radiation for the plane-of-array
        • value
          number
          Value
        • unit
          string
          Unit
      • reflected
        object
        Reflected irradiance for the plane-of-array
        • value
          number
          Value
        • unit
          string
          Unit