(Archiv) V1 API

Prognose-API

Der Prognose-Endpunkt liefert kurzfristige, hochauflösende 15-Minuten-Zeitreihendaten — +7 Tage voraus und −30 Tage zurück — für Photovoltaikanlagen basierend auf Standort und Anlagenkonfiguration. Der Endpunkt unterstützt GET-Anfragen und benötigt zwingend latitude, longitude sowie slope und orientation.

Nutzer des kostenlosen Tarifs erhalten Prognosedaten nur für +1 Tag (heute und morgen) und keine vergangenen Tage.

Anfragelimits hängen vom Tarif ab:

Free: 40 Anfragen pro Monat
Bezahlte Tarife: 1.000 Anfragen pro Monat
Nowcast-Tarif: 3.000 Anfragen pro Monat

Es gilt Fair-Use-Nutzung. Limits können sich ändern. Je nach Abo können individuelle Limits gelten.

Unabhängig vom Tarif gilt ein Rate-Limit von 10 Anfragen pro Sekunde. Bei Überschreitung wird 429 zurückgegeben.

Nowcast

Satelliten-Nowcast-Daten (~1,5 × 1,5 km) verbessern die Prognose mit hochauflösenden Daten und sind für Nutzer im Nowcast-Tarif standardmäßig aktiviert. Die Funktion kann durch Übergabe des URL-Parameters nowcast=False deaktiviert werden.

Updates: In Europa alle 10 Minuten. Außerhalb Europas alle 15 Minuten in ausgewählten Regionen.

Basis-URL

Code
https://api.pvnode.com/v1/forecast/

Beispielanfrage

Die folgenden Beispiele zeigen, wie die erforderlichen Parameter übergeben und der API-Key zur Authentifizierung genutzt wird. Das Beispiel verwendet eine Neigung (slope) von 30 Grad, eine Ausrichtung (orientation) von 180 Grad (Süden) und den Standort Rosenheim, Deutschland mit den Koordinaten latitude: 47.84812, longitude: 12.06231.

import requests

url = 'https://api.pvnode.com/v1/forecast/'
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()

Dies ist die Basis-Konfiguration. Die API unterstützt viele weitere Parameter für Verschattung, Tracker-Systeme, Moduleigenschaften und mehr — die vollständige Liste findet sich in der API-Referenz.

Authentifizierung Recent API

Prognose-API

Nowcast

Basis-URL

Beispielanfrage

Erweiterte Konfiguration

Verschattung & Horizont

Tracker-Konfiguration

Lastprofile

Wettercodes

Datenspalten