API – Fahrzeuge (Version 1)

Dies ist die Dokumentation für eine veraltete Version der API, die nur bis zum verfügbar sein wird. Bitte lesen Sie den Migrationsleitfaden für Version 2.

Informationen zur aktuellen Position der Fahrzeuge im öffentlichen Nahverkehr. Siehe auch: GTFS.

  • Endpoint: GET https://www.zditm.szczecin.pl/api/v1/vehicles
  • Datenformat: application/json
  • Aktualisierungs­frequenz: ca. alle 10 Sekunden

Datenstruktur

{
  "data": [
    {
      "line_id": 1,
      "line_number": "1",
      "line_type": "day",
      "line_subtype": "normal",
      "vehicle_type": "tram",
      "vehicle_id": 253,
      "vehicle_number": "121",
      "vehicle_model": "Tatra KT4Dt",
      "vehicle_low_floor": false,
      "vehicle_ticket_machine": {
        "cards": true,
        "coins": false
      },
      "vehicle_operator": "Tramwaje Szczecińskie",
      "route_variant_number": 12,
      "service": "001-02",
      "direction": "Osiedle Zawadzkiego",
      "previous_stop": "Brama Portowa",
      "next_stop": "Plac Żołnierza Polskiego",
      "latitude": 53.4282798767,
      "longitude": 14.5524597168,
      "bearing": 45,
      "velocity": 10,
      "punctuality": 0,
      "stuck": false,
      "updated_at": "2023-05-27T10:05:41.000000Z"
    },

    ...

  ]
}
  • int line_id – eindeutige Kennung der Linie (unveränderlich)
  • string line_number – Linienbezeichnung (Nummer) (kann sich ändern)
  • string line_type – Linie‑Typ:
    • day – Tageslinie
    • night – Nachtlinie
  • string line_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
  • int vehicle_id – eindeutige Fahrzeugkennung
  • string vehicle_number – Betriebsnummer
  • Hinzugefügt am string|null vehicle_model – Modellbezeichnung des Fahrzeugs
  • Hinzugefügt am bool|null vehicle_low_floor – true, wenn das Fahrzeug niederflurig ist
  • Hinzugefügt am object|null vehicle_ticket_machine – Informationen zum im Fahrzeug installierten Fahrkartenautomaten (wenn beide Unterfelder false sind, ist kein Automat vorhanden)
    • bool cards – Kartenzahlung möglich
    • bool coins – Münzzahlung möglich
  • Hinzugefügt am string|null vehicle_operator – Name des Fahrzeugbetreibers
  • int route_variant_number – Nummer des Routenvariants, den das Fahrzeug gerade bedient
  • string service – Kennzeichnung der Dienstschicht, die das Fahrzeug absolviert
  • string|null direction – Name der aktuell gefahrenen Fahrtrichtung
  • string|null previous_stop – Name der vorherigen Haltestelle
  • string|null next_stop – Name der nächsten Haltestelle
  • float latitude – geografische Breite des Fahrzeugs
  • float longitude – geografische Länge des Fahrzeugs
  • Hinzugefügt am int|null bearing – Fahrtrichtung in Grad (0 = Norden, 90 = Osten, …, in 45°-Schritten)
  • int velocity – aktuelle Geschwindigkeit in km/h
  • int punctuality – Abweichung vom Fahrplan in Minuten (0 = pünktlich, negativ = verspätet, positiv = vorzeitig)
  • Hinzugefügt am bool stuck – true, wenn sich das Fahrzeug nicht bewegt (feststeckt), mögliche Gründe sind u. a. ein Verkehrsstau oder eine Panne des Fahrzeugs
  • 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.