Konfiguration für pvnode

Diese Seite beschreibt die spezifischen Umgebungsvariablen für den Anbieter pvnode. Der Forecast-Collector unterstützt sowohl den kostenlosen als auch den kostenpflichtigen pvnode-Service. Es können bis zu 4 Dachflächen konfiguriert werden.

Zusätzlich zu den hier beschriebenen Variablen müssen die allgemeinen Einstellungen konfiguriert werden.

Vollständiges Beispiel

# Anbieter
FORECAST_PROVIDER=pvnode

# Zeitzone
TZ=Europe/Berlin

# Standort
FORECAST_LATITUDE=50.12345
FORECAST_LONGITUDE=6.12345

# Anzahl der Dachflächen
FORECAST_CONFIGURATIONS=2

# Erste Dachfläche
FORECAST_0_DECLINATION=30
FORECAST_0_AZIMUTH=180
FORECAST_0_KWP=5.5

# Zweite Dachfläche
FORECAST_1_DECLINATION=30
FORECAST_1_AZIMUTH=270
FORECAST_1_KWP=3.9

# Dritte Dachfläche
# FORECAST_2_DECLINATION=25
# FORECAST_2_AZIMUTH=200
# FORECAST_2_KWP=4.2

# Vierte Dachfläche
# FORECAST_3_DECLINATION=35
# FORECAST_3_AZIMUTH=150
# FORECAST_3_KWP=6.0

# pvnode-Zugangsdaten
PVNODE_APIKEY=pvn_my-secret-api-key

# Optional: Tarif des bezahlten pvnode-Accounts (Standard: kostenloser Tarif)
# PVNODE_PAID=true
# oder
# PVNODE_PAID=nowcast

# Optional: Zusätzliche API-Parameter
# PVNODE_EXTRA_PARAMS=diffuse_radiation_model=perez

# Optional: Zusätzliche API-Parameter für einzelne Dachflächen
# PVNODE_0_EXTRA_PARAMS=snow_slide_coefficient=0.5
# PVNODE_1_EXTRA_PARAMS=snow_slide_coefficient=0.3

# InfluxDB
INFLUX_HOST=influxdb
INFLUX_SCHEMA=http
INFLUX_PORT=8086
INFLUX_TOKEN_WRITE=my-super-secret-admin-token
INFLUX_ORG=solectrus
INFLUX_BUCKET=solectrus
INFLUX_MEASUREMENT_FORECAST=forecast

Die Variablen im Detail

Zugangsdaten

PVNODE_APIKEY

API-Key für die Nutzung von pvnode. Der Key muss zuvor bei pvnode erstellt werden:
https://pvnode.com/api-keys

PVNODE_APIKEY=pvn_my-secret-api-key

PVNODE_PAID

Wählt den pvnode-Tarif aus. Der Collector kann das nicht automatisch erkennen, daher muss der Tarif bei kostenpflichtigen Accounts explizit angegeben werden.

PVNODE_PAID=nowcast

Die Tarife unterscheiden sich wie folgt:

Kostenloser Tarif (false): bis zu 40 API-Anfragen pro Monat, 1-Tages-Vorhersage
Basis-Tarif (true): bis zu 1.000 API-Anfragen pro Monat, 7-Tages-Vorhersage, stündliche Slots
Nowcast-Tarif (nowcast): bis zu 3.000 API-Anfragen pro Monat, 7-Tages-Vorhersage, 10-Minuten-Updates während der Tageslichtstunden

Abfrageintervall

Das Abfrageintervall (FORECAST_INTERVAL) muss bei pvnode nicht konfiguriert werden. Der Collector ermittelt automatisch die optimalen Abrufzeitpunkte basierend auf:

den Update-Zeiten von pvnode (16-mal täglich zu festen Uhrzeiten bei Frei- und Basis-Tarif, zusätzlich alle 10 Minuten während der Tageslichtstunden beim Nowcast-Tarif)
dem verfügbaren API-Kontingent (40 Anfragen/Monat kostenlos, 1.000 Anfragen/Monat im Basis-Tarif, 3.000 Anfragen/Monat im Nowcast-Tarif)
der Anzahl der konfigurierten Dachflächen
den konfigurierten zusätzlichen Parametern (PVNODE_EXTRA_PARAMS)

Der Forecast-Collector minimiert die Anzahl der Anfragen, indem er gleiche Parameter für mehrere Dachflächen zusammenfasst und nach Möglichkeit mit einer Abfrage zwei Dachflächen abdeckt. Falls notwendig, werden einzelne Slots oder auch ganze Tage übersprungen, um das monatliche Kontingent nicht zu überschreiten.

Standort

pvnode arbeitet mit einem monatlichen Standort-Limit (Site-Limit). Im kostenlosen Tarif ist ein Standort enthalten. Standorte werden bei pvnode automatisch gespeichert, sobald eine Abfrage mit Koordinaten an die API gesendet wird.

FORECAST_LATITUDE

Breitengrad des Standorts der PV-Anlage.

FORECAST_LATITUDE=50.12345

FORECAST_LONGITUDE

Längengrad des Standorts der PV-Anlage.

FORECAST_LONGITUDE=6.12345

Einzelne Dachfläche

Bei einer einzelnen Dachfläche werden die folgenden Variablen verwendet:

FORECAST_DECLINATION

Dachneigung in Grad.

FORECAST_DECLINATION=30

FORECAST_AZIMUTH

Ausrichtung des Dachs in Grad von Nord.

FORECAST_AZIMUTH=207

FORECAST_KWP

Maximale Leistung der PV-Anlage in kWp.

FORECAST_KWP=9.24

PVNODE_EXTRA_PARAMS

Zusätzliche Query-Parameter für die pvnode-API. Diese werden an alle Dachflächen-Abfragen angehängt.

PVNODE_EXTRA_PARAMS=diffuse_radiation_model=perez&snow_slide_coefficient=0.5

Mehrere Dachflächen

Bei mehreren Dachflächen muss zunächst die Anzahl festgelegt werden. Anschließend werden die Variablen für jede Dachfläche gesetzt, wobei X für die Nummer der Dachfläche steht (0, 1, 2, 3).

FORECAST_CONFIGURATIONS

Anzahl der konfigurierten Dachflächen.

FORECAST_CONFIGURATIONS=2

FORECAST_X_DECLINATION

Dachneigung der jeweiligen Dachfläche in Grad.

FORECAST_0_DECLINATION=27
FORECAST_1_DECLINATION=30

FORECAST_X_AZIMUTH

Ausrichtung der jeweiligen Dachfläche in Grad von Nord.

FORECAST_0_AZIMUTH=180
FORECAST_1_AZIMUTH=270

FORECAST_X_KWP

Maximale Leistung der Module auf der jeweiligen Dachfläche in kWp.

FORECAST_0_KWP=3.9
FORECAST_1_KWP=5.5

PVNODE_X_EXTRA_PARAMS

Zusätzliche Query-Parameter für eine bestimmte Dachfläche. Diese überschreiben PVNODE_EXTRA_PARAMS für die jeweilige Dachfläche.

PVNODE_0_EXTRA_PARAMS=diffuse_radiation_model=perez
PVNODE_1_EXTRA_PARAMS=snow_slide_coefficient=0.3