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
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.
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.
Erweiterte Konfiguration
Verschattung & Horizont
Horizontprofile, Reihenverschattung und weitere Verschattungsszenarien konfigurieren.
Tracker-Konfiguration
Einachsige und zweiachsige Tracker-Systeme mit eigenen Parametern einrichten.
Lastprofile
Lastprofile einbinden, um Eigenverbrauch und Netzeinspeisung zu modellieren.
Wettercodes
Referenz für Wettercode-Werte, die in der Prognose-Antwort zurückgegeben werden.
Datenspalten
Vollständige Referenz aller Felder, die in der Prognose-Antwort enthalten sind.