Carbu.com Smart-Home-Integration, kostenlos und Open Source
Kraftstoffpreise in Belgien, Frankreich, Luxemburg: günstigste Tankstellen und Höchstpreise.
Veröffentlicht von William-De71
- Geräte
- Version 0.1.0
- Erfordert Gladys >=5.1.1
- ★ 0
Überblick
Diese Integration bringt die Kraftstoffpreise von Carbu.com, dem Preisvergleich für Belgien, Frankreich und Luxemburg, in Gladys: rund um einen Ort Ihrer Wahl (eine Postleitzahl) den niedrigsten Preis, den Durchschnittspreis und die günstigste Tankstelle für bis zu vier Kraftstoffe, die Tankstellen, die Sie verfolgen möchten, und die amtlichen Preise (belgische Höchstpreise mit angekündigter oder erwarteter Änderung, amtliche Preise Luxemburgs).
Carbu.com hat weder API noch Konto: Die Integration liest die öffentlichen Seiten der Website wie ein Besucher, standardmäßig stündlich. Die Preise werden dort von Autofahrern und Tankstellen aktualisiert; manche sind Tage alt, in Frankreich sogar Jahre: Preise über dem gewählten Alter werden ignoriert.
Es ist eine Cloud-Integration: Sie kontaktiert carbu.com mit Ihrer Postleitzahl und den Codes der verfolgten Kraftstoffe. Sonst verlässt nichts Ihr Netzwerk.
Voraussetzungen
- Gladys Assistant 5.1.1 oder neuer.
- Internetzugang. Kein Konto, kein Schlüssel.
Konfiguration
| Feld | Beschreibung |
|---|---|
| Land | Belgien, Frankreich oder Luxemburg. |
| Postleitzahl | Die Mitte des Gebiets: Entfernungen werden ab der Mitte dieses Orts gemessen. |
| Ort (optional) | Wenn die Postleitzahl mehrere Orte umfasst (4000: Liège, Glain, Rocourt). Leer: der Hauptort. |
| Kraftstoffe | Höchstens vier. Hinter dem Namen stehen die Länder, in denen Carbu.com ihn führt (E85: Frankreich). |
| Umkreis | 2 bis 30 km, standardmäßig 10 km. |
| Preise ignorieren, die älter sind als | 1 bis 30 Tage, standardmäßig 7 Tage. |
| In der Erkennung angebotene Tankstellen | Die günstigsten je Kraftstoff, standardmäßig 5; „Keine“, um nur das Gebiet anzubieten. |
| Leseintervall | 30 Minuten, 1 Stunde (Standard), 2 oder 4 Stunden. |
| Sprache der Gerätenamen | Automatisch: die Sprache des Dashboards, Französisch, bis ein Widget angezeigt wird. |
Die Schaltfläche Verbindung testen zeigt den gewählten Ort und die anderen Orte derselben Postleitzahl, dann je Kraftstoff die Anzahl der behaltenen Tankstellen, den niedrigsten Preis und die Zahl der ignorierten veralteten Preise. Die Schaltfläche Diagnose schreibt den vollständigen Zustand der Integration in den Tab Protokolle.
Verwendung
Geräte
Im Tab Erkennung der Integration:
- Carbu.com <Ort> (<Postleitzahl>): je verfolgtem Kraftstoff der niedrigste Preis, der Durchschnittspreis (in €/L, mit Verlauf) und die günstigste Tankstelle („Shell Express Liège · 2,274 € · 1,3 km“).
- Die Tankstellen, die günstigsten je Kraftstoff: Fügen Sie die gewünschten hinzu; sie behalten dann den Preis jedes verfolgten Kraftstoffs, den sie verkaufen, auch wenn sie nicht mehr zu den günstigsten gehören.
- Carbu.com belgische Höchstpreise (Belgien): je verfolgtem Kraftstoff der heutige Höchstpreis, der nächste (von der Regierung angekündigt, sonst von Carbu.com erwartet) und die Aussicht in Worten („Senkung ab 22/04 angekündigt: 2,061 €“).
- Carbu.com luxemburgische Amtspreise (Luxemburg): der heutige amtliche Preis jedes verfolgten Kraftstoffs.
Dashboard-Widgets
- Günstigster Kraftstoff: niedrigster und durchschnittlicher Preis, dann die günstigsten Tankstellen (grün: die zum niedrigsten Preis), ihre Entfernung und das Datum alter Preise. Ein Tippen öffnet die Tankstelle auf Carbu.com oder auf der Karte. Einstellungen: Kraftstoff (auch ein nicht verfolgter), Anzahl der Tankstellen.
- Kraftstoffpreis-Verlauf: die Kurven des niedrigsten und des durchschnittlichen Preises eines Kraftstoffs über eine Woche bis ein Jahr, von Gladys aus dem Gebiets-Gerät gezeichnet (zuerst hinzufügen).
- Amtliche Kraftstoffpreise: die heutigen belgischen Höchstpreise und was folgt (grün eine Senkung, rot eine Erhöhung, „~“ eine Prognose von Carbu.com) oder die amtlichen Preise Luxemburgs.
Szenen
Auslöser (einmal pro Änderung; die erste Lesung ist die Referenz):
| Auslöser | Wann | Filter |
|---|---|---|
| Neue günstigste Tankstelle | Eine andere Tankstelle wird im Gebiet die günstigste für einen Kraftstoff | Kraftstoff |
| Preisänderung an einer Tankstelle | Der Preis eines Kraftstoffs ändert sich an einer hinzugefügten Tankstelle | Tankstelle, Kraftstoff, Richtung |
| Amtlicher Preis geändert | Der heutige amtliche Preis weicht von gestern ab (Belgien, Luxemburg) | Kraftstoff, Richtung |
| Höchstpreis angekündigt | Die belgische Regierung kündigt einen neuen Höchstpreis für den nächsten Tag an | Kraftstoff, Richtung |
| Höchstpreisänderung erwartet | Carbu.com erwartet eine Erhöhung oder Senkung vor der amtlichen Ankündigung | Kraftstoff, Richtung |
Aktionen: Günstigste Tankstelle (Kraftstoff, maximale Entfernung; liefert Name, Marke, Adresse, Preis, Entfernung, Datum des Preises, Durchschnittspreis, Anzahl der Tankstellen, Kartenlink) und Amtliche Preise (Kraftstoff; liefert den heutigen Preis, den nächsten, sein Datum, die Tendenz und ob er angekündigt ist).
Beispiele:
- Wenn eine Erhöhung des Diesel-Höchstpreises angekündigt wird → mir „Heute tanken, morgen {{triggerEvent.data.new_price}} €“ senden.
- Wenn die günstigste Super-E10-Tankstelle wechselt →
{{triggerEvent.data.station_name}}zu{{triggerEvent.data.price}}€ melden. - Jeden Freitag um 17 Uhr → Günstigste Tankstelle im Umkreis von 5 km, dann über den Lautsprecher ansagen.
Transport
Cloud-Abzeichen im Katalog: Carbu.com wird über das Internet kontaktiert. Es gibt keinen lokalen Weg und keine Schaltfläche „Lokale Verbindung bevorzugen“.
Fehlerbehebung
- „Carbu.com kennt keinen Ort mit der Postleitzahl …“: Land und Postleitzahl prüfen (in Luxemburg ohne „L-“; Carbu.com kennt nicht immer jede Postleitzahl einer Stadt: die Hauptpostleitzahl versuchen). „Verbindung testen“ listet die gefundenen Orte.
- „Kein aktueller Preis im Umkreis von … km“: Umkreis oder zulässiges Alter der Preise vergrößern oder prüfen, ob der Kraftstoff in Ihrer Nähe verkauft wird (Erdgas und Diesel XTL sind selten).
- Ein Kraftstoff wird in Ihrem Land nicht geführt: Der Status der Integration meldet es; eine Entsprechung wählen (Belgien: Super E10; Frankreich und Luxemburg: Super E5).
- „Carbu.com hat die Anfrage abgelehnt“: Die Website begrenzt zu häufige Lesungen; alle 2 oder 4 Stunden lesen.
- „Die Seite von Carbu.com konnte nicht gelesen werden“: Die Website hat wohl ihr Layout geändert; mit der Schaltfläche Diagnose auf GitHub melden.
- Die Preise weichen leicht von der Zapfsäule ab: Es sind die auf Carbu.com eingetragenen Preise, mit dem im Widget angezeigten Datum.
- Für eine Fehlermeldung: Versionen von Gladys und der Integration, Land, Postleitzahl, Kraftstoffe und die Zeilen „Carbu.com diagnostic“ aus dem Tab Protokolle (im Entwicklermodus fügt
DEBUG=gladys-integration-sdkdie SDK-Protokolle hinzu).
Konfigurationseinstellungen
Diese Einstellungen fragt Carbu.com in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Carbu.com | section | Nein | Die Preise stammen von Carbu.com, dem Kraftstoffpreisvergleich für Belgien, Frankreich und Luxemburg, den Autofahrer und Tankstellen aktualisieren. Kein Konto nötig: Die Integration liest die öffentlichen Seiten von Carbu.com für Ihre Postleitzahl, standardmäßig einmal pro Stunde. Nur Ihre Postleitzahl verlässt Ihr Netzwerk. |
| Land | select | Ja | |
| Postleitzahl | string | Ja | Die Mitte des Gebiets: Entfernungen werden ab der Mitte dieses Orts gemessen. |
| Ort (optional) | string | Nein | Wenn die Postleitzahl mehrere Orte umfasst (4000: Liège, Glain, Rocourt). Leer: der Hauptort. „Verbindung testen“ listet sie auf. |
| Kraftstoffe | multi_select | Ja | Bis zu vier Kraftstoffe. Hinter dem Namen stehen die Länder, in denen Carbu.com ihn führt. |
| Berücksichtigte Tankstellen | section | Nein | Carbu.com listet bis zu 100 Tankstellen um den Ort, manche Preise sind Monate alt. Diese Einstellungen behalten die relevanten. |
| Umkreis | select | Nein | |
| Preise ignorieren, die älter sind als | select | Nein | |
| In der Erkennung angebotene Tankstellen | select | Nein | Die günstigsten Tankstellen je Kraftstoff, als Geräte hinzuzufügen, um ihre Preise zu verfolgen. |
| Leseintervall | select | Nein | |
| Sprache der Gerätenamen | select | Nein | Automatisch: die Sprache des Dashboards, Französisch, bis ein Widget angezeigt wird. |
So installierst du Carbu.com in Gladys
- Öffne in Gladys Integrationen: Carbu.com erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-carbu-com:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-carbu-com.
Carbu.com benötigt Gladys >=5.1.1. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Carbu.com ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation