Vom VBB XML Feed (broken-lifts.org) migrieren

Inhaltsverzeichnis

broken-lifts.org ist ein Dienst von Sozialhelden e.V., der Aufzugsstörungen im VBB-Gebiet als XML Feed bereitstellt. Dieser Dienst wird durch accessibility.cloud Transit abgelöst.

Was ist broken-lifts.org?

broken-lifts.org aggregierte bisher Aufzugsdaten verschiedener Betreiber im Berliner Verkehrsverbund und stellte sie als einfachen XML Feed zur Verfügung. Konsumenten waren u.a. Fahrgastinformations-Apps und Auskunftssysteme.

Transit ist der Nachfolger und bietet:

  • Deutlich mehr Datenquellen (DB FASTA, BVG, S-Bahn, NeTEx, GTFS)
  • Strukturiertes Datenmodell statt flachem XML
  • Historische Störungsdaten (Status Spans)
  • DHID-basierte Haltestellenzuordnung
  • Mehrsprachige Beschreibungen mit TTS-Varianten

Gegenüberstellung

broken-lifts.org XML

Transit API

Hinweis

<elevator> Element

GET /api/elevators

Aufzüge als JSON

<station>

GET /api/stop-places

Haltestellen mit DHID

<status> = Defekt

operational_status.operational_status = out_of_service


<status> = In Betrieb

operational_status.operational_status = in_service


<description>

function.short_visual

Bereinigt

<since>

Status Span start_date

ISO-8601

–

Status Span reason_type

Kategorisierter Störungsgrund

–

Status Span is_planned

Geplant vs. ungeplant

–

function.short_tts / function.long_tts

TTS-optimierte Beschreibungen

Beispiel: Alle gestörten Aufzüge im VBB-Gebiet

broken-lifts.org (vorher):

GET https://broken-lifts.org/feed.xml
<!-- Antwort: XML mit allen gestörten Aufzügen -->

Transit API (nachher):

# Alle aktuell gestörten Aufzüge (alle Betreiber)
GET /api/elevators?where[operational_status.operational_status][equals]=out_of_service&depth=2

# Nur Störungen mit Details
GET /api/status-spans?where[operational_status][equals]=out_of_service&sort=-start_date&depth=2

Beispiel: Aufzüge an einer bestimmten Haltestelle

broken-lifts.org (vorher):

<!-- Filtern war im XML Feed begrenzt möglich -->
GET https://broken-lifts.org/feed.xml?station=Alexanderplatz

Transit API (nachher):

GET /api/elevators?where[stop_place_name][contains]=Alexanderplatz&depth=2

Migrationsstrategie

Schritt 1: API-Zugang einrichten

  1. Fordern Sie einen API-Key bei Sozialhelden e.V. an.
  2. Testen Sie den Zugang: curl -H "Authorization: Bearer <KEY>" https://transit.i.wheelmap.tech/api/elevators?limit=1

Schritt 2: Datenformat anpassen

  1. Ersetzen Sie den XML-Parser durch einen JSON-Parser in Ihrem Code.
  2. Passen Sie die Feldnamen an (siehe Gegenüberstellung oben).
  3. Nutzen Sie depth=2, um verknüpfte Daten direkt mitzuladen.

Schritt 3: Erweiterte Features nutzen

  1. Status Spans statt einmaligem Status: Nutzen Sie die Störungshistorie für Auswertungen.
  2. Filter: Nutzen Sie die Payload CMS Query-Syntax für präzise Abfragen.
  3. DHID-Zuordnung: Verwenden Sie DHIDs für eindeutige Haltestellenreferenzen.

Wesentliche Unterschiede

Aspekt

broken-lifts.org

Transit API

Format

XML

JSON (REST)

Aktualisierung

Periodisch (nur gestörte)

Echtzeit (alle Aufzüge)

Scope

VBB-Gebiet

Deutschlandweit erweiterbar

Betreiber

Aggregiert, keine Zuordnung

Pro Betreiber filterbar

Historie

Nicht verfügbar

Vollständige Status-Span-Historie

IDs

Proprietär

DHID-basiert + Inventarnummern

Wegenetz

Nicht vorhanden

GTFS Pathways + NeTEx

Authentifizierung

Öffentlich

Bearer-Token