lsl – Ladesäulenregister Loader & Converter

Lädt und konvertiert das offizielle Ladesäulenregister der Bundesnetzagentur in ein besser brauchbares JSON-Format.

Attribut-Werte orientieren sich, wo möglich, am OpenStreetMap-Standard für Ladestationen – insbesondere bei Status, Zahlungsmitteln, Zugangsbeschränkungen und Öffnungszeiten.

Online-Zugriff auf die JSON-Datei

Die aktuelle ladesaeulen.json.gz wird wöchentlich per GitHub Action aktualisiert und ist über GitHub Pages abrufbar:

https://ratopi.github.io/ladesaeule/ladesaeulen.json.gz

Hinweis: Die Datei ist gzip-komprimiert (ca. 8 MB statt ca. 67 MB unkomprimiert). Die meisten HTTP-Clients und Programmiersprachen können gzip transparent dekomprimieren.

Die Struktur der JSON-Datei ist in der openapi.yaml formal beschrieben.

Bauen

Voraussetzung: Erlang/OTP und rebar3 müssen installiert sein.

rebar3 as prod escriptize

Erzeugt das ausführbare Escript unter _build/prod/bin/lsl.

Ausführen

_build/prod/bin/lsl

Das Tool ermittelt die aktuelle CSV-URL automatisch von der E-Mobilitäts-Seite der Bundesnetzagentur, lädt die CSV-Datei herunter und schreibt das Ergebnis nach public/ladesaeulen.json.

Testen

rebar3 eunit

Die Tests umfassen:

lsl_converter_tests – Konvertierungs-Tests mit gekürzten CSV-Dateien unter test/data/ (UTF-8 und ISO-8859-1), ohne HTTP-Zugriff.
cell_parser_tests – Unit-Tests für den CSV-Parser, u.a. für maskierte Zellen, Anführungszeichen in nicht-quotierten Zellen und Chunked Input.
lsl_opening_hours_tests – Tests für die Konvertierung der BNetzA-Öffnungszeiten in das OpenStreetMap opening_hours-Format.

Wie die Konvertierung abläuft

1. URL ermitteln

lsl_loader lädt die E-Mobilitäts-Startseite der Bundesnetzagentur und extrahiert per Regex den Link zur aktuellen CSV-Datei (der Dateiname enthält ein Datum, das sich bei jeder Aktualisierung ändert).

2. Prüfen ob ein Update nötig ist

lsl_loader liest über lsl_output das meta-Objekt aus der bestehenden public/ladesaeulen.json (falls vorhanden) und vergleicht:

URL – hat sich der Dateiname/Link geändert?
Last-Modified – wird per HTTP HEAD-Request geholt und mit dem gespeicherten Wert verglichen.

Nur wenn sich etwas geändert hat (oder noch keine Ausgabe existiert), wird die CSV heruntergeladen und konvertiert.

3. CSV streamen & parsen

Die CSV wird per HTTP-Streaming (httpc, async) heruntergeladen. Die empfangenen Chunks werden direkt dem lsl_cell_parser übergeben – einem Continuation-basierten CSV-Parser, der Semikolon-getrennte, optional in Anführungszeichen maskierte Zellen verarbeitet. Die Encoding-Erkennung geschieht automatisch: ein UTF-8 BOM wird erkannt und entfernt, ansonsten wird heuristisch zwischen UTF-8 und ISO-8859-1 unterschieden (ISO-8859-1 wird on-the-fly in UTF-8 konvertiert). Anführungszeichen innerhalb nicht-quotierter Zellen werden tolerant als normales Zeichen behandelt.

4. Header und Info-Zeilen verarbeiten

Die CSV beginnt mit mehreren Info-Zeilen (Titel, Hinweise, Aktualisierungsdatum). Diese werden von lsl_converter in das infos-Array der JSON-Ausgabe übernommen.

Dann folgen zwei Header-Zeilen:

Zeile 1 – Gruppierung: „Allgemeine Informationen", „1. Ladepunkt" bis „6. Ladepunkt". Diese Zeile dient als Trigger für den Übergang vom Info-Bereich zum Datenbereich.
Zeile 2 – Die eigentlichen Spaltennamen (z.B. Betreiber, Steckertypen1, P2 [kW]). Die Zuordnung zu den Ladepunkten 1–6 erfolgt über das Suffix im Spaltennamen.

5. Datenzeilen in JSON konvertieren

Jede Datenzeile wird von lsl_row anhand der deklarativen Mapping-Definition in lsl_mapping in eine verschachtelte Map überführt. Das Mapping beschreibt die gewünschte JSON-Zielstruktur – inklusive Verschachtelungen, Typ-Konvertierungen, Übersetzungstabellen und der Zusammenführung mehrerer Quellspalten. Alle JSON-Keys sind englisch.

CSV-Spalte(n)	JSON-Ziel	Typ / Konvertierung
Ladeeinrichtungs-ID	`id`	string
Betreiber	`operator`	string
Anzeigename (Karte)	`display_name`	string
Status	`status`	→ OSM: `operational`, `planned`, `broken`, `disused`, `construction`
Art der Ladeeinrichtung	`device_type`	→ `normal` / `rapid`
Nennleistung [kW]	`charging.rated_power_kw`	Zahl (float)
Inbetriebnahmedatum	`charging.commissioning_date`	ISO 8601 (`YYYY-MM-DD`)
Straße, Hausnummer, …	`addr { street, house_number, postcode, city, state, district, address_extra }`	string
Breitengrad, Längengrad	`geo { lat, lon }`	float
Standortbezeichnung	`location_name`	string
Informationen zum Parkraum	`access.parking`	→ OSM `access`: `yes`, `customers`
Bezahlsysteme	`access.payment`	→ Array von OSM `payment:*`-Tags (s.u.)
Öffnungszeiten + Wochentage + Tageszeiten	`access.opening_hours`	→ OSM `opening_hours` (z.B. `24/7`)
Steckertypen1–6, …	`charging.points[]`	Array mit `plugs`, `power`, `kW`, `evse_id`, `pkey`

Payment-Mapping (BNetzA → OSM):

BNetzA-Wert	OSM-Tag
Onlinezahlungsverfahren	`app`
RFID-Karte	`rfid`
Kreditkarte (NFC)	`contactless:credit_cards`
Kreditkarte (Lesegerät)	`credit_cards`
Debitkarte (NFC)	`contactless:debit_cards`
Debitkarte (Lesegerät)	`debit_cards`
Plug & Charge	`plug_and_charge`
Bargeld	`cash`
Kostenlos	`free`
Sonstige	`other`

Leere Zellen werden übersprungen. Ladepunkte ohne Daten tauchen nicht im Array auf.

6. Meta-Informationen anhängen

Am Ende der JSON-Datei wird über lsl_output ein meta-Objekt geschrieben mit:

source – die URL der CSV-Datei
download_time – Zeitstempel des Downloads
source_last_modified – der Last-Modified-Header des HTTP-Response (Zeitstempel der Datei auf dem Server)

7. Gzip-Komprimierung

Nach dem Schreiben wird die JSON-Datei mit zlib:gzip/1 komprimiert und als ladesaeulen.json.gz gespeichert. Die unkomprimierte Datei wird anschließend gelöscht – nur die .gz-Version wird veröffentlicht, um die gh-pages-Historie klein zu halten.

Struktur der Ausgabe

{
  "infos": [
    "Ladesäulenregister Bundesnetzagentur",
    "Hinweis: ",
    "..."
  ],
  "data": [
    {
      "id": "1010338",
      "operator": "Albwerk Elektro- und Kommunikationstechnik GmbH",
      "display_name": "Albwerk Elektro- und Kommunikationstechnik GmbH",
      "status": "operational",
      "device_type": "normal",
      "addr": {
        "street": "Am Berg",
        "house_number": "1",
        "postcode": "72535",
        "city": "Heroldstatt",
        "state": "Baden-Württemberg",
        "district": "Landkreis Alb-Donau-Kreis"
      },
      "geo": { "lat": 48.442398, "lon": 9.659075 },
      "charging": {
        "commissioning_date": "2020-01-11",
        "rated_power_kw": 22,
        "points": [
          {
            "plugs": ["AC Typ 2 Steckdose"],
            "power": ["22"],
            "evse_id": ["DEAEWE002501"],
            "pkey": "CA49E2E0..."
          }
        ]
      },
      "access": {
        "payment": ["rfid", "app"],
        "parking": "yes",
        "opening_hours": "24/7"
      }
    }
  ],
  "meta": {
    "source": "https://data.bundesnetzagentur.de/.../Ladesaeulenregister_BNetzA_2026-03-25.csv",
    "download_time": "2026-04-01T14:59:36",
    "source_last_modified": "Wed, 26 Mar 2026 14:36:31 GMT"
  }
}

Modulstruktur

Modul	Aufgabe
`lsl`	Escript-Einstiegspunkt – startet die Anwendungen und orchestriert den Ablauf
`lsl_loader`	HTTP-Kommunikation – CSV-URL von der BNetzA-Seite scrapen, Update-Check per HEAD-Request, CSV-Download via Streaming
`lsl_converter`	CSV→JSON-Orchestrierung – parst den CSV-Stream, trennt Info-/Header-/Datenzeilen und schreibt JSON über `lsl_output`
`lsl_mapping`	Deklarative Zielstruktur-Definition – beschreibt die gewünschte JSON-Hierarchie, Typ-Konverter und OSM-Übersetzungstabellen
`lsl_row`	Zeilenweise Konvertierung – wandert den Mapping-Baum und baut aus einer CSV-Zeile die JSON-Map
`lsl_opening_hours`	Konvertierung der BNetzA-Öffnungszeiten in das OSM `opening_hours`-Format
`lsl_output`	Datei-I/O – Ausgabedatei öffnen/schließen, JSON schreiben, Meta-Daten lesen, gzip-Komprimierung. Kapselt den Datei-Handle in einem opaken Record
`lsl_json`	Dünner Wrapper um `jsx` – JSON-Encoding/-Decoding und Aufbau des Meta-Objekts
`lsl_cell_parser`	Continuation-basierter CSV-Parser – Semikolon-getrennt, maskierte Zellen, automatische Encoding-Erkennung (UTF-8/ISO-8859-1), tolerante Behandlung von Anführungszeichen in nicht-quotierten Zellen

Konfiguration

Alle konfigurierbaren Parameter sind zentral in src/lsl.app.src unter {env, [...]} definiert:

Parameter	Default	Beschreibung
`source_page_url`	`https://www.bundesnetzagentur.de/…/start.html`	URL der BNetzA-Seite, von der die CSV-URL extrahiert wird
`output_dir`	`./public`	Ausgabeverzeichnis
`output_file`	`./public/ladesaeulen.json`	Pfad der JSON-Ausgabedatei
`output_file_gz`	`./public/ladesaeulen.json.gz`	Pfad der gzip-komprimierten Ausgabedatei
`stream_timeout`	`10000`	Timeout in ms für HTTP-Stream-Chunks

GitHub Action

Die Workflow-Datei .github/workflows/update.yml automatisiert die Aktualisierung.

Zeitplan: Jeden Montag um 6:00 UTC (per Cron) sowie bei jedem Push auf master.

Manuell auslösen: Der Workflow kann jederzeit manuell gestartet werden:

Über die GitHub-Weboberfläche: Im Repository unter Actions → Update Ladesäulenregister → Run workflow klicken.

Per GitHub API:

curl -X POST \
  -H "Authorization: token DEIN_GITHUB_TOKEN" \
  -H "Accept: application/vnd.github.v3+json" \
  https://api.github.com/repos/ratopi/ladesaeule/actions/workflows/update.yml/dispatches \
  -d '{"ref":"master"}'

Ablauf:

Checkout – Repository auschecken
Setup – Erlang/OTP 27 und rebar3 installieren (erlef/setup-beam)
Build – Escript bauen (rebar3 as prod escriptize)
Test – EUnit-Tests ausführen (rebar3 eunit)
Restore – Die bestehende ladesaeulen.json.gz vom gh-pages-Branch holen (falls vorhanden), damit der Update-Check vergleichen kann
Konvertierung – lsl ausführen; prüft per HEAD-Request ob sich die CSV geändert hat und lädt nur bei Bedarf herunter
Deploy – public/-Verzeichnis in den gh-pages-Branch pushen (peaceiris/actions-gh-pages); nur wenn sich tatsächlich etwas geändert hat

Hinweis: GitHub deaktiviert Scheduled Workflows automatisch, wenn ein Repository 60 Tage lang keine Aktivität hat (kein Push, Issue oder PR). In dem Fall muss der Workflow im Actions-Tab manuell wieder aktiviert werden.

Lizenz

Dieses Projekt steht unter der MIT-Lizenz.

Anmerkung

Die Datei wird von der Bundesnetzagentur ganz offensichtlich von Hand mit Excel erzeugt. Daher kann es vorkommen, daß sich das Format der Datei unvermittelt ändert. Falls Du dies bemerkst, freue ich mich über einen Pull-Request oder einen Issue in GitHub: https://github.com/ratopi/ladesaeule/issues

Name		Name	Last commit message	Last commit date
Latest commit History 31 Commits
.github/workflows		.github/workflows
src		src
test		test
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
openapi.yaml		openapi.yaml
rebar.config		rebar.config
rebar.lock		rebar.lock

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

lsl – Ladesäulenregister Loader & Converter

Online-Zugriff auf die JSON-Datei

Bauen

Ausführen

Testen

Wie die Konvertierung abläuft

1. URL ermitteln

2. Prüfen ob ein Update nötig ist

3. CSV streamen & parsen

4. Header und Info-Zeilen verarbeiten

5. Datenzeilen in JSON konvertieren

6. Meta-Informationen anhängen

7. Gzip-Komprimierung

Struktur der Ausgabe

Modulstruktur

Konfiguration

GitHub Action

Lizenz

Anmerkung

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

lsl – Ladesäulenregister Loader & Converter

Online-Zugriff auf die JSON-Datei

Bauen

Ausführen

Testen

Wie die Konvertierung abläuft

1. URL ermitteln

2. Prüfen ob ein Update nötig ist

3. CSV streamen & parsen

4. Header und Info-Zeilen verarbeiten

5. Datenzeilen in JSON konvertieren

6. Meta-Informationen anhängen

7. Gzip-Komprimierung

Struktur der Ausgabe

Modulstruktur

Konfiguration

GitHub Action

Lizenz

Anmerkung

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages