Solar Solar Radiation Data

Solar Radiation (‘Weather’) Sites

Creation of weather sites (see docs here) gives the greatest accuracy for specific locations. This is typically the best approach when you have a small to medium number (say ~< 100) of pre-known, fixed sites where accuracy is of prime importance. You can also add a test site using the Solcast API Toolkit

Simple Lat/Lon Radiation Requests

What is the Simple Radiation Request?

The Simple Radiation request returns detailed solar radiation data for the next week based only on your latitude and longitude. The past 7 days of estimated actuals are also available. This request will give slightly lower accuracy than site-based requests, but it is great for large numbers of sites, and where sites need to be easily added or changed instantly. You can test this request under your Free plan, and if you need to scale it up you can contact us to get bulk pricing options under an Enterprise plan - see pricing and plans for details.

What data is provided by the API?

The data in each row are 30 minute period end averages and are in UTC. The data is updated every 10 to 15 minutes.

More details can be found in our Solar Radiation API Documentation and OpenAPI definition.

A Solar Radiation Forecast Request Returns the Following Parameters

Property Description
ghi Global Horizontal Irradiance (W/m2) - centre value (mean)
ghi10 Global Horizontal Irradiance (W/m2) - 10th percentile value (low scenario)
ghi90 Global Horizontal Irradiance (W/m2) - 90th percentile value (high scenario)
dni Direct Normal Irradiance (W/m2) - centre value (mean)
dni10 Direct Normal Irradiance (W/m2) - 10th percentile value (low scenario)
dni90 Direct Normal Irradiance (W/m2) - 90th percentile value (high scenario)
dhi Diffuse Horizontal Irradiance
air_temp Air temperature (degrees Celsius)
zenith Solar zenith angle (degrees). Zero means directly upwards/overhead. Varies from 0 to 180. A value of 90 means the sun is at the horizon.
azimuith Solar azimuth angle (degrees). Zero means true north. Vaies from -180 to 180. A value of 90 means the sun is in the east.
cloud_opacity The attenuation of incoming light due to cloud. Varies from 0 (no cloud) to 100 (full attenuation of incoming light).
period_end End of the averaging period in ISO8601 datetime format in UTC timezone.
period Length of the averaging period in ISO8601 duration format.

A Solar Radiation Estimated Actuals Request Returns the Following Parameters

Property Description
ghi Global Horizontal Irradiance (W/m2) - centre value (mean)
dni Direct Normal Irradiance (W/m2) - centre value (mean)
dhi Diffuse Horizontal Irradiance
cloud_opacity The attenuation of incoming light due to cloud. Varies from 0 (no cloud) to 100 (full attenuation of incoming light).
period_end End of the averaging period in ISO8601 datetime format in UTC timezone.
period Length of the averaging period in ISO8601 duration format.

GET Request (Forecast)

Please note you’ll need to place your API Key in the below GET request at “YOUR_API_KEY”.

GET https://api.solcast.com.au/world_radiation/forecasts?longitude=149.117&latitude=-35.277&format=json&api_key=YOUR_API_KEY

GET Request Return (Forecast)

{
  "forecasts": [{
      "ghi": 690,
      "ghi90": 802,
      "ghi10": 537,
      "ebh": 407,
      "dni": 501,
      "dni10": 334,
      "dni90": 792,
      "dhi": 283,
      "air_temp": 37,
      "zenith": 37,
      "azimuth": 72,
      "cloud_opacity": 35,
      "period_end": "2017-01-30T05:00:00.0000000Z",
      "period": "PT30M"
    }, {
      "ghi": 422,
      "ghi90": 707,
      "ghi10": 141,
      "ebh": 56,
      "dni": 78,
      "dni10": 3,
      "dni90": 722,
      "dhi": 366,
      "air_temp": 37,
      "zenith": 43,
      "azimuth": 78,
      "cloud_opacity": 81,
      "period_end": "2017-01-30T05:30:00.0000000Z",
      "period": "PT30M"
    }
  ]
}

GET Request (Estimated Actuals)

Please note you’ll need to place your API Key in the below GET request at “YOUR_API_KEY”.

GET https://api.solcast.com.au/world_radiation/estimated_actuals?longitude=149.117&latitude=-35.277&api_key=YOUR_API_KEY

GET Request Return (Estimated Actuals)

{
  "estimated_actuals": [{
      "ghi": 640,
      "dni": 803,
      "dhi": 124,
      "cloud_opacity": 0,
      "period_end": "2017-01-29T23:00:00.0000000Z",
      "period": "PT30M"
    }, {
      "ghi": 543,
      "dni": 769,
      "dhi": 113,
      "cloud_opacity": 0,
      "period_end": "2017-01-29T22:30:00.0000000Z",
      "period": "PT30M"
    }
  ]
}