Yield GET

Die Yield-API-Endpoint stellt detaillierte spezifische Ertragsdaten für Photovoltaik (PV) Systeme basierend auf deren Standort und Installationsmerkmalen bereit. Dieser Endpoint unterstützt GET Anfragen, die den Breitengrad latitude, Längengrad longitude sowie die Neigung slope und Ausrichtung orientation des PV-Systems erfordern. Standardmäßig berechnet dieser Endpoint den spezifischen Ertrag für die Jahre 2015 bis 2024. Erweiterte Daten bis zum Jahr 2007 sind als Add-on verfügbar.

INFO

Für Nutzer im kostenlosen Tarif ist der Zugriff auf spezifische durchschnittliche Ertragswerte beschränkt, die für die vergangenen 10 Jahre berechnet wurden; detaillierte Informationen zu einzelnen Jahren, Vertrauensintervallen oder anderen zusätzlichen Daten werden nicht bereitgestellt.

Base URL

Die Base URL für diesen Endpoint ist:

https://api.pvnode.com/v1/yield/

Beispiel-Anfrage

Die folgenden Beispiele demonstrieren, wie man die erforderlichen Parameter übergibt und den API-Key für die Authentifizierung einbindet. Das Beispiel verwendet einen slope (Neigung) von 30 Grad, eine orientation (Ausrichtung) von 180 Grad (nach Süden ausgerichtet), und der Standort ist auf Rosenheim, Deutschland mit den Koordinaten latitude: 47.84812, longitude: 12.06231 festgelegt.

python

import requests

url = 'https://api.pvnode.com/v1/yield/'
body = {
    "latitude": 47.84812,
    "longitude": 12.06231,
    "slope": 30,
    "orientation": 180
}
headers = {
    'Authorization': 'Bearer ' + YOUR_API_KEY
}
response = requests.get(url, headers=headers, params=body)
data = response.json()

Rate-Limits

Die Rate-Limits für diesen Endpoint sind 6 Requests pro Minute. Wenn mehr Requests gesendet werden, wird eine 429 Antwort zurückgegeben.

Erforderliche Parameter

Parameter	Typ	Beschreibung
`latitude`	float	Breitengrad des Standorts.
`longitude`	float	Längengrad des Standorts.
`slope`	float	Neigung des PV-Arrays in Grad, zwischen 0 und 90.
`orientation`	float	Ausrichtung des PV-Arrays in Grad von Nord. 180 ist Süd und 270 ist West.

Optionale Parameter

Parameter	Type	Description
`pv_power_kw`	float	Standard-Testbedingung (STC) Leistung in kWp der ersten PV-Anlage. Muss angegeben werden, wenn `second_array_power_kw` > 0. Standard ist 0.
`detailed_losses`	boolean	Wenn dieser Parameter gesetzt ist, werden detaillierte Verluste wie DC-zu-AC-Umwandlungsverluste, Schneeverluste und andere zurückgegeben. Standard ist False.
`pv_technology_type`	string	PV-Modell für spektralen Missmatch. Optionen sind `monosi`, `multisi`, `cdte`, `perc` und `topcon`. Standard: `perc`.
`temperature_coefficient_power`	float	Temperaturkoeffizient (%/K) des PV-Modulwirkungsgrads. Standard ist -0.42.
`diffuse_radiation_model`	string	Modell für Diffusstrahlungsberechnungen. Optionen sind `perez` und `haydavies`. Standard: `haydavies`.
`panel_age_years`	float	Alter der PV-Module in Jahren. Geht von einer Degradation von 0,5% pro Jahr aus. Standard ist 1.
`elevation`	float	Höhe über dem Meeresspiegel in Metern. Standard ist -999, was automatisch die Höhe aus hochauflösenden Geländedaten verwendet.
`installation_height`	float	Installationshöhe der PV-Anlage. Standard ist 0.
`mounting_type`	string	Montageart der PV-Anlage: `open` (offene Montage), `isol` (isolierte Rückseite, dachnahe Installation) oder `mix`. Standard ist `open`.
`ground_albedo`	float	Bodenalbedo, von 0 bis 1. Standard ist 0.2.
`ground_coverage_ratio`	float	Bodenbedeckungsgrad für Reihenverschattung, typischerweise von 0 bis 1. Standard ist 0 (keine Reihenverschattung). GCR-Rechner
`tracker_system_type`	int	Nachführsystemkonfiguration: 0 (keine Nachführung), 1 (einachsiger Tracker), oder 2 (zweiachsiger Tracker). Standard ist 0. Gilt nur für den ersten String.
`single_axis_tracker_config`	string	Konfigurationsdetails für einachsigen Tracker. Detaillierte Beschreibung.
`inverter_clip_max_threshold_percent`	float	Prozentuale Begrenzung der AC-Ausgangsleistung als Prozentsatz der Nennleistung (der PV-Anlage). Standard: 120.
`inverter_clip_min_threshold_percent`	float	Minimale Wechselstrom-Ausgangsleistung als Prozentsatz der Nennleistung (der PV-Anlage). Standard: 0.1.
`sky_obstruction_config`	string	Konfiguration für Himmelskuppel-Verschattungen (wie Berge). Detaillierte Beschreibung.
`terrain_based_horizon_coverage`	bool	Wenn aktiviert, wird die Horizontabdeckung aus unseren hochpräzisen Geländedaten ermittelt. Standard ist false.
`shading_config`	string	Verschattungskonfiguration für die erste PV-Anlage. Standard ist '', was keine Verschattung bedeutet. Detaillierte Beschreibung.
`snow_slide_coefficient`	float	Koeffizient, der für Schneeberechnungen auf PV-Anlagen verwendet wird. Empfohlen wird die Verwendung von 0.1-0.3 für Dachinstallationen und 0.3 - 0.6 für offene Montagen. Standard: 0.14.
`enable_soiling_model`	boolean	Bestimmt, ob ein Verschmutzungsmodell berechnet und berücksichtigt wird. Standard: false.
`soiling_model_config`	string	Konfigurationsparameter für Verschmutzungsmodell. Standard: 2:2:0.11:0.5. Detaillierte Beschreibung.
`second_array_slope`	float	Neigung der zweiten PV-Anlage in Grad, von 0 bis 90. Muss angegeben werden, wenn `second_array_power_kw` > 0.
`second_array_orientation`	float	Ausrichtung der zweiten PV-Anlage in Grad von Nord. 180 ist Süd, 270 ist West. Muss angegeben werden, wenn `second_array_power_kw` > 0.
`second_array_ground_coverage_ratio`	float	Bodenbedeckungsgrad für die zweite PV-Anlage. Standard ist 0. GCR-Rechner
`second_array_shading_config`	string	Verschattungskonfiguration für die zweite PV-Anlage. Standard ist '', was keine Verschattung bedeutet. Detaillierte Beschreibung.
`second_array_power_kw`	float	STC-Leistung in kWp der zweiten PV-Anlage. Erfordert `pv_power_kw` > 0.
`prefer_american_satellites`	boolean	Gibt an, ob amerikanische Satellitenregionen verwendet werden sollen, wenn sich zwei Regionen überlappen. Nur für überlappende Regionen in Amerika verfügbar.
`include_historical_data`	boolean	Gibt an, ob Daten bis 2007 verwendet werden. Nur als Add-on verfügbar.
`historical_data_start_year`	integer	Gibt das Startjahr für Daten an, wenn `include_historical_data` aktiviert ist.

Zusätzliche Hinweise

Ground Coverage Ratio für Verschattung innerhalb von PV-Feld-Reihen

Das Ground Coverage Ratio (GCR) quantifiziert die Dichte der Solarmodule innerhalb einer bestimmten Fläche und wird mit folgender Formel berechnet:

GCR = \frac{L}{R}

wobei:

$L$ die Länge des Solarmodul-Arrays darstellt.
$R$ der Abstand zwischen aufeinanderfolgenden Modulreihen ist.

GCR-Rechner

Bitte nutzen Sie unseren GCR-Rechner, um den GCR für Ihren Standort zu berechnen.

Geben Sie die Länge des PV-Arrays ( $L$ ) ein:

Geben Sie den Reihenabstand ( $R$ ) ein:

Die Ground Coverage Ratio (GCR) ist: 0.00

GCR visualisiert

Die GCR hilft beim Verständnis, wie eng die Module am Installationsort installiert wurden, was die potenzielle Verschattung und Energieproduktionseffizienz beeinflusst.

/gcr.png

Tracker-Konfiguration der PV-Anlage

Der Parameter tracker1config spezifiziert die Konfiguration eines einachsigen Solar-Trackers unter Verwendung von vier durch Doppelpunkte : getrennten Werten.

Achsen-Azimut (Grad): Gibt die Kompassrichtung der Rotationsachse des Trackers an, von 0 bis 360 Grad. Ein Wert von 180 zeigt nach Süden, wobei zunehmende Winkel sich nach Westen bewegen.
Achsenneigung (Grad): Definiert die Neigung der Tracker-Achse relativ zur horizontalen Ebene, von 0 bis 90 Grad.
Maximaler Rotationswinkel (Grad): Legt die Grenzen der Tracker-Rotation fest, von 0 bis 90 Grad. Negative Winkel gleicher Größe sind implizit eingeschlossen und ermöglichen die Bewegung in die entgegengesetzte Richtung.
Rückverfolgung (Boolean): Der Wert T (true) oder F (false) gibt an, ob der Tracker Rückverfolgung verwendet, um Reihenverschattung während der Morgen- und Abendstunden zu verhindern.

python

single_axis_tracker_config = "180:0:90:T"

Diese Konfiguration beschreibt einen einachsigen Tracker mit:

Nach Süden ausgerichteter Achse (180 Grad)
Keine Neigung (0 Grad)
Rotationsfähig von -90 bis +90 Grad
Aktivierte Rückverfolgung

Horizontverschattungs-Konfiguration

sky_obstruction_config: Dieser Parameter konfiguriert Hindernisse, die Teile der Himmelskuppel blockieren, wie Gebäude, Bäume oder Berge. Konfigurationen werden durch Zeichenketten von drei durch Doppelpunkte : getrennten Ganzzahlen dargestellt, wobei bis zu 10 solcher Zeichenketten durch Unterstriche _ verbunden werden können.
Jede Zeichenkette spezifiziert:
- Start-Azimutwinkel: Der Anfangswinkel in Grad von Nord, wo das Hindernis beginnt.
- End-Azimutwinkel: Der Winkel in Grad von Nord, wo das Hindernis endet.
- Elevationswinkel: Der maximale Winkel in Grad über dem Horizont, den das Hindernis abdeckt.

Beispielkonfigurationen:

sky_obstruction_config = 0:90:20 beschreibt ein Hindernis, das den Bereich von Nord bis Ost am Himmel von 0° bis 20° Elevation abdeckt.
sky_obstruction_config = 0:90:20_180:270:30 erweitert die Abdeckung um sowohl den nordöstlichen Bereich von 0° bis 20° Elevation als auch einen südwestlichen Bereich von 0° bis 30° Elevation.

Verschattungs-Konfiguration

shading_config: Dieser Parameter definiert die Verschattung der PV-Anlage zu verschiedenen Tageszeiten und Jahreszeiten unter Verwendung von Zeichenketten aus vier durch Doppelpunkte : getrennten Ganzzahlen.
Jede Ganzzahl repräsentiert die Verschattung als Prozentsatz (multipliziert mit 10) für jede Jahreszeit—Winter, Frühling, Sommer und Herbst.
Die Zeichenketten werden durch Unterstriche _ verbunden, um verschiedene Tageszeiten darzustellen:
- Morgen (6-10 Uhr): Definiert durch den ersten Zahlensatz, z.B. bedeutet 7:2:3:1 70% Verschattung im Winter, 20% im Frühling, 30% im Sommer und 10% im Herbst.
- Mittag (11-14 Uhr): Definiert durch den zweiten Zahlensatz, z.B. bedeutet 1:1:0:0 10% Verschattung während Winter und Frühling, ohne Verschattung während Sommer und Herbst.
- Nachmittag/Abend (15 Uhr - 20 Uhr): Definiert durch den dritten Zahlensatz, z.B. bedeutet 0:0:0:0, dass zwischen 15 Uhr und 20 Uhr in keiner Jahreszeit eine Verschattung stattfindet.

Beispielkonfiguration:

shading_config = 7:2:3:1_1:1:0:0_0:0:0:0 zeigt verschiedene Verschattungsgrade zu unterschiedlichen Zeiten und Jahreszeiten:
- Starke Morgenverschattung im Winter (70%), abnehmend bis keine Verschattung am Abend.
- Konstante leichte Verschattung am Mittag in Winter und Frühling (10%), keine in den wärmeren Monaten.

Verschmutzungs-Konfiguration

soiling_config: Dieser Parameter besteht aus vier Werten (getrennt durch Doppelpunkte :), die das Verschmutzungsverhalten der PV-Module definieren.
- Reinigungszeitfenster: Der erste Wert repräsentiert die Anzahl der Stunden, die das Reinigungszeitfenster definieren. Dies ist der Zeitraum während des Tages, in dem eine Reinigung stattfinden kann.
- Niederschlagsschwelle: Der zweite Wert ist die Regenmenge in mm, die innerhalb des Reinigungszeitfensters erforderlich ist, um eine vollständige Reinigung der Module auszulösen. Wenn weniger Regen fällt, findet keine Reinigung statt.
- Ablagerungsgeschwindigkeit (2,5 μm): Der dritte Wert ist die Ablagerungsgeschwindigkeit von Partikeln mit einer Größe von etwa 2,5 μm, gemessen in cm/s. Dies bestimmt, wie schnell sich diese Partikel auf der Moduloberfläche ansammeln.
- Ablagerungsgeschwindigkeit (10 μm): Der vierte Wert ist die Ablagerungsgeschwindigkeit von Partikeln mit einer Größe von etwa 10 μm, gemessen in cm/s.
Standard: 2:2:0.11:0.5

Diese Standardkonfiguration zeigt ein 2-stündiges Reinigungszeitfenster an, das 2 mm Niederschlag für die Reinigung erfordert. Außerdem setzt sie die Ablagerungsgeschwindigkeiten für 2,5 μm und 10 μm Partikel auf jeweils 0,11 cm/s und 0,5 cm/s.

Yield GET ​

Base URL ​

Beispiel-Anfrage ​

Erforderliche Parameter ​

Optionale Parameter ​

Zusätzliche Hinweise ​

Ground Coverage Ratio für Verschattung innerhalb von PV-Feld-Reihen ​

GCR-Rechner ​

GCR visualisiert ​

Tracker-Konfiguration der PV-Anlage ​

Horizontverschattungs-Konfiguration ​

Beispielkonfigurationen: ​

Verschattungs-Konfiguration ​

Beispielkonfiguration: ​

Verschmutzungs-Konfiguration ​