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) The latitude of the desired location. Decimal format, up to 2 decimal places. For example 39.92
  • longitude (required) The longitude of the desired location. Decimal format, up to 2 decimal places. For example 116.41

Query parameters

  • hours Forecast hours, supports 1-60 hours, default is 24. For example: hours=12
  • interval Interval of forecast data, supports 15, 30, 60 minutes, default is 60. For example: interval=15
  • tilt The tilt angle of the PV system (range 0-90, integer). Required when extra=poa. For example: tilt=30
  • azimuth The azimuth angle of the PV system (range 0-359, integer, 0 = North). Required when extra=poa. For example: azimuth=180
  • extra Additional information provided for the current solar radiation forecast, optional weather (basic weather data) and poa (plane of array irradiance, must pass both tilt and azimuth), multiple items are separated by commas. For example: extra=weather
  • localTime Whether to return local time for the requested location. true returns local time; false returns UTC time (default).

Request example#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/solarradiation/v1/forecast/39.92/116.41?hours=24&interval=60&tilt=0&azimuth=0&extra=string&localTime=false'

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 Response metadata
    • tag string Unique tag for this 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