API — транспортні засоби

Інформація про поточне розташування транспортних засобів громадського транспорту. Див. також: GTFS.

Endpoint: GET https://www.zditm.szczecin.pl/api/v1/vehicles
Формат даних: application/json
Частота оновлення: приблизно кожні 10 секунд

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

{
  "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,
      "updated_at": "2023-05-27T10:05:41.000000Z"
    },

    ...

  ]
}

int line_id — унікальний ідентифікатор маршруту (незмінний)
string line_number — позначення маршруту (номер) (може змінюватися)
string line_type — тип маршруту:
- day — денний маршрут
- night — нічний маршрут
string line_subtype — підтип маршруту:
- normal — звичайний маршрут
- semi-fast — напівшвидкісний маршрут
- fast — швидкісний маршрут
- replacement — заміщаючий маршрут
- additional — додатковий маршрут
- special — спеціальний маршрут
- tourist — туристичний маршрут
string vehicle_type — тип рухомого складу:
- skm — потяг SKM
- tram — трамвай
- bus — автобус
int vehicle_id — унікальний ідентифікатор транспортного засобу
string vehicle_number — бортовий номер транспортного засобу
Додано 27 вересня 2024 string|null vehicle_model — модель транспортного засобу
Додано 27 вересня 2024 bool|null vehicle_low_floor — true, якщо низькопідлоговий
Додано 27 вересня 2024 object|null vehicle_ticket_machine — інформація про встановлений у транспортному засобі квиткомат (якщо обидва підполі false, квиткомат відсутній)
- bool cards — приймає картки
- bool coins — приймає монети
Додано 9 лютого 2025 string|null vehicle_operator — оператор транспортного засобу
int route_variant_number — номер варіанта маршруту, який обслуговує транспортний засіб
string service — позначення рейсу (бригади)
string|null direction — напрямок руху транспортного засобу
string|null previous_stop — назва попередньої зупинки
string|null next_stop — назва наступної зупинки
float latitude — широта транспортного засобу
float longitude — довгота транспортного засобу
Додано 21 вересня 2024 int|null bearing — курс у градусах від 0 до 360 (0 або 360 = північ, 90 = схід тощо; крок 45°)
int velocity — поточна швидкість у км/год
int punctuality — відхилення від розкладу в хвилинах (0 = за розкладом; негативне = запізнення; позитивне = випередження)
string updated_at — мітка часу останнього оновлення даних

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

Дані надаються безкоштовно за ліцензією 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.