API — траєкторія маршруту

Це документація для версії 2 API. Документація для застарілої версії 1.

Інформація про географічний маршрут громадського транспорту.

Дані повертаються лише для маршрутів, які курсують у цей день, — і лише для варіантів маршруту, чинних у цей день.

Endpoint: GET https://www.zditm.szczecin.pl/api/v2/trajectories/{routeId}?format=json|cbor (значення параметра {routeId} можна отримати через API для маршрутів — поле id)
Формат даних: application/json (GeoJSON — за замовчуванням) або application/cbor (коли format=cbor)
Частота оновлення: раз на добу

Структура даних

{
  "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 — завжди FeatureCollection
object attributes — об’єкт, що містить метадані про повернуту колекцію варіантів маршруту
- object line — об’єкт з інформацією про маршрут
  - int id — унікальний ідентифікатор маршруту (незмінний)
  - string number — позначення маршруту (номер) (може змінюватися)
  - string type — тип маршруту:
    - DAY — денний маршрут
    - NIGHT — нічний маршрут
  - string subtype — підтип маршруту:
    - NORMAL — звичайний маршрут
    - SEMI_FAST — напівшвидкісний маршрут
    - FAST — швидкісний маршрут
    - REPLACEMENT — заміщаючий маршрут
    - ADDITIONAL — додатковий маршрут
    - SPECIAL — спеціальний маршрут
    - TOURIST — туристичний маршрут
  - string vehicle_type — тип рухомого складу:
    - SKM — потяг SKM
    - TRAM — трамвай
    - BUS — автобус
- string updated_at — мітка часу останнього оновлення даних
array features — масив із геометрією кожного варіанта маршруту з такими полями
- string type — завжди Feature
- object properties — об’єкт із деталями варіанта
  - int route_variant_number — номер варіанта маршруту (непарний = в напрямку туди, парний = у зворотному)
  - string route_variant_type — тип варіанта:
    - DEFAULT — стандартний маршрут
    - NORMAL — звичайний маршрут
    - OTHER — інший маршрут (виїзд до депо чи об’їзд)
- object geometry — об’єкт із координатами маршруту
  - string type — завжди LineString
  - array coordinates — масив пар [довгота, широта] для кожної точки маршруту

Загальна інформація

Дані надаються безкоштовно за ліцензією CC0 1.0, для будь‑якого використання без попереднього погодження.
Zarząd Dróg i Transportu Miejskiego w Szczecinie (Управління доріг і міського транспорту в Щецині) не гарантує правильність чи повноту даних і не несе відповідальності за можливі збитки чи помилкові рішення на їх основі.
У продуктах (додатках, веб‑сайтах, публікаціях тощо) рекомендується вказувати джерело даних як «Zarząd Dróg i Transportu Miejskiego w Szczecinie» або скорочено «ZDiTM Szczecin» (не є обов’язковим).
За можливості бажано додати посилання на цю сторінку або на головну сторінку ZDiTM Szczecin (не є юридично обов’язковим).
Клієнти повинні розпізнавати й дотримуватися HTTP‑заголовки Cache-Control та ETag.
Кількість запитів до API обмежена: 100 запитів на хвилину з однієї IP‑адреси для всіх endpointів. Заголовок X-RateLimit-Remaining показує кількість залишкових запитів. Після вичерпання ліміту повертається код HTTP 429. У відповідному заголовку X-RateLimit-Reset вказано Unix‑мітку часу скидання ліміту, а Retry-After — кількість секунд до скидання.
Якщо можливо, додайте в заголовок User-Agent інформацію про організацію чи додаток, що використовує дані (наприклад, назву або URL).
У разі надмірного навантаження на сервер ZDiTM Szczecin залишає за собою право частково або повністю блокувати доступ до API.

Міграція з версії 1

Endpoint змінено на: GET https://www.zditm.szczecin.pl/api/v2/trajectories/{lineId}.
Поля attributes.line_id, attributes.line_number, attributes.line_type, attributes.line_subtype і attributes.vehicle_type перенесено до нового об’єкта attributes.line.
Значення полів attributes.line.type, attributes.line.subtype, attributes.line.vehicle_type і features.properties.route_variant_type повертаються у форматі UPPER_SNAKE_CASE.
Додатково підтримується формат CBOR (application/cbor) через параметр format=cbor.