API – Linienverläufe

Informationen zum geografischen Verlauf der Linien des öffentlichen Nahverkehrs.

Zurückgegeben werden nur Linien, die an dem betreffenden Tag verkehren – und nur die an diesem Tag gültigen Varianten.

• Endpoint: GET https://www.zditm.szczecin.pl/api/v2/trajectories/{lineId}?format=json|cbor (den Wert für {lineId} erhalten Sie über das API für Linien – Feld id)
• Datenformat: application/json (GeoJSON – Standard) oder application/cbor (wenn format=cbor)
• Aktualisierungs­frequenz: einmal täglich

Datenstruktur

{
  "type": "FeatureCollection",
  "attributes": {
    "line": {
      "id": 1,
      "number": "1",
      "type": "DAY",
      "subtype": "NORMAL",
      "vehicle_type": "TRAM"
    },
    "updated_at": "2026-06-21T04:01:27.203488Z"
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "route_variant_number": 11,
        "route_variant_type": "DEFAULT"
      },
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            14.4884117153,
            53.4571634728
          ],

          ...

        ]
      }
    },

    ...

  ]
}

• string type – immer FeatureCollection
• object attributes – Objekt mit Metadaten zur zurückgegebenen Sammlung von Varianten
  • 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
  • string updated_at – Zeitstempel der letzten Datenaktualisierung
• array features – Array mit den Verläufen der einzelnen Varianten
  • string type – immer Feature
  • object properties – Objekt mit Details zur Variante
    • int route_variant_number – Variantenummer (ungerade = Hinfahrt, gerade = Rückfahrt)
    • string route_variant_type – Variantentyp:
      • DEFAULT – Standardroute
      • NORMAL – normale Route
      • OTHER – andere Route (Abstellfahrt oder Umleitung)
  • object geometry – Objekt mit den Koordinaten
    • string type – immer LineString
    • array coordinates – Array aus [Längengrad, Breitengrad]-Paaren für jeden Punkt der Route

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/trajectories/{lineId}.
2. Die Felder attributes.line_id, attributes.line_number, attributes.line_type, attributes.line_subtype und attributes.vehicle_type wurden in das neue Objekt attributes.line verschoben.
3. Die Werte der Felder attributes.line.type, attributes.line.subtype, attributes.line.vehicle_type und features.properties.route_variant_type werden im Format UPPER_SNAKE_CASE zurückgegeben.
4. Zusätzlich wird das CBOR-Format (application/cbor) über den Parameter format=cbor unterstützt.