History GET

Der History API-Endpunkt liefert detaillierte, rückblickende 15-Minuten-Zeitreihendaten von 2015 bis Gestern für Photovoltaik (PV)-Anlagen basierend auf dem Standort und den Installationsmerkmalen der Anlage. Dieser Endpunkt unterstützt GET-Anfragen, die die geografische Breite latitude, geografische Länge longitude, die Neigung slope und Ausrichtung orientation der PV-Anlage sowie das Start- und Enddatum der Zeitreihe (start_date, end_date) erfordern.

Erweiterte Daten

Erweiterte Daten, die bis 2007 zurückreichen, sind als Add-on verfügbar.

Base URL

Die Base URL für diesen Endpoint ist:

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

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/history/'
body = {
    "latitude": 47.84812,
    "longitude": 12.06231,
    "slope": 30,
    "orientation": 180,
    "start_date": "2015-01-01",
    "end_date": "2024-05-01"
}
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 betragen 6 Anfragen pro Minute. Wenn mehr Anfragen 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.
`start_date`	string	Startdatum für die Zeitreihendaten, formatiert als 'YYYY-MM-DD'. Das Datum muss innerhalb des 1. Januar 2015 und heute liegen.
`end_date`	string	Enddatum für die Zeitreihendaten, formatiert als 'YYYY-MM-DD'. Dieses Datum muss an oder vor dem heutigen Datum liegen.

Optional parameters

query parameter	type	description
`pv_only`	boolean	Gibt an, ob die Berechnungen nur die Photovoltaik-Leistung berücksichtigen sollen, ohne Hilfssysteme wie Klimaanlagen und Wärmepumpen. Standard: True.
`required_data`	string	Erforderliche Datenspalten, formatiert als kommagetrennte Liste, die die Arten von Daten und Metriken für die Analyse angibt. Alle Datenspalten
`pv_power_kw`	float	Standard-Testbedingung (STC) Leistung in kWp der ersten PV-Anlage. Muss angegeben werden, wenn `second_array_power_kw` > 0. Standardwert ist 0.
`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.
`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 > 0.
`cable_loss_rate`	float	Prozentualer Verlust aufgrund des Kabelwiderstands, der die Gesamtsystemeffizienz beeinflusst. Standard: 0.015 (1.5%).
`conversion_loss_rate`	float	Gleichstrom zu Wechselstrom Umwandlungsverlustrate, die die Effizienz der Stromabgabe aus Speicher oder Solarmodulen beeinflusst. Standard: 0.025 (2.5%).
`yearly_energy_consumption`	float	Jährlicher Stromverbrauch ohne Wärmepumpe, gemessen in MWh/Jahr. Standard: 4.0 MWh.
`yearly_heat_pump_consumption`	float	Jährlicher Stromverbrauch für die Wärmepumpe, gemessen in MWh/Jahr. Standard: 5.0 MWh.
`battery_capacity`	float	Gesamtkapazität des Stromspeichers, gemessen in kWh. Standard: 10 kWh.
`air_cool_config`	string	Konfigurationszeichenfolge für optionale Klimaanlagen, standardmäßig leer (''). Detaillierte Beschreibung.
`air_cool_temperature_threshold`	float	Temperaturschwelle (mittlere Tagestemperatur) für die Aktivierung der Klimaanlage, gemessen in Grad Celsius. Standard: 21.0°C.
`air_cool_peak_power`	float	Spitzenleistungsaufnahme der Klimaanlage, gemessen in kW. Standard: 1.0 kW.
`charge_power_ratio`	float	Maximale Ladeleistung relativ zur Batteriekapazität; beispielsweise entspricht 0.5 einer nutzbaren Ladekapazität von 50% der Batteriekapazität. Standard: 0.5.
`discharge_power_ratio`	float	Maximale Entladeleistung relativ zur Batteriekapazität, gibt an, wie viel Leistung auf einmal entnommen werden kann. Standard: 0.5.
`battery_efficiency`	float	Wirkungsgrad des Stromspeichers, berücksichtigt Verluste durch Selbstentladung und DC-AC-Umwandlung; 0.94 bedeutet 94% Wirkungsgrad, mit 6% Verlust.
`demand_profile`	string	Legt das jährliche Lastprofil für den Strombedarf fest (ohne Wärmepumpe), das die zeitliche Verteilung des Energieverbrauchs definiert. Standard: 'h0_dyn'.
`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.
`timezone`	string	Zeitzoneneinstellung für alle Zeitstempel-Dateneinträge. Standard: 'UTC'.

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.

Verfügbare Datenspalten

Die folgende Tabelle zeigt alle verfügbaren Datenspalten im Datensatz. Jeder Wert in der Zeitreihe stellt den Durchschnittswert über ein 15-Minuten-Intervall dar:

data	description	unit
`GHI`	Globale Horizontalstrahlung gemessen auf horizontaler Ebene	W/m²
`BNI`	Direktnormalstrahlung	W/m²
`DHI`	Diffuse Horizontalstrahlung	W/m²
`GTI`	Globale geneigte Einstrahlung auf ein PV-Panel in der Ebene (unverschattet)	W/m²
`GTI_shaded`	Globale geneigte Einstrahlung auf ein PV-Panel in der Ebene (nach allen Verschattungsberechnungen)	W/m²
`temp`	Temperatur gemessen 2 Meter über dem Boden	°C
`RH`	Relative Luftfeuchtigkeit	%
`precip`	Gesamtniederschlag	mm
`vwind`	Windgeschwindigkeit gemessen 10 Meter über dem Boden	m/s
`weather_code`	Wetter-Code, siehe Tabelle oben	-
`snow_height`	Schneehöhe am Boden als Wasseräquivalent	mm
`spec_watts`	Erzeugte spezifische Leistung der PV-Anlage/n	W/kWp
`pv_watts`	Erzeugte Leistung der PV-Anlage/n	W
`battery_state`	Ladezustand der Batterie	Wh
`external_energy`	Externe Energie zur Deckung der elektrischen Gesamtlast	Wh
`feed_in`	Überschüssige Energie, die ins Netz eingespeist wird	Wh
`battery_charge`	Energie zum Laden der Batterie	Wh
`total_elec_dem`	Elektrischer Gesamtbedarf	W
`load_jv`	Elektrischer Bedarf gemäß Lastprofil	W
`load_hp`	Elektrischer Bedarf der Wärmepumpe	W
`air_cond_load`	Elektrischer Bedarf der Klimaanlage	W

Wettercodes

Interpretation der Wettercodes:

code	description
0	wolkenlos
1,2,3	überwiegend klar, teilweise bewölkt, bedeckt
45,48	Nebel und Reifnebel
51,53,55	Nieselregen: leicht, mäßig, dicht
56,57	gefrierender Nieselregen: leicht und dicht
61,63,65	Regen: leicht, mäßig, stark
66,67	gefrierender Regen: leicht und stark
71,73,75	Schneefall: leicht, mäßig, stark
77	Schneegriesel
80,81,82	Regenschauer: leicht, mäßig, heftig
85,86	Schneeschauer: leicht und stark
95	Gewitter
96,99	Gewitter mit leichtem und starkem Hagel

Klimaanlage-Konfiguration

Der Parameter air_cool_config konfiguriert den Betriebszeitplan einer Klimaanlage mithilfe einer 12-stelligen Binärkette. Jede Stelle repräsentiert einen 2-Stunden-Block innerhalb eines 24-Stunden-Tages, wobei 1 bedeutet, dass die Klimaanlage eingeschaltet ist und 0 bedeutet, dass sie ausgeschaltet ist.

Zum Beispiel:

air_cool_config = 000110001100

Diese Konfiguration bedeutet, dass die Klimaanlage von 6 Uhr bis 10 Uhr und von 16 Uhr bis 20 Uhr aktiv ist.

Die Betriebseffizienz der Klimaanlage wird als Stufenfunktion modelliert, beginnend bei 50% der Spitzenleistung bei der durch air_cool_temperature_threshold festgelegten Temperaturschwelle. Sie steigt dann linear auf 100% Spitzenleistung an, wenn die mittlere Außentemperatur auf air_cool_temperature_threshold + 8 K ansteigt.

Lastprofil

Der Parameter demand_profile definiert das elektrische Lastprofil basierend auf typischen Verbrauchsmustern, normiert auf einen Bedarf von 1 MWh pro Jahr. Diese Nachfrage wird dann durch den jährlichen elektrischen Energieverbrauchsparameter jv skaliert.

Profile	Beschreibung
g0	Allgemeiner Handel/Gewerbe/Geschäfte (gewichteter Durchschnitt der Profile g1-g6)
g1	Gewerbe, typische Bürozeiten von 8 bis 18 Uhr an Werktagen
g2	Gewerbe mit hohem Verbrauch hauptsächlich am Abend
g3	Durchlaufender Betrieb, z.B. Kühlhäuser, Pumpen, Kläranlagen
g4	Läden oder Dienstleistungen wie Friseursalons mit Tagesöffnungszeiten
g5	Bäckereien, typischerweise früh morgens bis nachmittags
g6	Wochenendbetriebe, z.B. Kinos
g7	Mobilfunk-Sendestationen mit kontinuierlicher Last
l0	Allgemeine Landwirtschaftsbetriebe (gewichteter Durchschnitt der Profile l1 und l2)
l1	Landwirtschaftsbetriebe mit Milchwirtschaft
l2	Andere Arten von Landwirtschaftsbetrieben
h0	Typische Haushaltslast
h0_dyn	Haushalt mit dynamischem, saisonal variierendem Verbrauchsprofil

History GET ​

Erweiterte Daten ​

Base URL ​

Beispiel-Anfrage ​

Erforderliche Parameter ​

Optional parameters ​

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: ​

Verfügbare Datenspalten ​

Wettercodes ​

Klimaanlage-Konfiguration ​

Lastprofil ​