# Was ist der Public-Data-Collector?

> Der Public-Data-Collector holt öffentliche Preise für Kraftstoffe, Heizöl, Gas und Strom, etwa um ein E-Auto mit einem fiktiven Verbrenner zu vergleichen.

Der **Public-Data-Collector** holt öffentliche Preise und Werte und schreibt sie in die InfluxDB. Jede Gruppe von Werten dient einem eigenen Zweck:

- **Benzin, Diesel und Autogas**: Mit ihren Preisen lässt sich ein E-Auto mit einem fiktiven Verbrenner vergleichen, der dieselbe Strecke fährt.
- **Heizöl und Erdgas**: Mit ihren Preisen lässt sich eine Wärmepumpe mit einer Öl- oder Gasheizung vergleichen.
- **Börsenstrompreis und Anteil erneuerbarer Energien**: Sie zeigen, wann Strom aus dem Netz günstig oder grün ist.
- **CO₂-Intensität des Netzstroms**, bislang nur für Deutschland: Mit ihr lässt sich je Viertelstunde berechnen, wie viel CO₂ der Netzbezug verursacht und die PV-Anlage eingespart hat. Heute rechnet das Dashboard die Einsparung mit einem festen [CO₂-Faktor](/docs/referenz/dashboard/allgemeine-konfiguration/#co2_emission_factor).

> **Genutzt ab Dashboard 1.4 (Beta)**
>
>
> Bislang nutzt nur das Dashboard ab Version 1.4 die Werte, und davon nur die Kraftstoffpreise. Version 1.4 erscheint vorerst als Beta im Kanal **Develop**. Das Dashboard vergleicht damit die Kosten eines E-Autos mit einem fiktiven Verbrenner. Die gefahrene Strecke kommt aus dem Sensor für den [Kilometerstand](/docs/referenz/dashboard/sensor-konfiguration/#influx_sensor_car_odometer_x). Weil die Preise in Euro vorliegen, muss das Dashboard außerdem mit der Währung Euro arbeiten.
>
> Ohne E-Auto wird der Collector also noch nicht gebraucht. Die übrigen Werte sind für spätere Versionen vorgesehen.
>

## Quellen

Der Collector liest drei Quellen. Alle sind kostenlos und brauchen weder ein Konto noch einen API-Key. Jede wird mit einem eigenen [Schalter](/docs/referenz/public-data-collector/konfiguration/#enable_fuel) eingeschaltet:

| Quelle              | Werte                           | Schalter             |
| ------------------- | ------------------------------- | -------------------- |
| Weekly Oil Bulletin | Kraftstoffe und Heizöl          | `ENABLE_FUEL`        |
| Eurostat            | Erdgas                          | `ENABLE_GAS`         |
| Energy-Charts       | Strom aus dem öffentlichen Netz | `ENABLE_PUBLIC_GRID` |

Das [Weekly Oil Bulletin](https://energy.ec.europa.eu/data-and-analysis/weekly-oil-bulletin_en) gibt die Europäische Kommission heraus, [Eurostat](https://ec.europa.eu/eurostat) ist das Statistikamt der EU. [Energy-Charts](https://www.energy-charts.info/) betreibt das Fraunhofer ISE. Alle drei decken die Mitgliedstaaten der EU ab, Eurostat und Energy-Charts zusätzlich einige weitere Länder in Europa.

## Geschriebene Werte

Die Namen in der InfluxDB sind fest vorgegeben. Das Dashboard findet die Werte deshalb ohne eigene Konfiguration.

| Measurement:Field            | Wert                         | Einheit | Ein Wert je   |
| ---------------------------- | ---------------------------- | ------- | ------------- |
| `Fuel:price_petrol`          | Benzin                       | EUR/l   | Woche         |
| `Fuel:price_diesel`          | Diesel                       | EUR/l   | Woche         |
| `Fuel:price_lpg`             | Autogas                      | EUR/l   | Woche         |
| `Fuel:price_heating_oil`     | Heizöl                       | EUR/l   | Woche         |
| `Gas:price`                  | Erdgas                       | EUR/kWh | Monat         |
| `PublicGrid:price`           | Day-Ahead-Preis              | EUR/kWh | Viertelstunde |
| `PublicGrid:renewable_share` | Anteil erneuerbarer Energien | Prozent | Viertelstunde |
| `PublicGrid:co2_intensity`   | CO₂-Intensität               | g/kWh   | Viertelstunde |

### Kraftstoffe und Heizöl

Die Preise sind Landesdurchschnitte, alle Steuern sind enthalten. Sie zeigen, was ein Jahr Fahren oder Heizen kostet, aber nicht, wo das Tanken heute am günstigsten ist.

Für Benzin meldet das Bulletin nur einen einzigen Preis, den für Super mit 95 Oktan. In Deutschland gibt es davon zwei Sorten: Super E5 mit bis zu 5 Prozent Ethanol und das meist günstigere Super E10 mit bis zu 10 Prozent. Der Wert für Deutschland entspricht dem Preis für E5. Wer E10 tankt, zahlt weniger, am 14. September 2026 etwa 9 Cent je Liter. Der Vergleich mit dem fiktiven Verbrenner rechnet deshalb mit dem etwas teureren E5.

Meldet ein Land ein Produkt nicht, bekommt dieses Produkt für die Woche keinen Wert.

### Erdgas

Der Preis ist der Durchschnitt, den Haushalte je kWh zahlen, inklusive aller Steuern und Abgaben. Eurostat ermittelt ihn für einen Jahresverbrauch von 5.556 bis 55.556 kWh, das passt zu einem Einfamilienhaus. Die Grundgebühr ist auf die kWh umgelegt und darf nicht noch einmal dazugerechnet werden.

Eurostat misst den Preis nur halbjährlich und veröffentlicht ihn etwa sechs Monate später. Für die Monate danach schreibt der Collector den Preis mit dem monatlichen Preisindex für Erdgas fort. Diese Werte sind Schätzungen. Sobald Eurostat ein neues Halbjahr veröffentlicht, ersetzt dessen Messwert die geschätzten Monate. Auswertungen der letzten Monate können sich dadurch noch ändern.

### Strom

Der **Day-Ahead-Preis** ist das Ergebnis der täglichen Auktion an der Strombörse für den Folgetag. Netzentgelte, Abgaben und Steuern sind nicht enthalten. Bis zum 30. September 2025 gab es einen Preis je Stunde, die Historie hat bis dahin deshalb einen Wert je Stunde. Die Preise des [Tibber-Collectors](/docs/referenz/tibber-collector/) sind etwas anderes: Sie enthalten alle Bestandteile des Tibber-Tarifs und landen im Measurement `Prices`. Beide Collectoren können nebeneinander laufen.

Der **Anteil erneuerbarer Energien** bezieht sich auf den Stromverbrauch des Landes. Die Werte reichen bis zum Ende des Folgetags, die künftigen sind eine Prognose des Fraunhofer ISE. Über 100 Prozent sind kein Fehler: Dann erzeugen Wind und Sonne mehr, als das Land gerade verbraucht.

Die **CO₂-Intensität** gibt an, wie viel Gramm CO₂ eine kWh Strom in Deutschland verursacht hat. Energy-Charts liefert diesen Wert nicht. Der Collector berechnet ihn aus der Erzeugung je Kraftwerkstyp und den Emissionsfaktoren des Umweltbundesamts. Er existiert nur für Deutschland, und der neueste Wert ist etwa zwei Stunden alt.

## Zeitplan

Beim Start liest der Collector jede eingeschaltete Quelle. Danach liest er die Stromwerte alle [`INTERVAL`](/docs/referenz/public-data-collector/konfiguration/#interval) Sekunden. Kraftstoff- und Gaspreise ändern sich höchstens einmal pro Woche. Sie kommen deshalb freitags um 6:00 Uhr in der Zeitzone aus [`TZ`](/docs/referenz/public-data-collector/konfiguration/#tz).

Bei den Kraftstoffpreisen schreibt jeder Abruf die letzten acht Wochen neu. Korrigiert die Europäische Kommission eine ältere Woche, kommt die Korrektur mit dem nächsten Start.

## Historie

Beim ersten Start schreibt der Collector auch die vergangenen Werte, und zwar ab dem Zeitpunkt, an dem die übrigen Daten im Bucket beginnen. Ältere Werte würden die InfluxDB mehr Speicher kosten und hätten nichts, womit sie sich vergleichen ließen. Für Deutschland reichen die Kraftstoffpreise bis 2005 zurück, der Gaspreis bis 2007. Bei den Stromwerten beginnen Anteil und CO₂-Intensität 2015, der Day-Ahead-Preis 2018.

Wo die Daten beginnen, liest der Collector beim Start aus der InfluxDB. Dazu braucht der Token Leserecht, siehe [`INFLUX_TOKEN`](/docs/referenz/public-data-collector/konfiguration/#influx_token). Ohne Leserecht schreibt er nur die neuesten Werte.

Kommen später ältere Messwerte in den Bucket, etwa über den [CSV-Importer](/docs/referenz/csv-importer/), füllt ein Neustart des Collectors die Historie bis dorthin auf. In HELIOS lässt er sich dazu unter _Dienste_ stoppen und wieder starten.

Die Historie der Stromwerte ist groß. Beginnen die Daten 2020, lädt der erste Start mit `ENABLE_PUBLIC_GRID=true` etwa 260 MB herunter und braucht einige Minuten. Spätere Starts holen nur die fehlenden Tage.

## Einrichtung mit HELIOS

HELIOS richtet den Collector selbst ein, eine Eingabemaske gibt es nicht. Er läuft, sobald alle drei Bedingungen erfüllt sind:

- Das Dashboard steht unter _Konfiguration → Einstellungen → Software-Stand_ auf dem Kanal **Develop**, denn nur dort gibt es Version 1.4.
- Unter _Konfiguration → Sensoren_ ist der Kilometerstand eines Fahrzeugs zugeordnet.
- Die Zeitzone unter _Konfiguration → Einstellungen → Grundeinstellungen_ gehört zu einem Mitgliedstaat der EU. Aus ihr leitet HELIOS das Land ab.

HELIOS schaltet nur die Kraftstoffpreise ein. Gaspreis und Stromwerte bleiben aus, denn das Dashboard nutzt sie noch nicht.

## Logging

Der Collector schreibt ein Protokoll ins Docker-Log, das im Normalfall so aussieht:

```log
Public-data collector for SOLECTRUS, Version v0.1.1, built at 2026-11-19T09:12:25.971Z
https://github.com/solectrus/public-data-collector
Copyright (c) 2026 Georg Ledermann, released under the MIT License

Using Ruby 4.0.10 on platform aarch64-linux-musl
Pushing to InfluxDB at http://influxdb:8086, bucket solectrus
Reading at start, then on Friday at 06:00:
  fuel prices for DE from EU Weekly Oil Bulletin => Fuel:price_petrol, Fuel:price_diesel, Fuel:price_heating_oil, Fuel:price_lpg

Wait until InfluxDB is ready ... OK

The other data in the bucket begins on Sat 2022-01-01 at 00:00:00, so the history starts there.

Cycle #1 at 2026-11-19 10:56:31 +0100
  EU Weekly Oil Bulletin
    ✓ fuel prices for DE: 257 weeks, latest 2026-11-16: petrol 2.03, diesel 2.215 EUR/l (from 2021-12-20)
  Next cycle on Fri 2026-11-20 at 06:00:00
```

Je Quelle steht dort eine Zeile mit ✓ oder ✗. Hat eine Quelle keinen Wert für das Land oder antwortet sie nicht, zeigt die Zeile mit ✗ den Grund. Die übrigen Quellen laufen weiter. Der Collector versucht es später erneut, nach jedem weiteren Fehler in größerem Abstand.

Antwortet die InfluxDB beim Start nicht innerhalb einer Minute, bricht der Collector ab, und Docker startet ihn neu. Scheitert später ein Schreibzugriff, versucht er es bis zu fünfmal. Gelingt auch das nicht, schreibt der nächste Abruf dieselben Werte erneut.

## Quelltext

Der Public-Data-Collector ist in Ruby implementiert, der Quelltext ist auf GitHub verfügbar: \
[github.com/solectrus/public-data-collector](https://github.com/solectrus/public-data-collector)
