Solcast
solcastSolar resource assessment and forecasting data for irradiance and PV power, globally.
Acciones disponibles (6)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Get Historic Radiation And WeatherSOLCAST_GET_DATA_HISTORIC_RADIATION_AND_WEATHERAcciónTool to get historical irradiance and weather estimated actuals for a requested location. Use when you need historical solar radiation and weather data from 2007-01-01 to 7 days ago, for up to 31 days at a time.
SOLCAST_GET_DATA_HISTORIC_RADIATION_AND_WEATHERAcciónTool to get historical irradiance and weather estimated actuals for a requested location. Use when you need historical solar radiation and weather data from 2007-01-01 to 7 days ago, for up to 31 days at a time.
Parámetros de entrada
endstringISO 8601 ending datetime. Must be within 31 days of start date. Timezone handling same as start. Mutually exclusive with duration parameter.
tiltnumberPanel tilt angle in degrees from horizontal. Must be between 0 and 90. Defaults based on latitude if unspecified.
startstringObligatorioISO 8601 compliant starting datetime for historical data (e.g., '2024-11-15T00:00:00Z'). If no timezone specified, inferred from time_zone parameter; otherwise UTC assumed.
formatstringenumResponse format. Valid values: 'json' or 'csv'. Defaults to 'json'.
jsoncsvperiodstringAveraging period length in ISO 8601 format (e.g., 'PT5M' for 5 minutes, 'PT30M' for 30 minutes, 'PT1H' for 1 hour).
azimuthnumberPanel azimuth angle from true north in degrees. Defaults vary by hemisphere if unspecified.
durationstringISO 8601 duration format (e.g., 'P7D' for 7 days, 'P1M' for 1 month). Must be within 31 days of start date. Mutually exclusive with end parameter.
latitudenumberObligatorioLocation latitude in decimal degrees. Must be between -90 and 90, where north is positive.
longitudenumberObligatorioLocation longitude in decimal degrees. Must be between -180 and 180, where east is positive.
time_zonestringTimezone specification. Accepted values: 'utc', 'longitudinal', or range -13 to 13 in 0.25 hour increments (e.g., '10' for UTC+10).
array_typestringSun-tracking or geometry configuration type (e.g., 'fixed', 'horizontal_single_axis').
terrain_shadingbooleanApply terrain-based irradiance modifications using 90m-resolution elevation model.
output_parametersstring[]Specific output parameters to include in response (e.g., 'ghi', 'dni', 'dhi', 'air_temp', 'wind_speed_10m'). If not specified, all available parameters are returned.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get PV Power ResourceSOLCAST_GET_RESOURCES_PV_POWER_SITEAcciónTool to retrieve a specific PV power resource by its unique identifier. Use when you need to fetch complete resource configuration including capacity, orientation, tracking, and derating parameters.
SOLCAST_GET_RESOURCES_PV_POWER_SITEAcciónTool to retrieve a specific PV power resource by its unique identifier. Use when you need to fetch complete resource configuration including capacity, orientation, tracking, and derating parameters.
Parámetros de entrada
resource_idstringObligatorioThe unique identifier of the resource to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Resources PV Power SitesSOLCAST_GET_RESOURCES_PV_POWER_SITESAcciónTool to list PV power resources available to authenticated user. Use when you need to retrieve the list of PV power sites with optional filtering by entitlement level.
SOLCAST_GET_RESOURCES_PV_POWER_SITESAcciónTool to list PV power resources available to authenticated user. Use when you need to retrieve the list of PV power sites with optional filtering by entitlement level.
Parámetros de entrada
entitlementstringenumFilter for site entitlement level. Valid values: 'advanced' or 'premium'.
advancedpremium
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Patch PV Power ResourceSOLCAST_PATCH_RESOURCES_PV_POWER_SITEAcciónTool to partially update an existing PV power resource's technical specifications. Use when you need to modify specific resource configuration fields without replacing the entire resource.
SOLCAST_PATCH_RESOURCES_PV_POWER_SITEAcciónTool to partially update an existing PV power resource's technical specifications. Use when you need to modify specific resource configuration fields without replacing the entire resource.
Parámetros de entrada
namestringName of the PV power resource.
tiltnumberThe off-horizontal tilt angle of modules for fixed-tilt sites (degrees).
azimuthnumberThe angle from true north the modules are facing (degrees).
capacitynumberTotal AC inverter (nameplate) capacity in MW.
latitudenumberLocation latitude coordinate, between -90 and 90.
longitudenumberLocation longitude coordinate, between -180 and 180.
capacity_dcnumberTotal DC module capacity in MW.
entitlementstringenumSite entitlement level. Valid values: 'advanced' or 'premium'.
advancedpremiummodule_typestringPV module technology/material type (e.g., 'mono-si', 'poly-si', 'cdte', 'cigs', 'asi').
pvrow_widthnumberPV module row width in metres.
resource_idstringObligatorioThe unique identifier of the resource to update.
install_datestringSystem installation date in ISO 8601 format for age-based derating calculations.
pvrow_heightnumberPV module row height above ground in metres.
terrain_slopenumberAverage terrain slope in degrees.
tracking_typestringSun-tracking configuration type (e.g., 'fixed', 'horizontal_single_axis').
bifacial_systembooleanEnable bifacial module modeling for rear-side power generation.
terrain_azimuthnumberTerrain downhill direction angle from true north (degrees).
grid_export_limitnumberMaximum power export to grid in MW.
bifaciality_factornumberRear-to-front module efficiency ratio (0 to 1).
confirmed_metadatastringMetadata confirmation timestamp in ISO 8601 format.
site_ground_albedonumberGround surface reflectivity proportion (0 to 1).
derating_age_systemnumberAnnual system degradation rate (fraction per year).
derating_temp_modulenumberTemperature coefficient of power (fraction per degree C).
dust_soiling_averagenumber[]Monthly dust soiling impact estimates as proportional losses (12 values, one per month).
tracker_axis_azimuthnumberHorizontal tracker axis azimuth angle from true north (degrees). For single-axis trackers.
derating_other_systemnumberTotal non-temperature system losses as a fraction (0 to 1).
ground_coverage_rationumberProportion of ground area covered by PV modules (0 to 1).
tracker_back_trackingbooleanEnable backtracking feature to avoid row-to-row shading.
tracker_smart_trackingbooleanEnable smart tracking to reposition trackers during cloudy periods.
inverter_peak_efficiencynumberPeak inverter conversion efficiency rating (0 to 1).
cloudy_zenith_coefficientsnumber[]Cloudy sky zenith angle coefficients for advanced modeling.
tracker_max_rotation_anglenumberMaximum off-horizontal rotation angle for trackers (degrees).
clearsky_zenith_coefficientsnumber[]Clear sky zenith angle coefficients for advanced modeling.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create PV Power ResourceSOLCAST_POST_RESOURCES_PV_POWER_SITEAcciónTool to create a new PV power resource for Advanced PV Power forecasting. Use when you need to add a new solar installation site with comprehensive technical specifications including capacity, orientation, tracking parameters, and derating factors.
SOLCAST_POST_RESOURCES_PV_POWER_SITEAcciónTool to create a new PV power resource for Advanced PV Power forecasting. Use when you need to add a new solar installation site with comprehensive technical specifications including capacity, orientation, tracking parameters, and derating factors.
Parámetros de entrada
namestringObligatorioName of the PV power resource.
tiltnumberThe off-horizontal tilt angle of modules for fixed-tilt sites (degrees).
azimuthnumberThe angle from true north the modules are facing (degrees). North is 0, South is ±180.
capacitynumberObligatorioTotal AC inverter (nameplate) capacity in MW.
latitudenumberObligatorioLocation latitude coordinate, between -90 and 90.
longitudenumberObligatorioLocation longitude coordinate, between -180 and 180.
capacity_dcnumberObligatorioTotal DC module capacity in MW.
entitlementstringenumSite entitlement level. Valid values: 'advanced' or 'premium'.
advancedpremiummodule_typestringPV module technology/material type (e.g., 'mono-si', 'poly-si', 'cdte', 'cigs', 'asi').
pvrow_widthnumberPV module row width in metres.
install_datestringObligatorioSystem installation date in ISO 8601 format for age-based derating calculations.
pvrow_heightnumberPV module row height above ground in metres.
terrain_slopenumberGround terrain slope angle in degrees.
tracking_typestringObligatorioSun-tracking configuration type (e.g., 'fixed', 'horizontal_single_axis', 'dual_axis').
bifacial_systembooleanEnable bifacial module modeling for rear-side power generation.
terrain_azimuthnumberDirection of terrain slope from true north (degrees).
grid_export_limitnumberMaximum power export to grid in MW.
bifaciality_factornumberRear-to-front module efficiency ratio (0 to 1).
confirmed_metadatastringMetadata confirmation timestamp in ISO 8601 format.
site_ground_albedonumberGround surface reflectivity proportion (0 to 1).
derating_age_systemnumberAnnual system degradation rate (fraction per year).
derating_temp_modulenumberTemperature coefficient of power (fraction per degree C).
dust_soiling_averagenumber[]Monthly dust soiling impact estimates as proportional losses (12 values, one per month).
tracker_axis_azimuthnumberDirection tracking axis points from true north (degrees). For single-axis trackers.
derating_other_systemnumberTotal non-temperature system losses as a fraction (0 to 1).
ground_coverage_rationumberProportion of ground area covered by PV modules (0 to 1).
tracker_back_trackingbooleanEnable backtracking feature to avoid row-to-row shading.
tracker_smart_trackingbooleanEnable smart tracking to reposition trackers during cloudy periods.
inverter_peak_efficiencynumberPeak inverter conversion efficiency rating (0 to 1).
cloudy_zenith_coefficientsnumber[]Zenith angle coefficients for cloudy conditions for advanced modeling.
tracker_max_rotation_anglenumberMaximum rotation angle from horizontal for trackers (degrees).
clearsky_zenith_coefficientsnumber[]Zenith angle coefficients for clear sky conditions for advanced modeling.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update PV Power ResourceSOLCAST_PUT_RESOURCES_PV_POWER_SITEAcciónTool to update an existing PV power resource with comprehensive technical specifications for solar installation site modeling. Use when you need to modify resource configuration including capacity, orientation, tracking parameters, derating factors, and bifacial system settings.
SOLCAST_PUT_RESOURCES_PV_POWER_SITEAcciónTool to update an existing PV power resource with comprehensive technical specifications for solar installation site modeling. Use when you need to modify resource configuration including capacity, orientation, tracking parameters, derating factors, and bifacial system settings.
Parámetros de entrada
namestringName of the PV power resource.
tiltnumberThe off-horizontal tilt angle of modules for fixed-tilt sites (degrees).
azimuthnumberThe angle from true north the modules are facing (degrees).
capacitynumberTotal AC inverter (nameplate) capacity in MW.
latitudenumberLocation latitude coordinate, between -90 and 90.
longitudenumberLocation longitude coordinate, between -180 and 180.
capacity_dcnumberTotal DC module capacity in MW.
entitlementstringenumSite entitlement level. Valid values: 'advanced' or 'premium'.
advancedpremiummodule_typestringPV module technology/material type (e.g., 'mono-si', 'poly-si', 'cdte', 'cigs', 'asi').
pvrow_widthnumberPV module row width in metres.
resource_idstringObligatorioThe unique identifier of the resource to update.
install_datestringSystem installation date in ISO 8601 format for age-based derating calculations.
pvrow_heightnumberPV module row height above ground in metres.
terrain_slopenumberAverage terrain slope in degrees.
tracking_typestringSun-tracking configuration type (e.g., 'fixed', 'horizontal_single_axis').
bifacial_systembooleanEnable bifacial module modeling for rear-side power generation.
terrain_azimuthnumberTerrain downhill direction angle from true north (degrees).
grid_export_limitnumberMaximum power export to grid in MW.
bifaciality_factornumberRear-to-front module efficiency ratio (0 to 1).
confirmed_metadatastringMetadata confirmation timestamp in ISO 8601 format.
site_ground_albedonumberGround surface reflectivity proportion (0 to 1).
derating_age_systemnumberAnnual system degradation rate (fraction per year).
derating_temp_modulenumberTemperature coefficient of power (fraction per degree C).
dust_soiling_averagenumber[]Monthly dust soiling impact estimates as proportional losses (12 values, one per month).
tracker_axis_azimuthnumberHorizontal tracker axis azimuth angle from true north (degrees). For single-axis trackers.
derating_other_systemnumberTotal non-temperature system losses as a fraction (0 to 1).
ground_coverage_rationumberProportion of ground area covered by PV modules (0 to 1).
tracker_back_trackingbooleanEnable backtracking feature to avoid row-to-row shading.
tracker_smart_trackingbooleanEnable smart tracking to reposition trackers during cloudy periods.
inverter_peak_efficiencynumberPeak inverter conversion efficiency rating (0 to 1).
cloudy_zenith_coefficientsnumber[]Cloudy sky zenith angle coefficients for advanced modeling.
tracker_max_rotation_anglenumberMaximum off-horizontal rotation angle for trackers (degrees).
clearsky_zenith_coefficientsnumber[]Clear sky zenith angle coefficients for advanced modeling.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not