API — зупинки

Інформація про зупинки міського транспорту.

  • Endpoint: GET https://www.zditm.szczecin.pl/api/v1/stops
  • Формат даних: application/json
  • Частота оновлення: за потребою

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

{
  "data": [
    {
      "id": 1,
      "number": "10111",
      "name": "Turzyn Dworzec",
      "latitude": 53.428413,
      "longitude": 14.527252,
      "request_stop": false,
      "park_and_ride": false,
      "railway_station_name": null,
      "updated_at": "2023-05-28T11:45:34.000000Z"
    },

    ...

  ]
}
  • int id — унікальний ідентифікатор зупинки (незмінний)
  • string number — номер зупинки (може змінюватися)
  • string name — назва зупинки
  • float latitude — географічна широта зупинки
  • float longitude — географічна довгота зупинки
  • bool request_stop — true, якщо зупинка за замовленням
  • bool park_and_ride — true, якщо поруч є громадська стоянка «Park & Ride»
  • Додано string|null railway_station_name — назва залізничної станції поруч із зупинкою
  • string updated_at — мітка часу останнього оновлення даних

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

  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.