Beschreibung
Logikbaustein für aktuelle Spritpreise über die API von Tankerkönig. Er unterstützt mehrere Tankstellen, die günstigste offene Tankstelle und feste Tankstellen (Stammtankstellen).
Für den Betrieb braucht man einen eigenen, kostenlosen API-Key von https://onboarding.tankerkoenig.de. Den Key nicht veröffentlichen.
- Gerät
- Gira X1
- Version
- 1.0.0
- Lizenz
- Ein Schlüssel je X1 (MAC-Adresse), dauerhaft nutzbar
- Thema
- Daten aus dem Netz
Hinweis zur Schnittstelle: Der Baustein nutzt die Schnittstelle von tankerkoenig.de. Ändert der Anbieter sie oder stellt sie ein, kann der Baustein eingeschränkt oder gar nicht mehr funktionieren, bis er angepasst ist. Wir passen ihn nach Möglichkeit an, einen Anspruch darauf gibt es nicht.
Anleitung
Modi
| Modus | API | Wofür |
|---|---|---|
| Umkreissuche | list.php |
Alle Tankstellen im Umkreis (höchstens 25 km) um Breiten- und Längengrad |
| Feste Tankstellen | prices.php |
Bis zu 10 bestimmte Tankstellen über ihre ID. Diese Abfrage empfiehlt Tankerkönig für regelmäßige Aktualisierungen |
Pro Abfrage holt der Baustein immer alle Sorten (E5, E10, Diesel). Welche Sorte zählt und wie sortiert wird, wertet er selbst aus. Ein Wechsel der Sorte kostet also keine zusätzliche Abfrage.
Die ID einer Tankstelle steht im Ausgang „ID günstigste“ oder im Ausgang „JSON“ einer Umkreissuche.
Abfrageintervall
Abgefragt wird, wenn der Eingang „Trigger“ den Wert 1 bekommt. Tankerkönig erlaubt mit der freien API höchstens eine Abfrage pro Minute. Für Hausautomation gilt: höchstens alle 5 Minuten und nicht zu runden Uhrzeiten, z. B. alle 7 Minuten. Bei Missbrauch sperrt Tankerkönig den Key.
Kommt der Trigger innerhalb von 60 Sekunden nach der letzten Abfrage, ignoriert ihn der Baustein. Den Grund zeigt dann „Debug“.
Parameter
| Parameter | Bedeutung |
|---|---|
| API-Key | Persönlicher Tankerkönig-Key |
| Modus | Umkreissuche (Vorgabe) oder Feste Tankstellen |
| Spritsorte | E5, E10 (Vorgabe) oder Diesel. Gilt für „Günstigster Preis“, „Preis i“ und die Sortierung |
| Breitengrad (nur Umkreissuche), Längengrad (nur Umkreissuche) | Standort der Umkreissuche. Vorgabe 52.521 / 13.438 (Berlin), unbedingt auf den eigenen Standort ändern |
| Suchradius in km (nur Umkreissuche, max. 25) | 0,1 bis 25, Vorgabe 5 |
| Sortierung (nur Umkreissuche) | nach Preis der Spritsorte (Vorgabe, Tankstellen ohne Preis am Ende) oder nach Entfernung |
| Tankstellen-IDs (nur feste Tankstellen, kommagetrennt, max. 10) | Bis zu 10 IDs, getrennt durch Komma, Semikolon oder Leerzeichen. Ungültige IDs meldet die Projektprüfung im GPA (Gira Projekt Assistent) |
| Anzahl Tankstellen | 1 bis 10, Vorgabe 3. So viele Ausgänge „Name i“, „Preis i“, „Offen i“, „Entfernung i in km“ gibt es |
| Bezeichnung Tankstelle i (ausgeblendet) | Feste Tankstellen: Name für die i-te ID, weil prices.php keine Namen liefert. Leer = ID |
| Lizenzschlüssel | Schlüssel für diesen X1, siehe „Lizenz“ |
Ausgänge
| Ausgang | Bedeutung |
|---|---|
| Günstigster Preis | Preis der Spritsorte in Euro je Liter bei der günstigsten offenen Tankstelle, 0 = keine gefunden |
| Name günstigste, Adresse günstigste | Daten dieser Tankstelle. Bei festen Tankstellen ist die Adresse leer |
| Marke günstigste, ID günstigste (ausgeblendet) | Daten dieser Tankstelle. Bei festen Tankstellen ist die Marke leer |
| Anzahl offen (ausgeblendet) | Anzahl der geöffneten Tankstellen in der Liste |
| Name i, Preis i | Je Tankstelle in der Reihenfolge der Sortierung (feste Tankstellen: Reihenfolge der IDs). Preis 0 = Sorte nicht geführt oder kein Preis |
| Offen i, Entfernung i in km (ausgeblendet) | Geöffnet bzw. Entfernung. Die Entfernung gibt es nur bei der Umkreissuche, bei festen Tankstellen ist sie 0 |
| Letzte Abfrage (ausgeblendet) | Zeit der letzten erfolgreichen Abfrage, TT.MM.JJJJ HH:mm:ss |
| JSON (ausgeblendet) | Alle Tankstellen als JSON-Liste (id, name, marke, adresse, entfernung, offen, e5, e10, diesel, ohne Preis null) |
| Lizenzstatus, Debug | Lizenzprüfung, Ergebnis bzw. Fehler der letzten Abfrage |
Ausgeblendete Parameter und Ausgänge lassen sich im GPA am Baustein einblenden.
Fehlerverhalten: Bei Verbindungsproblemen, Fehlermeldungen der API (ok: false) oder HTTP-Fehlern bleiben die Ausgänge auf dem letzten Stand, der Grund steht unter „Debug“. Plätze, für die eine erfolgreiche Abfrage keine Tankstelle mehr liefert, werden zurückgesetzt.
Datenquelle
Die Daten kommen von der Markttransparenzstelle für Kraftstoffe (MTS-K) und werden über Tankerkönig unter CC BY 4.0 bereitgestellt. Wer die Preise z. B. in einer Visualisierung zeigt, nennt dort tankerkoenig.de als Quelle.
Lizenz
Der Lizenzschlüssel wird im GPA im Parameter „Lizenzschlüssel“ eingetragen. Der Baustein prüft ihn beim Start auf dem X1, offline und gebunden an die MAC-Adresse des X1. Der Ausgang „Lizenzstatus“ zeigt das Ergebnis, bei einem Schlüssel für ein anderes Gerät auch die MAC-Adresse dieses X1. Ohne gültigen Schlüssel fragt der Baustein nichts ab. In der Simulation des GPA am PC läuft er ohne Lizenzprüfung, damit sich Logikblätter testen lassen.
Läuft eine Testlizenz ab, ignoriert der Baustein ab dem nächsten Trigger alle Abfragen, bis ein neuer Schlüssel eingetragen ist. Die Ausgänge bleiben auf dem letzten Stand. Den Schlüssel erhältst du beim Kauf über smolabs.de.
Verwendetes Icon: <a href=“https://www.flaticon.com/free-icons/gas-station“ title=“gas station icons“>Gas station icons created by DinosoftLabs – Flaticon</a>
Changelog
Version 1.0.0
- Erste Version.
Rezensionen
Es gibt noch keine Rezensionen.