API – Abfahrtsanzeigen

Dies ist die Dokumentation für Version 2 der API. Dokumentation für die veraltete Version 1.

Informationen zu den nächsten Abfahrten an einer Haltestelle des öffentlichen Nahverkehrs (virtuelles Anzeigedisplay).

  • Endpoint: GET https://www.zditm.szczecin.pl/api/v2/departure-boards/{stopNumber}?limit={limit}&format=json|cbor (den Wert für {stopNumber} erhalten Sie über die Haltestellen-API – Feld number)
  • Der Parameter limit (optional) gibt die Anzahl der zurückgegebenen Fahrten an. Der Standardwert ist 10. Der Wert 0 gibt die Abfahrten für die nächsten 22 Stunden zurück, was zu einer längeren Antwortzeit des Servers führen kann.
  • Datenformat: application/json (Standard) oder application/cbor (wenn format=cbor)
  • Aktualisierungs­frequenz: ca. alle 10 Sekunden

Datenstruktur

{
  "data": {
    "stop": {
      "name": "Brama Portowa",
      "number": "10822"
    },
    "departures": [
      {
        "line": {
          "id": 8,
          "number": "8",
          "type": "DAY",
          "subtype": "NORMAL",
          "vehicle_type": "TRAM",
          "on_demand": false,
          "disruption": false,
          "disruption_url": null
        },
        "trip": {
          "service": "008-02",
          "gtfs_id": "482487_POWS",
          "start_date": "2026-06-23",
          "headsign": {
            "short": "Gumieńce",
            "long": "Gumieńce"
          },
          "direction_id": 1,
          "route_variant_number": 12,
          "accessibility": "LOW_FLOOR",
          "note": null
        },
        "departure_time": {
          "scheduled": "2026-06-23T12:01:00.000000Z",
          "estimated": "2026-06-23T12:00:51.000000Z",
          "departing_now": true,
          "real_time": true,
          "canceled": false
        },
        "request_stop": false,
        "vehicle": {
          "id": 654,
          "number": "822",
          "model": "Pesa Swing 120NaS2",
          "low_floor": true,
          "ticket_machine": {
            "cards": false,
            "coins": true
          },
          "stuck": false
        }
      },

      ...

    ],
    "updated_at": "2026-06-23T12:01:10.657534Z"
  }
}
  • object stop – Objekt mit Informationen zur Haltestelle
    • string name – Name der Haltestelle
    • string number – Haltestellennummer
  • array departures – Liste der nächsten Abfahrten von der Haltestelle
    • object line – Objekt mit Informationen zur Linie
      • int id – eindeutige Kennung der Linie (unveränderlich)
      • string number – Linienbezeichnung (Nummer) (kann sich ändern)
      • string type – Linientyp:
        • DAY – Tageslinie
        • NIGHT – Nachtlinie
      • string subtype – Linien-Untertyp:
        • NORMAL – normale Linie
        • SEMI_FAST – halb-schnelle Linie
        • FAST – Schnelllinie
        • REPLACEMENT – Ersatzlinie
        • ADDITIONAL – Zusatzlinie
        • SPECIAL – Sonderlinie
        • TOURIST – Touristenlinie
      • string vehicle_type – Fahrzeugtyp:
        • SKM – SKM-Zug
        • TRAM – Straßenbahn
        • BUS – Bus
      • bool on_demand – true, wenn die Linie als Rufbussystem betrieben wird
      • bool disruption – true, wenn auf der Linie Störungen auftreten
      • object|null disruption_url – Objekt mit Links zu Störungsbeschreibungen (null, wenn der Wert von disruption false ist)
        • string pl – Link zur detaillierten Störungsbeschreibung auf Polnisch
        • string en – Link zur detaillierten Störungsbeschreibung auf Englisch
        • string de – Link zur detaillierten Störungsbeschreibung auf Deutsch
        • string uk – Link zur detaillierten Störungsbeschreibung auf Ukrainisch
    • object trip – Objekt mit Informationen zur Fahrt
      • string service – Kennzeichnung der Dienstschicht (Schicht)
      • string|null gtfs_id – Kennung der Fahrt im statischen GTFS-Fahrplan (null, wenn keine Zuordnung möglich ist)
      • string start_date – Startdatum als Bezugspunkt für die Fahrt
      • object headsign – Objekt mit der Zielanzeige der Fahrt
        • string short – kurze Zielanzeige (Name der Zielhaltestelle)
        • string long – lange Zielanzeige (zusätzliche Informationen neben dem Namen der Zielhaltestelle möglich)
      • int direction_id – Richtungskennung (0 bezeichnet die Hinfahrtrichtung, 1 die Rückfahrtrichtung)
      • int route_variant_number – Nummer der Linienvariante, auf der die Fahrt durchgeführt wird
      • string accessibility – Information zum geplanten Fahrzeugtyp für die Fahrt:
        • HIGH_FLOOR – geplantes hochfluriges Fahrzeug
        • LOW_FLOOR – geplantes niederfluriges Fahrzeug
        • LOW_FLOOR_POSSIBLE – mögliches niederfluriges Fahrzeug
      • object|null note – Objekt mit einer zusätzlichen Beschreibung der Fahrt (null, wenn keine Beschreibung vorhanden ist)
        • string pl – zusätzliche Beschreibung auf Polnisch
        • string en – zusätzliche Beschreibung auf Englisch
        • string de – zusätzliche Beschreibung auf Deutsch
        • string uk – zusätzliche Beschreibung auf Ukrainisch
    • object departure_time – Objekt mit Informationen zur Abfahrtszeit
      • string scheduled – planmäßige Abfahrtszeit laut Fahrplan
      • string estimated – geschätzte Abfahrtszeit auf Grundlage der Pünktlichkeit des Fahrzeugs; bei Fahrten, für die keine Pünktlichkeitsinformationen verfügbar sind, ist der Wert von estimated gleich dem Wert von scheduled
      • bool departing_now – true, wenn bis zur voraussichtlichen Abfahrtszeit weniger als 30 Sekunden verbleiben oder sich das Fahrzeug derzeit im Haltestellenbereich befindet (auf Haltestellentafeln wird eine solche Fahrt mit dem Symbol >>> gekennzeichnet)
      • bool real_time – true, wenn für die betreffende Fahrt live aktualisierte Informationen verfügbar sind
      • bool canceled – true, wenn die betreffende Fahrt ausfällt
    • bool request_stop – true, wenn es sich bei der Haltestelle für die betreffende Fahrt um eine Haltestelle auf Anforderung handelt
    • object|null vehicle – Objekt mit Informationen zum Fahrzeug (null, wenn für die betreffende Fahrt keine live aktualisierten Informationen verfügbar sind)
      • int id – Fahrzeugkennung
      • string number – Betriebsnummer des Fahrzeugs
      • string|null model – Modellbezeichnung des Fahrzeugs
      • bool|null low_floor – true, wenn das Fahrzeug niederflurig ist
      • object|null ticket_machine – Objekt mit Informationen zum im Fahrzeug installierten Fahrkartenautomaten (null, wenn im Fahrzeug kein Fahrkartenautomat installiert ist)
        • bool cards – Fahrkartenautomat unterstützt Kartenzahlung
        • bool coins – Fahrkartenautomat unterstützt Münzzahlung
      • bool stuck – true, wenn sich das Fahrzeug nicht bewegt (feststeckt); mögliche Gründe sind unter anderem ein Verkehrsstau oder eine Fahrzeugpanne
  • string updated_at – Zeitstempel der letzten Datenaktualisierung

Allgemeine Informationen

  1. Die Daten werden kostenfrei unter der CC0 1.0‑Lizenz bereitgestellt und dürfen ohne vorherige Anmeldung für beliebige Zwecke genutzt werden.
  2. Der Zarząd Dróg i Transportu Miejskiego w Szczecinie (Straßen- und Stadtverkehrsverwaltung in Szczecin) übernimmt keine Gewähr für die Richtigkeit oder Vollständigkeit der Daten und haftet nicht für Schäden oder Fehlentscheidungen, die auf deren Basis getroffen werden.
  3. In Produkten, die die Daten verwenden (App, Website, Publikation o. Ä.), bitten wir um die Angabe der Datenquelle „Zarząd Dróg i Transportu Miejskiego w Szczecinie“ oder abgekürzt „ZDiTM Szczecin“, dies ist jedoch nicht gesetzlich vorgeschrieben.
  4. Ebenfalls optional, aber erwünscht: Ein Link zu dieser Webseite oder zur Hauptseite von ZDiTM Szczecin in Ihrem Produkt.
  5. Clients sollten die HTTP‑Header Cache-Control und ETag erkennen und beachten.
  6. Die Anzahl der API‑Anfragen ist begrenzt: Es sind 100 Anfragen pro Minute und IP‑Adresse über alle Endpunkte erlaubt. Der Header X-RateLimit-Remaining zeigt die verbleibenden Anfragen an. Nach Erreichen des Limits wird der HTTP‑Status 429 zurückgegeben. Der Header X-RateLimit-Reset enthält dann einen Unix‑Timestamp für die Rücksetzung des Limits, und der Header Retry-After gibt die verbleibenden Sekunden bis zur Rücksetzung an.
  7. Wenn möglich, fügen Sie im User-Agent‑Header Ihrer Anfragen einen Hinweis auf den nutzenden Dienst (z. B. Name der App, Website oder URL) hinzu.
  8. Bei übermäßiger Serverlast behält sich ZDiTM Szczecin das Recht vor, den API‑Zugang teilweise oder vollständig zu sperren.

Migration von Version 1

  1. Endpoint geändert auf: GET https://www.zditm.szczecin.pl/api/v2/departure-boards/{stopNumber}.
  2. Die Antwortstruktur wurde vollständig geändert – bitte beachten Sie die Dokumentation.
  3. Zusätzlich wird das CBOR-Format (application/cbor) über den Parameter format=cbor unterstützt.