Tankerkönig openHAB

openHAB – Spritpreise mit Tankerkönig

Tankerkönig openHAB

Tankerkönig ist ein Dienstleister für Spritpreise, die Daten über die Markttransparenzstelle für Kraftstoffe bereitstellt, die wir in openHAB einbauen.

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 openHABDieses 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 openHAB

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 openHAB

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.

[
  {
    "id": "4f8b3346-f4f4-4dab-8263-e68c2be8ec06",
    "name": "Esso Tankstelle",
    "brand": "ESSO",
    "street": "BAHNHOFSTR. 33",
    "house_number": "",
    "post_code": 71287,
    "place": "WEISSACH",
    "lat": 48.84681,
    "lng": 8.93225,
    "isOpen": true
  },
  {
    "id": "33b13644-56bc-4636-9b79-be20f187452d",
    "name": "RUTESHEIM, MARGARETE-STEIFF-STR.",
    "brand": "Shell",
    "street": "MARGARETE-STEIFF-STR. 2",
    "house_number": "",
    "post_code": 71277,
    "place": "RUTESHEIM",
    "lat": 48.810788,
    "lng": 8.92719,
    "isOpen": true
  },
  {
    "id": "732cfd82-f764-44f5-a5d9-574f4eb7588d",
    "name": "Heimsheim Römerstr. 1",
    "brand": "OMV",
    "street": "Römerstr.",
    "house_number": "1",
    "post_code": 71296,
    "place": "Heimsheim",
    "lat": 48.82422,
    "lng": 8.86853,
    "isOpen": true
  }
]

 

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 openHAB

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 openHAB

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

Tankerkönig openHAB

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

[btn=’Tankerkönig auf Google Play‘,’google‘]https://play.google.com/store/apps/details?id=de.tankerkoenig.simpleapp&hl=de[/btn] [btn=’Tankerkönig im Apple Appstore‘,’apple‘]https://itunes.apple.com/de/app/tankerkonig/id980576151?mt=8[/btn] [btn=’Tankerkönig im Windows Store‘,’windows‘]https://www.microsoft.com/de-de/store/p/tankerkonig/9wzdncrdr28k[/btn]

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