Benzinpreise in Home Assistant sortieren und anzeigen mit Tankerkönig

21340 4. April 2022 Geschrieben von: Daniel Scheidler

DERUC Geeetech Acryl Prusa 3D Drucker DIY Kit Pro B Einfache Montage Prusa I3 Acryl-3D-Drucker kit

In diesem Beitrag möchte Ich euch zeigen, wie Ihr aktuelle Benzinpreise in Home Assistant sortieren und anzeigen könnt. Dazu verwenden wir die Daten von https://www.tankerkoenig.de.

Für deren Daten gibt es nämlich auch eine Integration für Home Assistant. Weitere Informationen dazu findet Ihr unter folgendem Link:
https://www.home-assistant.io/integrations/tankerkoenig/

Tankerkönig API Key erstellen

Um die Daten von Tankerkönig nutzen zu können, benötigen wir als aller erstes einen API-Key. Diesen könnt Ihr unter folgender Adresse anfordern:
https://creativecommons.tankerkoenig.de/

Folgt anschließend einfach den Anweisungen und Ihr erhaltet euren Key kurze Zeit später per Email. Damit der Key dann auch funktioniert, müsst Ihr nur noch in der Email auf den Aktivierungslink klicken. Dann seid Ihr auch schon startklar.

Tankerkönig Integration in Home Assistant einrichten

Um die Tankerkönig Integration in Home Assistant einzurichten müssen wir die Datei configuration.yaml um folgenden Eintrag erweitern.

tankerkoenig:
  api_key: "0000000-0000-0000-0000-00000000000000"
  fuel_types:
    - "e5"
    - "diesel"
  latitude: 51.45746
  longitude: 7.529542
  radius: 3
  scan_interval: 1800

Als Api-Key tragt Ihr den per Email erhaltenen Schlüssel ein.
Gültige Benzin-Arten (fuel_type) sind e5, e10 und diesel.

Latitude und Longitude sind Koordinaten für euren Standort. Diese ermittelt Ihr am einfachsten über Google Maps (Wie genau erkläre ich im Video).

Der Radius gibt an, in welchem Umkreis in Kilometern die Tankstellen um euren Standort abgerufen werden sollen.

Das Scan-Interval regelt, in welchem zeitlichen Abstand in Sekunden die Tankstellendaten aktualisiert werden sollen.

ACHTUNG!
Sind die Tankstellen geschlossen, liefert die Entität der jeweiligen Tankstelle als Zustand “unknown“! Seht Ihr also in der Anzeige mal keinen Preis sondern nur das Wort “unknown“, liegt also eventuell kein Einrichtungsfehler vor, sofern die Tankstelle hat einfach nur geschlossen.

Entities gruppieren

Damit wir die Benzinpreise sortieren können, müssen wir alle Entitäten zuerst in einer Gruppe zusammenfassen. Gruppen werden in der configuration.yaml unter dem Hauptknoten “groups” konfiguriert.

Ich empfehle, hierzu eine Datei groups.yaml anzulegen und in der Datei configuration.yaml diese nur mit folgendem Befehl einzubinden. Somit habt Ihr etwas mehr Ordnung in der Konfiguration.

group: !include groups.yaml

In der Datei groups.yaml fügt Ihr einen Eintrag wie den folgenden ein.
(Die Entitie-Einträge müsst Ihr dabei an eure Entitäten der Tankerkönig Integration anpassen)

all_fuel_sensors:
  name: Benzinpreise
  all: true
  icon: mdi:gas-station-outline
  entities:
    - sensor.tankerkoenig_jet_wermelskirchen_burger_str_44_e5
    - sensor.tankerkoenig_shell_wermelskirchen_huenger_12_e5
    - sensor.tankerkoenig_shell_wermelskirchen_neuenfluegel_59_e5
    - sensor.tankerkoenig_rewe_tankstelle_e5

Nachdem die Gruppe angelegt ist, solltet Ihr eueren Home Assistant-Server einmal neu starten.

Markdown Card für die sortierte Anzeige

Nachdem wir im Home Assistant nun alle relevanten Entities zu einer Gruppe zusammengefasst haben, können wir uns nun um die Anzeige kümmern. Dazu legen wir eine Karte vom Typ “manual” an und tragen dort im Code-Editor folgendes ein:

type: markdown
content: >-
  # E5: {% for entity in  expand('group.all_fuel_sensors') | sort(attribute='state') | map(attribute='entity_id') | map('string')  | list %}
  {% if 'Shell' in state_attr(entity, "station_name") %} 
    ![Image](/local/shell.png) 
  {% elif 'JET' in state_attr(entity, "station_name") %} 
    ![Image](/local/JET.png) 
  {% endif %}
    {{state_attr(entity, "station_name")}}
    ## {{states(entity) }} €
    ***
  {% endfor%}

Grafiken für Tankstellenlogos

Die Grafiken für die jeweiligen Tankstellen , welche im IF-Block erzeugt werden, (Im Beispiel JET und Shell) müssen im Dateisystem von eurem Home Assistant abgelegt sein.
Die Pfadangabe “/local/” entspricht dabei im Home Assistant dem Ordner “/config/”. Im Beispiel müsste also z.B. die Datei JET.png bei Home Assistant unter /config/JET.png abgelegt sein. Ihr könnt natürlich auch einen Unterordner z.B. “Bilder” im config-Ordner dafür anlegen. Dann wäre der Pfad entsprechend “/local/Bilder/JET.png)

Die Größe der Bilder bestimmt Ihr durch die Auflösung der Grafiken. Sind euch die Bilder in der Anzeige zu groß, müsst Ihr also die Original-Grafik verkleinern.

Video

Für alle, die den gesamten Ablauf noch einmal Schritt für Schritt sehen möchten, habe ich hier das Thema “Benzinpreise in Home Assistant sortieren” auch noch einmal in einem Video zusammengefasst.