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

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

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

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

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

{
  "type": "FeatureCollection",
  "attributes": {
    "line_id": 1,
    "line_number": "1",
    "line_type": "day",
    "line_subtype": "normal",
    "vehicle_type": "tram",
    "updated_at": "2023-06-02T19:29:07.463152Z"
  },
  "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 — об’єкт з інформацією про маршрут:
  • 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 — автобус
  • 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 — масив пар [довгота, широта] для кожної точки маршруту

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

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