Skip to content

Forecast Data API

Get irradiance, weather and power forecasts from the present time up to 14 days ahead for the requested location, derived from satellite (clouds and irradiance over non-polar continental areas, nowcasted for approx. four hours ahead) and numerical weather models (other data and longer horizons).


The module ForecastClient has the following available methods:

Endpoint Purpose API Docs
GetRadiationAndWeather Get irradiance and weather forecasts for the requested location from the present up to 14 days ahead, derived from satellite (clouds and irradiance over non-polar continental areas, now casted for approx. four hours ahead) and numerical weather models (other data and longer horizons). details
GetRooftopPvPower Get basic rooftop PV power forecasts from the present time up to 14 days ahead for the requested location, derived from satellite (clouds and irradiance over non-polar continental areas, nowcasted for approx. four hours ahead) and numerical weather models (other data and longer horizons). The basic rooftop power simulation is only suitable for residential and smaller C&I rooftop sites, not for grid-scale sites. Attention hobbyist users If you have a hobbyist user account please use the Rooftop Sites (Hobbyist) endpoints. details
GetAdvancedPvPower Get high-spec PV power forecasts for the requested site from the present up to 14 days ahead, derived from satellite (clouds and irradiance over non-polar continental areas, nowcasted for approx. four hours ahead) and numerical weather models (other data and longer horizons). details

GetRadiationAndWeather

Parameters: latitude, longitude, hours, period, tilt, azimuth, arrayType, outputParameters, terrainShading, format

Example Usage:

using Solcast.Clients;

var forecastClient = new ForecastClient();
var response = await forecastClient.GetRadiationAndWeather(
    latitude: -33.856784,
    longitude: 151.215297,
    period: "PT30M",
    tilt: 30.0f,
    azimuth: 180.0f,
    format: "csv"
);
Console.WriteLine(response.RawResponse);
Sample Output:

air_temp dni ghi period_end period
21 0 80 2024-11-13T06:00:00Z PT30M
21 0 78 2024-11-13T06:30:00Z PT30M
... ... ... ... ...
19 0 267 2024-11-15T05:30:00Z PT30M
19 0 217 2024-11-15T06:00:00Z PT30M

GetRooftopPvPower

Parameters: latitude, longitude, capacity, hours, period, tilt, azimuth, installDate, lossFactor, outputParameters, terrainShading, format

Example Usage:

using Solcast.Clients;

var forecastClient = new ForecastClient();
var response = await forecastClient.GetRooftopPvPower(
    latitude: -33.856784,
    longitude: 151.215297,
    capacity: 5.0f,
    format: "csv"
);
Console.WriteLine(response.RawResponse);
Sample Output:

pv_power_rooftop period_end period
0.244 2024-11-13T06:00:00Z PT30M
0.234 2024-11-13T06:30:00Z PT30M
... ... ...
1.059 2024-11-15T05:30:00Z PT30M
0.846 2024-11-15T06:00:00Z PT30M

GetAdvancedPvPower

Parameters: resourceId, hours, outputParameters, period, applyAvailability, applyConstraint, applyDustSoiling, applySnowSoiling, applyTrackerInactive, terrainShading, format

Example Usage:

using Solcast.Clients;

var forecastClient = new ForecastClient();
var response = await forecastClient.GetAdvancedPvPower(
    resourceId: "ba75-e17a-7374-95ed",
    format: "csv"
);
Console.WriteLine(response.RawResponse);
Sample Output:

pv_power_advanced period_end period
0.857 2024-11-13T06:00:00Z PT30M
0.865 2024-11-13T06:30:00Z PT30M
... ... ...
6.599 2024-11-20T05:30:00Z PT30M
5.916 2024-11-20T06:00:00Z PT30M