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

Ö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.

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
- Integrationen → Open Charge Map → Konfiguration.
- 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.
| Feld | Beschreibung |
|---|---|
| API-Schlüssel | Ihr Open-Charge-Map-Schlüssel. Nur an Open Charge Map gesendet. |
| Haus | Ein 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. |
| Umkreis | 1, 2, 5 (Standard), 10, 20 oder 50 km um jeden Ort. |
| Mindestleistung | Beliebig (Standard), 7, 11, 22, 50 oder 150 kW, für mindestens einen Stecker. |
| Stecker | Typ 2, CCS, CHAdeMO, Typ 1, Tesla / NACS, Haushaltssteckdose. Keiner ausgewählt: alle Stecker. |
| Nur öffentliche Ladestationen | Standardmäßig an: lässt private und Kunden vorbehaltene Stationen weg. |
| Angebotene Ladestationen | Die 5, 10 (Standard), 20 oder 50 nächsten jedes Ortes, im Tab Entdecken. |
| Open Charge Map gelesen alle | 1, 3, 6 (Standard), 12 oder 24 Stunden. Eine Anfrage pro Ort, eine weitere für die verfolgten Stationen. |
| Sprache der Texte | Gerä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ät | Funktion | Gladys-Typ |
|---|---|---|
| Ort | Ladestationen in Betrieb | Zähler: Stationen in Betrieb im Umkreis, die zur Suche passen |
| Schnellladestationen | Zähler: davon die mit einem Stecker ab 50 kW | |
| Nächste Ladestation | Entfernung (km) | |
| Zusammenfassung | Text: „12 Ladestationen in Betrieb im Umkreis von 5 km, davon 3 schnell (50 kW+). Nächste: Lidl, 0,8 km.“ | |
| Ladestation | Status | Ladestation, Anschlussstatus: Verfügbar (in Betrieb), Belegt, Nicht verfügbar, Fehler |
| Ladepunkte | Zähler | |
| Details | Text: Status, maximale Leistung, Stecker, Zugang und Preis | |
| Letzter Besuch | Text: „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-sdkhinzu 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.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Open Charge Map | section | Nein | Open 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üssel | secret | Ja | Nur an Open Charge Map gesendet, im Header X-API-Key. |
| Orte | section | Nein | Wä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… |
| Haus | select | Nein | Ihre Position in Gladys ist der Mittelpunkt der Suche. |
| Oder eine Position | string | Nein | Breite, Länge, wie eine Karten-App sie kopiert. Hat Vorrang vor dem Haus. |
| Ort 2 | section | Nein | |
| Haus | select | Nein | Ihre Position in Gladys ist der Mittelpunkt der Suche. |
| Oder eine Position | string | Nein | Breite, Länge, wie eine Karten-App sie kopiert. Hat Vorrang vor dem Haus. |
| Ort 3 | section | Nein | |
| Haus | select | Nein | Ihre Position in Gladys ist der Mittelpunkt der Suche. |
| Oder eine Position | string | Nein | Breite, Länge, wie eine Karten-App sie kopiert. Hat Vorrang vor dem Haus. |
| Suche | section | Nein | Gleich für alle Orte. Die Widgets können sie weiter eingrenzen. |
| Umkreis | select | Nein | |
| Mindestleistung | select | Nein | Mindestens eines Steckers. |
| Stecker | multi_select | Nein | Keiner ausgewählt: alle Stecker. |
| Nur öffentliche Ladestationen | boolean | Nein | Lässt private und Kunden vorbehaltene Stationen weg. |
| Angebotene Ladestationen | select | Nein | Die nächsten jedes Ortes, im Tab Entdecken: Fügen Sie die hinzu, die Sie nutzen. |
| Optionen | section | Nein | |
| Open Charge Map gelesen alle | select | Nein | Eine 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 Texte | select | Nein | Gerätenamen und Szenen-Zusammenfassungen. Automatisch folgt der Sprache des Dashboards. |
So installierst du Open Charge Map in Gladys
- Öffne in Gladys Integrationen: Open Charge Map 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-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). - Ö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-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.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation