# Konfiguration für Solcast

> Umgebungsvariablen des Forecast-Collectors für den Anbieter Solcast. Mehr als API-Key und Site-IDs braucht es nicht, der Rest liegt im Solcast-Portal.

Diese Seite beschreibt die Umgebungsvariablen für den Anbieter [Solcast](https://solcast.com). Sie beschränken sich auf den API-Key und die Site-IDs. Standort, Ausrichtung und Leistung der Anlage liegen im Solcast-Portal, nicht in der Konfiguration des Collectors.

Dazu kommen die [allgemeinen Einstellungen](/docs/referenz/forecast-collector/allgemeine-konfiguration/), allen voran `FORECAST_PROVIDER=solcast`.

## Vollständiges Beispiel

```properties title=".env"
# Anbieter
FORECAST_PROVIDER=solcast

# Zeitzone
TZ=Europe/Berlin

# Solcast-Zugangsdaten
SOLCAST_APIKEY=my-solcast-api-key

# Dachflächen (Site-IDs aus dem Solcast-Portal)
FORECAST_CONFIGURATIONS=2
SOLCAST_0_SITE=1111-1111-1111-1111
SOLCAST_1_SITE=2222-2222-2222-2222

# Abfrageintervall (zwei Dachflächen: 2 × 8640)
FORECAST_INTERVAL=17280

# InfluxDB
INFLUX_HOST=influxdb
INFLUX_SCHEMA=http
INFLUX_PORT=8086
INFLUX_TOKEN=my-super-secret-write-token
INFLUX_ORG=solectrus
INFLUX_BUCKET=solectrus
INFLUX_MEASUREMENT=Forecast
```

## API-Zugang

### `SOLCAST_APIKEY`<span class="badge required"></span>

API-Key des Solcast-Kontos, im Solcast-Dashboard unter _Your API key_ zu finden.

Ohne gültigen Key weist Solcast jede Abfrage ab. Der Collector läuft dann weiter, protokolliert aber Fehler, und im Dashboard bleibt die Prognosekurve leer.

```properties title="Beispiel"
SOLCAST_APIKEY=my-solcast-api-key
```

> **HELIOS**
>
>
> HELIOS fragt den API-Key unter _Konfiguration → Datenquellen → Forecast-Collector_ ab.
>

## Dachflächen

Eine Dachfläche entspricht bei Solcast einer _Rooftop Site_. Ihre ID steht im Solcast-Portal, die Anlagendaten dahinter ebenfalls. Der Collector kennt nur die ID.

### `FORECAST_CONFIGURATIONS`<span class="badge optional"></span>

Anzahl der Dachflächen. Standardwert ist `1`.

Für jede Dachfläche fragt der Collector Solcast einzeln ab und addiert die Prognosen. Steht hier eine zu kleine Zahl, bleiben die Site-IDs der übrigen Dachflächen unbeachtet — `SOLCAST_1_SITE` etwa wirkt erst ab `FORECAST_CONFIGURATIONS=2`.

```properties title="Beispiel"
FORECAST_CONFIGURATIONS=2
```

> **HELIOS**
>
>
> HELIOS fragt die Anzahl der Dachflächen unter _Konfiguration → Datenquellen → Forecast-Collector_ ab, nimmt für Solcast aber höchstens zwei Site-IDs entgegen. Bei einer einzelnen Dachfläche lässt HELIOS die Variable weg. Der Collector selbst kennt keine Obergrenze, im kostenlosen Tarif setzt jedoch das Abfragelimit die Grenze.
>

### `SOLCAST_SITE`<span class="badge optional"></span>

ID der Dachfläche bei Solcast, im Format `xxxx-xxxx-xxxx-xxxx`. Der Wert gilt für jede Dachfläche, die keine eigene [`SOLCAST_X_SITE`](#solcast_x_site) hat. Bei einer einzelnen Dachfläche ist er damit Pflicht.

```properties title="Beispiel"
SOLCAST_SITE=1111-1111-1111-1111
```

> **HELIOS**
>
>
> HELIOS fragt die Ressourcen-ID unter _Konfiguration → Datenquellen → Forecast-Collector_ ab und setzt die Variable immer.
>

### `SOLCAST_X_SITE`<span class="badge optional"></span>

ID der Dachfläche `X`, gezählt ab `0`, im Format `xxxx-xxxx-xxxx-xxxx`. Pflicht, sobald mehr als eine Dachfläche konfiguriert ist.

Fehlt eine der indizierten Variablen, greift [`SOLCAST_SITE`](#solcast_site). Der Collector fragt dann still dieselbe Site zweimal ab und zählt ihre Prognose doppelt.

```properties title="Beispiel"
SOLCAST_0_SITE=1111-1111-1111-1111
SOLCAST_1_SITE=2222-2222-2222-2222
```

> **HELIOS**
>
>
> HELIOS setzt `SOLCAST_0_SITE` und `SOLCAST_1_SITE`, sobald zwei Dachflächen eingetragen sind.
>

## Abfrageintervall

### `FORECAST_INTERVAL`<span class="badge required"></span>

Abstand zwischen zwei Abfragen in Sekunden, eine positive Ganzzahl. Fehlt die Variable oder steht dort keine positive Zahl, bricht der Collector beim Start ab.

Solcast erlaubt im kostenlosen Tarif 10 Abfragen pro Tag, also frühestens alle 8640 Sekunden. Der Collector fragt jede Dachfläche einzeln ab, das Limit teilt sich also auf: Bei zwei Dachflächen sind mindestens 17280 Sekunden nötig.

```properties title="Beispiel"
FORECAST_INTERVAL=17280
```

> **HELIOS**
>
>
> HELIOS fragt das Intervall unter _Konfiguration → Datenquellen → Forecast-Collector_ ab. Bleibt das Feld leer, setzt HELIOS `900` — für den kostenlosen Solcast-Tarif viel zu wenig.
>