openHAB - Spritpreise mit Tankerkönig

Tankerkönig openHAB

Mineralölunternehmen und Tankstellenbetreiber übermitteln ihre tagesaktuellen Preise an die Markttransparenzstelle für Kraftstoffe (MTS-K) des Bundeskartellamts. Diese Daten können von ausgewählten Dienstleistern ausgewertet und auf Webseiten oder Apps bereitsgestellt werden.


Das Stuttgarter Unternehmen Tankerkönig ist einer dieser Dienstleister, die neben eigenen Apps Daten auch eine API zur Verfügung stellt. Diese Daten werden unter der Creative Commons Lizenz für Privatanwender kostenlos angeboten.


Für openHAB gibt es ein passendes Binding, mit dem sich die aktuellen Spritpreise von Tankstellen Eurer Wahl darstellen und auch auswerten lassen.


Addon (Binding) installieren

Das Binding lässt sich einfach über die Addons installieren.


Tankerkönig Addon


Dieses Binding stellt euch zwei Things zur Verfügung:

  • Tankerkönig Webservice
  • Tankstelle

Der Webservice ist sozusagen die Schnittstelle zur Tankerkönig-API. Das Tankstellen-Thing dann die individuelle Tankstelle mit den Preisen zu E5, E10 und Diesel.


Tankerkönig-API-Key beantragen

Der API-Key kann über die Tankerkönig Webseite beantragt werden. Unter der URL https://creativecommons.tankerkoenig.de/ könnt Ihr euch einen API-Key generieren lassen, indem Ihr im Menü auf API-Key klickt.


Tankerkönig API Registratur


Ihr musst eine gültige E-Mail-Adresse sowie den Verwendungszweck angeben und erhaltet dadurch einen API-Key per E-Mail zugeschickt.

Bitte beachtet hier unbedingt die Nutzungsbedingungen von Tankerkönig.


Tankerkönig Webservice anlegen

Der erste Schritt nach dem Erhalt des API-Keys ist die Anlage des Webservices. Hierzu gehen wir in die Inbox von openHAB und legen manuell ein neues Thing an. Wir wählen hier das Tankerkönig-Binding aus und anschließend Tankerkönig Webservice.


Tankerkönig Webservice

Wichtig ist hier neben der Eintragung des API-Keys auch den Aktualisierungsintervall entsprechend der Nutzungbedingungen von Tankerkönig zu setzen. Stellt man hier eine zu geringen Wert ein, kann es unter Umständen vorkommen, dass der API-Key wegen Überbeanspruchung von Tankerkönig gesperrt wird. Sechzig Minuten sind hier ein akzeptabler Wert.


Über den Schalter Öffnungszeiten lässt sich auch anzeigen, ob die Tankstelle im Moment geöffnet hat (siehe weiter unten).


ID der Tankstelle herausfinden

Um nun die Preise einer bestimmten Tankstelle angezeigt zu bekommen, benötigt man die eindeutige ID dieser Tankstelle. Dazu stellt Tankerkönig eine Karte bereit, mit der alle Tankstellen und die notwendigen Daten abgefragt werden können.


Tankstellenfinder von Tankerkoenig.de


Dazu zieht man den roten Pin per Drag'n'Drop in den Bereich in den man sich die Tankstellen angezeigt haben will.

Nun kann man per Klick die gewünschten Tankestellen übernehmen und mit einem Klick auf Tankstellen übernehmen die Daten der Tankstellen anzeigen lassen.



Interessant sind hier nur die IDs der entsprechenden Tankstellen, die wir uns einzeln in die Zwischenablage kopieren.


Tankstellen anlegen

Als nächstes öffnen wir wieder die Inbox von openHAB und fügen ein neues Thing vom Typ Tankstelle aus dem Tankerkönig-Binding hinzu.


Tankerkönig Binding



Als Bridge wählen wir unseren vorhin angelegten Webservice aus, im Feld Tankstellen-ID fügen wir dann den kopierten ID-Code der Tankstelle ein.

Das wiederholen wir für jede der Tankstellen.


Anschließend haben wir ein Thing das uns die aktuellen Preise von E5, E10 und Diesel anzeigt.


Tankerkönig Finish



Die Preise lassen sich dann natürlich auch in habPANEL oder Grafana in Diagrammform anzeigen. Beachtet dazu unseren entsprechenden Guides.



Grafana Tankerkönig


Weitere Möglichkeiten

Die Firma Tankerkönig bietet neben der API auch eigenen Apps für die gängigen Smartphones an. Damit müsst Ihr auch unterwegs nicht auf die aktuellsten Spritpreise verzichten


Tankerkönig auf Google Play Tankerkönig im Apple Appstore Tankerkönig im Windows Store




Viel Spaß beim Ausprobieren und vielen Dank an Tankerkönig für diesen tollen Service!

    Über den Autor

    Gründer und Autor von worldoftech.de

    Seit 25 Jahren im Bereich IT unterwegs, leidenschaftlicher Computerspieler, Technik-Freak und begeistert von allem was einen Motor (Auto/Motorrad/Flugzeug) hat.


    Nutzt Zuhause openHAB2 zusammen mit HomeMatic Komponenten sowie netatmo als Wetterstation. InfluxDB und Grafana zur Auswertung. Weitere Gadgets von Xiaomi, Sonos und Samsung

    Patrick Team

    Kommentare 1

    • Moin und Danke für das Tutorial.

      Eine Anmerkungnocj, es kann nicht nur angezeigt werden ob eine Tankstelle offen ist, die Information kann im Modus "OpeningTimes" (schaltbar im Webservice) genutzt werden, Preisanfragen nur dann zu starten, wenn auch offen ist. Dies kann den Tankerkönig Server entlasten.


      Jürgen Baginski