Zum Hauptinhalt springen

Open Charge Map Smart-Home-Integration, kostenlos und Open Source

Open Charge Map-Integration für Gladys Assistant

Öffentliche Ladestationen in Ihrer Nähe: Status, Besuche, Szenen.

Überblick​

Diese Integration bringt die auf Open Charge Map verzeichneten öffentlichen Ladestationen für Elektroautos in Gladys, rund um bis zu drei Orte: ein Haus von Gladys oder eine eingegebene Position.

  • ein Gerät pro Ort: die Ladestationen in Betrieb in der Umgebung, wie viele davon schnell sind (50 kW und mehr) und wie weit die nächste entfernt ist;
  • ein Gerät pro verfolgter Ladestation: Status, Ladepunkte, Leistung, Stecker, Zugang und Preis sowie der letzte Besuch eines Fahrers;
  • Szenen-Auslöser (neue Ladestation in der Nähe, Status einer Ladestation geändert, neuer Besuch) und eine Szenen-Aktion (nächste Ladestation für einen Stecker und eine Leistung finden);
  • zwei Dashboard-Widgets: die nächsten Ladestationen und eine einzelne Ladestation.

Open Charge Map ist das offene, weltweite Verzeichnis der Ladestationen, gepflegt von seiner Community und von nationalen Registern. Die Integration liest die offizielle API mit Ihrem kostenlosen persönlichen Schlüssel (Cloud-Transport). Die Live-Belegung einer Station ist nur bekannt, wenn ihr Betreiber sie teilt: Die meisten Stationen zeigen „in Betrieb“, nicht „frei“. Community-Integration, nicht mit Open Charge Map verbunden.

Widgets Laden in der Nähe und Ladestation, rund um Luxemburg-Stadt (generierte Illustration, kein Screenshot)

Voraussetzungen​

  • Gladys Assistant 5.3.0 oder neuer.
  • Ein kostenloser Open-Charge-Map-API-Schlüssel: Melden Sie sich auf openchargemap.org an, öffnen Sie My profile → My apps, dann Register an application; der Schlüssel wird bei der Anwendung angezeigt.
  • Ein auf der Karte verortetes Haus von Gladys (Einstellungen → Häuser) oder eine Position (Breite, Länge).

Konfiguration​

  1. Integrationen → Open Charge Map → Konfiguration.
  2. Fügen Sie den API-Schlüssel ein, wählen Sie für jeden Ort ein Haus oder geben Sie eine Position ein, stellen Sie die Suche ein und speichern Sie.
FeldBeschreibung
API-SchlüsselIhr Open-Charge-Map-Schlüssel. Nur an Open Charge Map gesendet.
HausEin Haus von Gladys: Seine Position ist der Mittelpunkt der Suche.
Oder eine Position„46.3069, 4.8325“, wie eine Karten-App sie kopiert. Hat Vorrang vor dem Haus.
Umkreis1, 2, 5 (Standard), 10, 20 oder 50 km um jeden Ort.
MindestleistungBeliebig (Standard), 7, 11, 22, 50 oder 150 kW, für mindestens einen Stecker.
SteckerTyp 2, CCS, CHAdeMO, Typ 1, Tesla / NACS, Haushaltssteckdose. Keiner ausgewählt: alle Stecker.
Nur öffentliche LadestationenStandardmäßig an: lässt private und Kunden vorbehaltene Stationen weg.
Angebotene LadestationenDie 5, 10 (Standard), 20 oder 50 nächsten jedes Ortes, im Tab Entdecken.
Open Charge Map gelesen alle1, 3, 6 (Standard), 12 oder 24 Stunden. Eine Anfrage pro Ort, eine weitere für die verfolgten Stationen.
Sprache der TexteGerätenamen, Zusammenfassungen und Szenentexte. Automatisch: die Sprache Ihres Dashboards.

Schlüssel und Orte testen liest Open Charge Map sofort und zeigt für jeden Ort seine Position und die gefundenen Ladestationen.

Verwendung​

Geräte​

Geräte → Open Charge Map → Entdecken, dann Ihren Ort („Ladestationen · Zuhause“) und die Ladestationen hinzufügen, die Sie nutzen.

GerätFunktionGladys-Typ
OrtLadestationen in BetriebZähler: Stationen in Betrieb im Umkreis, die zur Suche passen
SchnellladestationenZähler: davon die mit einem Stecker ab 50 kW
Nächste LadestationEntfernung (km)
ZusammenfassungText: „12 Ladestationen in Betrieb im Umkreis von 5 km, davon 3 schnell (50 kW+). Nächste: Lidl, 0,8 km.“
LadestationStatusLadestation, Anschlussstatus: Verfügbar (in Betrieb), Belegt, Nicht verfügbar, Fehler
LadepunkteZähler
DetailsText: Status, maximale Leistung, Stecker, Zugang und Preis
Letzter BesuchText: „Erfolgreich geladen, 15.11.2026 (Lena)“ und der Kommentar des Fahrers

„Verfügbar“ zeigt Gladys für eine Station in Betrieb: Open Charge Map weiß, ob eine Station funktioniert, selten, ob sie gerade frei ist. Die Besuche einer Station werden gelesen, sobald Sie ihr Gerät hinzufügen.

Szenen​

Auslöser:

  • Open Charge Map: neue Ladestation in der Nähe: Eine kürzlich auf Open Charge Map gelistete Station erscheint im Umkreis eines Ortes. Filter: der Ort, schnell (50 kW+) oder nicht.
  • Open Charge Map: Status einer Ladestation geändert: Eine hinzugefügte Station fällt aus, ist wieder in Betrieb oder ändert ihren Status. Filter: die Station, die Änderung.
  • Open Charge Map: neuer Besuch: Ein Fahrer meldet einen Ladevorgang, ein Problem oder einen Kommentar zu einer hinzugefügten Station. Filter: die Station, das Ergebnis (Erfolg, Problem, Sonstiges).

Aktion:

  • Open Charge Map: Ladestation finden: die nächste Ladestation eines Ortes für einen Stecker und eine Mindestleistung, aus der letzten Abfrage: Name, Adresse, Entfernung, Leistung, Stecker, Betreiber, Status, Position, Open-Charge-Map-Seite und ein fertiger Satz.

Beispiele:

  • Wenn die Schnellladestation, die ich nutze, ausfällt → eine Nachricht mit {{triggerEvent.data.summary}} senden.
  • Wenn ein Fahrer ein Problem an meiner üblichen Station meldet → mich vor der Abfahrt benachrichtigen.
  • Wenn eine neue Schnellladestation in der Nähe von Zuhause gelistet wird → ihren Namen und ihre Entfernung senden.
  • Wenn die Autobatterie schwach ist (mit der Integration Ihres Autos) → die nächste CCS-Station mit 50 kW finden und ihre Zusammenfassung in einer Nachricht senden.

Widgets​

Dashboard → Bearbeiten → Laden in der Nähe hinzufügen: Ort, Stecker, Mindestleistung und Anzahl der angezeigten Stationen wählen. Jede Karte zeigt Entfernung, Betreiber, Leistung und Status; sie öffnet die Stecker, die Adresse, Zugang und Preis, den letzten Besuch, die Datenquelle sowie Links zu Open Charge Map und zur Route.

Ladestation für eine verfolgte Station hinzufügen: maximale Leistung, Ladepunkte und Entfernung, die letzten Besuche von Fahrern, Status, Stecker, Zugang und Preis, Datum der letzten Prüfung und Datenquelle.

Jedes Widget zeigt den Datenlieferanten der Stationen und seine Lizenz (Open Charge Map Contributors, CC BY 4.0, oder das nationale Register, aus dem die Daten stammen), wie es die Bedingungen von Open Charge Map verlangen.

Fehlerbehebung​

  • „Open Charge Map lehnt den API-Schlüssel ab“: Kopieren Sie den Schlüssel erneut aus My profile → My apps; ein Schlüssel gehört zu Ihrem Konto.
  • „Ist keine Position“: Geben Sie die Breite, ein Komma und dann die Länge ein, mit Punkt für die Dezimalstellen: 46.3069, 4.8325.
  • „Das Haus hat keine Position“: Verorten Sie das Haus auf der Karte unter Einstellungen → Häuser.
  • Keine oder zu wenige Ladestationen: Erweitern Sie den Umkreis, wählen Sie Stecker ab oder senken Sie die Mindestleistung; prüfen Sie die Gegend auf der Open-Charge-Map-Karte.
  • „Open Charge Map bittet um weniger Anfragen“: Seltener abfragen; die Fair-Use-Regel von Open Charge Map bittet, Anfragen nicht zu wiederholen.
  • Eine Station ist falsch oder fehlt: Open Charge Map wird von seinen Nutzern gepflegt: Korrigieren Sie sie oder melden Sie einen Besuch auf ihrer Seite (Link im Widget).
  • Logs: Fügen Sie die Umgebungsvariable DEBUG=gladys-integration-sdk hinzu und eröffnen Sie ein Issue auf GitHub mit den Versionen von Gladys und der Integration und den Logs (niemals Ihren API-Schlüssel).

Konfigurationseinstellungen​

Diese Einstellungen fragt Open Charge Map in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Open Charge MapsectionNeinOpen Charge Map ist das offene Verzeichnis öffentlicher Ladestationen, gepflegt von seiner Community und nationalen Registern. Die API ist mit einem persönlichen Schlüssel kostenlos: Melden Sie sich auf openchargemap.org an, öffnen Sie My profile > My apps, dann Register an application, und fügen Sie den Schlüssel unten ein. Die Live-Belegung ist nur bekannt, wenn der Betreiber sie teilt: Die meisten Stationen zeigen „in Betrieb“, nicht „frei“. Community-Integration, nicht mit Open Charge Map verbunden.
API-SchlüsselsecretJaNur an Open Charge Map gesendet, im Header X-API-Key.
OrtesectionNeinWählen Sie ein Haus von Gladys (verortet unter Einstellungen > Häuser) oder geben Sie eine Position ein. Jeder Ort wird zu einem Gerät im Tab Entdecken, mit seinen nächsten Ladestationen. Bis zu drei Orte: Zuhause, Arbeit…
HausselectNeinIhre Position in Gladys ist der Mittelpunkt der Suche.
Oder eine PositionstringNeinBreite, Länge, wie eine Karten-App sie kopiert. Hat Vorrang vor dem Haus.
Ort 2sectionNein
HausselectNeinIhre Position in Gladys ist der Mittelpunkt der Suche.
Oder eine PositionstringNeinBreite, Länge, wie eine Karten-App sie kopiert. Hat Vorrang vor dem Haus.
Ort 3sectionNein
HausselectNeinIhre Position in Gladys ist der Mittelpunkt der Suche.
Oder eine PositionstringNeinBreite, Länge, wie eine Karten-App sie kopiert. Hat Vorrang vor dem Haus.
SuchesectionNeinGleich für alle Orte. Die Widgets können sie weiter eingrenzen.
UmkreisselectNein
MindestleistungselectNeinMindestens eines Steckers.
Steckermulti_selectNeinKeiner ausgewählt: alle Stecker.
Nur öffentliche LadestationenbooleanNeinLässt private und Kunden vorbehaltene Stationen weg.
Angebotene LadestationenselectNeinDie nächsten jedes Ortes, im Tab Entdecken: Fügen Sie die hinzu, die Sie nutzen.
OptionensectionNein
Open Charge Map gelesen alleselectNeinEine Anfrage pro Ort, eine weitere für die verfolgten Stationen. Stationen ändern sich selten: Die Fair-Use-Regel bittet, Anfragen nicht zu wiederholen.
Sprache der TexteselectNeinGerätenamen und Szenen-Zusammenfassungen. Automatisch folgt der Sprache des Dashboards.

So installierst du Open Charge Map in Gladys​

  1. Öffne in Gladys Integrationen: Open Charge Map erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/william-de71/gladys-open-charge-map:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-open-charge-map.

Open Charge Map benötigt Gladys >=5.3.0. 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​

Open Charge Map 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂