NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Solcast

solcast

Solar resource assessment and forecasting data for irradiance and PV power, globally.

AnalyticsDeveloper ToolsWeb del proveedor
Acciones
6
Triggers
0
Autenticación
—
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

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ón

Tool 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

  • endstring

    ISO 8601 ending datetime. Must be within 31 days of start date. Timezone handling same as start. Mutually exclusive with duration parameter.

  • tiltnumber

    Panel tilt angle in degrees from horizontal. Must be between 0 and 90. Defaults based on latitude if unspecified.

  • startstringObligatorio

    ISO 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.

  • formatstringenum

    Response format. Valid values: 'json' or 'csv'. Defaults to 'json'.

    jsoncsv
  • periodstring

    Averaging period length in ISO 8601 format (e.g., 'PT5M' for 5 minutes, 'PT30M' for 30 minutes, 'PT1H' for 1 hour).

  • azimuthnumber

    Panel azimuth angle from true north in degrees. Defaults vary by hemisphere if unspecified.

  • durationstring

    ISO 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.

  • latitudenumberObligatorio

    Location latitude in decimal degrees. Must be between -90 and 90, where north is positive.

  • longitudenumberObligatorio

    Location longitude in decimal degrees. Must be between -180 and 180, where east is positive.

  • time_zonestring

    Timezone specification. Accepted values: 'utc', 'longitudinal', or range -13 to 13 in 0.25 hour increments (e.g., '10' for UTC+10).

  • array_typestring

    Sun-tracking or geometry configuration type (e.g., 'fixed', 'horizontal_single_axis').

  • terrain_shadingboolean

    Apply 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

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get PV Power ResourceSOLCAST_GET_RESOURCES_PV_POWER_SITEAcción

Tool 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_idstringObligatorio

    The unique identifier of the resource to retrieve.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Resources PV Power SitesSOLCAST_GET_RESOURCES_PV_POWER_SITESAcción

Tool 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

  • entitlementstringenum

    Filter for site entitlement level. Valid values: 'advanced' or 'premium'.

    advancedpremium

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Patch PV Power ResourceSOLCAST_PATCH_RESOURCES_PV_POWER_SITEAcción

Tool 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

  • namestring

    Name of the PV power resource.

  • tiltnumber

    The off-horizontal tilt angle of modules for fixed-tilt sites (degrees).

  • azimuthnumber

    The angle from true north the modules are facing (degrees).

  • capacitynumber

    Total AC inverter (nameplate) capacity in MW.

  • latitudenumber

    Location latitude coordinate, between -90 and 90.

  • longitudenumber

    Location longitude coordinate, between -180 and 180.

  • capacity_dcnumber

    Total DC module capacity in MW.

  • entitlementstringenum

    Site entitlement level. Valid values: 'advanced' or 'premium'.

    advancedpremium
  • module_typestring

    PV module technology/material type (e.g., 'mono-si', 'poly-si', 'cdte', 'cigs', 'asi').

  • pvrow_widthnumber

    PV module row width in metres.

  • resource_idstringObligatorio

    The unique identifier of the resource to update.

  • install_datestring

    System installation date in ISO 8601 format for age-based derating calculations.

  • pvrow_heightnumber

    PV module row height above ground in metres.

  • terrain_slopenumber

    Average terrain slope in degrees.

  • tracking_typestring

    Sun-tracking configuration type (e.g., 'fixed', 'horizontal_single_axis').

  • bifacial_systemboolean

    Enable bifacial module modeling for rear-side power generation.

  • terrain_azimuthnumber

    Terrain downhill direction angle from true north (degrees).

  • grid_export_limitnumber

    Maximum power export to grid in MW.

  • bifaciality_factornumber

    Rear-to-front module efficiency ratio (0 to 1).

  • confirmed_metadatastring

    Metadata confirmation timestamp in ISO 8601 format.

  • site_ground_albedonumber

    Ground surface reflectivity proportion (0 to 1).

  • derating_age_systemnumber

    Annual system degradation rate (fraction per year).

  • derating_temp_modulenumber

    Temperature 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_azimuthnumber

    Horizontal tracker axis azimuth angle from true north (degrees). For single-axis trackers.

  • derating_other_systemnumber

    Total non-temperature system losses as a fraction (0 to 1).

  • ground_coverage_rationumber

    Proportion of ground area covered by PV modules (0 to 1).

  • tracker_back_trackingboolean

    Enable backtracking feature to avoid row-to-row shading.

  • tracker_smart_trackingboolean

    Enable smart tracking to reposition trackers during cloudy periods.

  • inverter_peak_efficiencynumber

    Peak inverter conversion efficiency rating (0 to 1).

  • cloudy_zenith_coefficientsnumber[]

    Cloudy sky zenith angle coefficients for advanced modeling.

  • tracker_max_rotation_anglenumber

    Maximum off-horizontal rotation angle for trackers (degrees).

  • clearsky_zenith_coefficientsnumber[]

    Clear sky zenith angle coefficients for advanced modeling.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create PV Power ResourceSOLCAST_POST_RESOURCES_PV_POWER_SITEAcción

Tool 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

  • namestringObligatorio

    Name of the PV power resource.

  • tiltnumber

    The off-horizontal tilt angle of modules for fixed-tilt sites (degrees).

  • azimuthnumber

    The angle from true north the modules are facing (degrees). North is 0, South is ±180.

  • capacitynumberObligatorio

    Total AC inverter (nameplate) capacity in MW.

  • latitudenumberObligatorio

    Location latitude coordinate, between -90 and 90.

  • longitudenumberObligatorio

    Location longitude coordinate, between -180 and 180.

  • capacity_dcnumberObligatorio

    Total DC module capacity in MW.

  • entitlementstringenum

    Site entitlement level. Valid values: 'advanced' or 'premium'.

    advancedpremium
  • module_typestring

    PV module technology/material type (e.g., 'mono-si', 'poly-si', 'cdte', 'cigs', 'asi').

  • pvrow_widthnumber

    PV module row width in metres.

  • install_datestringObligatorio

    System installation date in ISO 8601 format for age-based derating calculations.

  • pvrow_heightnumber

    PV module row height above ground in metres.

  • terrain_slopenumber

    Ground terrain slope angle in degrees.

  • tracking_typestringObligatorio

    Sun-tracking configuration type (e.g., 'fixed', 'horizontal_single_axis', 'dual_axis').

  • bifacial_systemboolean

    Enable bifacial module modeling for rear-side power generation.

  • terrain_azimuthnumber

    Direction of terrain slope from true north (degrees).

  • grid_export_limitnumber

    Maximum power export to grid in MW.

  • bifaciality_factornumber

    Rear-to-front module efficiency ratio (0 to 1).

  • confirmed_metadatastring

    Metadata confirmation timestamp in ISO 8601 format.

  • site_ground_albedonumber

    Ground surface reflectivity proportion (0 to 1).

  • derating_age_systemnumber

    Annual system degradation rate (fraction per year).

  • derating_temp_modulenumber

    Temperature 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_azimuthnumber

    Direction tracking axis points from true north (degrees). For single-axis trackers.

  • derating_other_systemnumber

    Total non-temperature system losses as a fraction (0 to 1).

  • ground_coverage_rationumber

    Proportion of ground area covered by PV modules (0 to 1).

  • tracker_back_trackingboolean

    Enable backtracking feature to avoid row-to-row shading.

  • tracker_smart_trackingboolean

    Enable smart tracking to reposition trackers during cloudy periods.

  • inverter_peak_efficiencynumber

    Peak inverter conversion efficiency rating (0 to 1).

  • cloudy_zenith_coefficientsnumber[]

    Zenith angle coefficients for cloudy conditions for advanced modeling.

  • tracker_max_rotation_anglenumber

    Maximum rotation angle from horizontal for trackers (degrees).

  • clearsky_zenith_coefficientsnumber[]

    Zenith angle coefficients for clear sky conditions for advanced modeling.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update PV Power ResourceSOLCAST_PUT_RESOURCES_PV_POWER_SITEAcción

Tool 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

  • namestring

    Name of the PV power resource.

  • tiltnumber

    The off-horizontal tilt angle of modules for fixed-tilt sites (degrees).

  • azimuthnumber

    The angle from true north the modules are facing (degrees).

  • capacitynumber

    Total AC inverter (nameplate) capacity in MW.

  • latitudenumber

    Location latitude coordinate, between -90 and 90.

  • longitudenumber

    Location longitude coordinate, between -180 and 180.

  • capacity_dcnumber

    Total DC module capacity in MW.

  • entitlementstringenum

    Site entitlement level. Valid values: 'advanced' or 'premium'.

    advancedpremium
  • module_typestring

    PV module technology/material type (e.g., 'mono-si', 'poly-si', 'cdte', 'cigs', 'asi').

  • pvrow_widthnumber

    PV module row width in metres.

  • resource_idstringObligatorio

    The unique identifier of the resource to update.

  • install_datestring

    System installation date in ISO 8601 format for age-based derating calculations.

  • pvrow_heightnumber

    PV module row height above ground in metres.

  • terrain_slopenumber

    Average terrain slope in degrees.

  • tracking_typestring

    Sun-tracking configuration type (e.g., 'fixed', 'horizontal_single_axis').

  • bifacial_systemboolean

    Enable bifacial module modeling for rear-side power generation.

  • terrain_azimuthnumber

    Terrain downhill direction angle from true north (degrees).

  • grid_export_limitnumber

    Maximum power export to grid in MW.

  • bifaciality_factornumber

    Rear-to-front module efficiency ratio (0 to 1).

  • confirmed_metadatastring

    Metadata confirmation timestamp in ISO 8601 format.

  • site_ground_albedonumber

    Ground surface reflectivity proportion (0 to 1).

  • derating_age_systemnumber

    Annual system degradation rate (fraction per year).

  • derating_temp_modulenumber

    Temperature 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_azimuthnumber

    Horizontal tracker axis azimuth angle from true north (degrees). For single-axis trackers.

  • derating_other_systemnumber

    Total non-temperature system losses as a fraction (0 to 1).

  • ground_coverage_rationumber

    Proportion of ground area covered by PV modules (0 to 1).

  • tracker_back_trackingboolean

    Enable backtracking feature to avoid row-to-row shading.

  • tracker_smart_trackingboolean

    Enable smart tracking to reposition trackers during cloudy periods.

  • inverter_peak_efficiencynumber

    Peak inverter conversion efficiency rating (0 to 1).

  • cloudy_zenith_coefficientsnumber[]

    Cloudy sky zenith angle coefficients for advanced modeling.

  • tracker_max_rotation_anglenumber

    Maximum off-horizontal rotation angle for trackers (degrees).

  • clearsky_zenith_coefficientsnumber[]

    Clear sky zenith angle coefficients for advanced modeling.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not