Wie wรคre es, wenn du dir die aktuellen Spritpreise in Home Assistant automatisch anzeigen lassen kรถnntest und dir dein Smarthome somit hilft Geld zu sparen? Ich zeige dir wie das geht!
Vor Monaten bin ich รผber die Handy-App Bertha gestolpert, mit der man sich auf einer Landkarte die jeweils aktuellen Spritpreise anzeigen lassen kann. Wenn man mit dem Auto unterwegs ist und tanken muss, genรผgt ein kurzer Blick in die App und man sieht auf einem Blick, wo das Tanken im Umkreis aktuell am gรผnstigsten ist. Seitdem nutze ich diese App regelmรครig.
Spritpreise รผber API abfragen
Mit der Entdeckung der App habe ich mich aber auch gefragt, was man mit den aktuellen Daten รผber Spritpreise an Tankstellen noch machen kรถnnte. Seit einigen Jahren mรผssen Tankstellenbetreiber die aktuellen Preise fรผr die angebotenen Kraftstoffe an das Bundeskartellamt melden. Dann gibt es wiederum Anbieter, wie etwa Tankerkรถnig, die diese aktuellen รผber eine API zum kostenlosen Abruf anbieten. Und da ich immer auf der Suche nach neuen „Bastelprojekten“ bin, habe ich mir ein kleines PHP-Script gebaut.
Dieses PHP-Script hat dann รผber einen Cronjob alle 15 Minuten die aktuellen Spritpreise der fรผr mich relevanten Tankstellen (also die im Umkreis um meinen Wohnort) abgefragt und in einer Datenbank gespeichert. Diese Daten konnte ich mir dann einfach anzeigen lassen, wenn immer es fรผr mich relevant war. Diese Anzeige hatte ich ursprรผnglich als Iframe in Lovelace angebunden. Somit hatte ich immer die aktuellen Spritpreise in Home Assistant!
Inhaltsverzeichnis
Spritpreise in Home Assistant
Technisch funktionierte das einwandfrei und auch verlรคsslich. Doch dann bin ich vor wenigen Tagen รผber die Home Assistant Integration Tankerkoenig gestolpert. Diese Integration macht alles von mir zuvor beschriebene direkt in Home Assistant und liefert somit in wenigen Minuten jedem Smarthome-Besitzer die aktuellen Spritpreise!
Tankerkรถnig API Key beantragen
Damit man auf die Daten der Tankerkรถnig API zugreifen kann, muss man einmalig einen kostenlosen API Key von Tankerkรถnig beantragen. Mit diesem kostenlosen API-Zugriff darf man maximal alle 5 Minuten die aktuellen Spritpreise abfragen – fรผr unseren Zweck die Spritpreise in Home Assistant anzuzeigen absolut ausreichen!
Um einen API Key zu beantragen muss man lediglich auf https://creativecommons.tankerkoenig.de/ oben rechts auf API-KEY klicken und die eigene E-Mail Adresse, sowie einen Verwendungszwecke (zum Beispiel „anderes Home-Automation-System“) angeben.
Tankerkoenig Integration konfigurieren
Hast du den benรถtigten API Key kannst du in Home Assistant die Tankerkoenig Integration konfigurieren. Hierfรผr musst du in deiner configuration.yaml nur wenige Zeilen Code ergรคnzen:
tankerkoenig: api_key: XXXXXXX-a11a-a11a-a11a-XXXXXXXXXXXX radius: 4 fuel_types: - "e10"
Mir diesen Angaben holt sich dich Tankerkoenig automatisch im Radius von 4km um meinen Wohnort die Spritpreise fรผr den Kraftstoff E10. Die Konfigurationsmรถglichkeiten sind sehr vielfรคltig und kรถnnen in deinem Fall natรผrlich komplett anders aussehen (insbesondere des erfundenen API-Keys natรผrlich! :)).
Bei meiner Konfiguration ist zum Beispiel auch Voraussetzung, dass ich in der configuration.yaml bereits Angaben zu meinem Wohnort gemacht habe (also Lรคngen- und Breitengrade).
Aktuelle Spritpreise in Home Assistant anzeigen
Sobald die Integration das erste mal รผber die API die aktuellen Spritpreise geladen hat, sollten diese in Home Assistant als Sensor auftauchen:
Somit kannst du nun mit den Sensoren „arbeiten“, wie du es in Home Assistant auch mit anderen Sensoren tun kannst:
- Automatisierungen (zum Beispiel eine Benachrichtigung, sobald der Spritpreis unter X Euro gesunken ist)
- Anzeige in Lovelace
- Historiendaten
- etc.
Aktuelle Spritpreise in Lovelace anzeigen
Ich selbst habe bislang keine Automatisierungen oder รคhnliches mit den zusรคtzlichen Daten (also Spritpreisen) gebaut. Stattdessen zeige ich diese in Lovelace auf meiner Dashboard-Seite an:
Neben der aktuellen Feinstaubbelastung, der aktuellsten PIN fรผr die DHL-Packstation oder dem aktuellen Mรผllkalender sehe ich nun bei einem Blick auf mein Home Assistant Dashboard immer auch die aktuelle Spritpreise der fรผr mich relevanten Tankstellen. Zugegeben: An dem Design muss ich noch arbeiten (also insbesondere, dass dort die richtigen Namen stehen und auch die Logos der jeweiligen Tankstelle angezeigt werden), aber rein technisch funktioniert es einwandfrei!
Produktempfehlungen
รber folgendes ist eine schรถnere Benennung mรถglich.
Im beispiel habe ich meine nach benannt 🙂
customize_glob:
sensor.tankerkoenig_*:
templates:
friendly_name: >
return entity.attributes.city + ‚ ‚ + entity.attributes.brand + ‚ ‚ + entity.attributes.fuel_type;
Absolut cooler Hinweis – wird direkt mal umgesetzt und bei Gelegenheit im Post ergรคnzt! Vielen Dank!!!
Servus! Leider klappt das bei mir nicht. Hat sich hier die Syntax mal geรคndert?
Bei mir steht dann die Return Anweisung als Text fรผr den „Friendly Name“ in Lovelace.
Hi!
Ich habe es gerade extra getestet: Wenn ich einen meiner Tankerkรถnig-Sensoren (sensor.tankerkoenig_aral_tankstelle_bat_aggertal_nord_e10) in Lovelace hinzufรผge, erhalte ich folgende Ansicht:
Kannst du denn unter Entwicklerwerkzeuge -> Zustรคnde die von Tankerkรถnig erhaltenen Werte sehen (also Angaben zur Tanksteller, aktueller Preise etc.?)
Ach so, vermutlich war dein Kommentar auf die von „Einstein Zweistein“ gepostete Anpassung bezogen…
Tatsรคchlich habe ich die gar nicht mehr im Einsatz, da ich mittlerweile in Lovelace eine ganz eigene View fรผr die Preise nutze.
Wie sieht denn dein Code hierfรผr konkret aus, kannst du den mal posten?
Hallo Olli. Wirklich ’ne Top Seite. Ein paar deiner 59 Ideen stehen noch auf meiner „to do“-Liste. Momentan bin ich bei dem Thema „Spritpreise“. Funktioniert soweit auch, aber die Benennung ist tatsรคchlich suboptimal. Du erwรคhntest ja, du hast „eine ganz eigene View“ fรผr die Preise und ich meine auch, in irgendeinem Screenshot in einem anderen Beitrag von dir, hรผbsche Tankstellen-Logos gesehen zu haben. Kรถnntest du noch nรคher da drauf eingehen? Das wรคr top.
Beste Grรผรe
Hallo Michael,
derzeit nutze ich fรผr die Anzeige in Lovelace eine Custom-Card, welche ich hier https://github.com/panbachi/tankerkoenig-card gefunden habe. Gefรคllt mir persรถnlich sehr gut und ist relativ einfach umzusetzen!
Beste Grรผรe
Olli