API

Serwis udostępnia własne endpointy, z których korzysta jego aplikacja. Są publiczne i dostępne bez klucza, ale nie są produktem: mogą się zmienić razem z aplikacją.

Dostępne adresy

/api/delay-leaders
/api/departures
/api/map-tile
/api/okolica
/api/pojazd
/api/push-alarm
/api/push-klucz
/api/push-subskrypcja
/api/push-wypisz
/api/ruch
/api/statystyki
/api/statystyki-linii
/api/stops
/api/topology
/api/trasa
/api/vehicles

Wszystkie zwracają JSON i obsługują ETag — powtórne żądanie z nagłówkiem If-None-Match dostaje 304 bez treści.

Co jest w bazie analitycznej

Dane historyczne, na których liczone są statystyki. Poniższa lista jest generowana wprost ze schematu bazy, więc nie może się z nim rozjechać.

tabela	kolumny
`gps_snapshot`	`id`, `last_update`, `fetched_at`, `vehicles`
`gps_course`	`id`, `route_id`, `trip_id`, `scheduled_start`, `route_short`, `headsign`
`gps_vehicle`	`vehicle_id`, `vehicle_code`, `first_seen`, `last_seen`
`gps_position`	`snapshot_id`, `vehicle_id`, `course_id`, `service`, `generated`, `lat`, `lon`, `speed`, `direction`, `delay`, `gps_quality`
`dep_sighting`	`id`, `stop_key`, `dep_key`, `source`, `line`, `headsign`, `scheduled`, `trip_start`, `vehicle_code`, `vehicle_id`, `channel`, `first_seen`, `last_seen`, `samples`, `first_eta`, `last_eta`, `last_delay`, `last_status`, `gone_at`, `gone_reason`
`dep_delay_sample`	`sighting_id`, `at`, `delay`, `eta`, `status`
`agg_godzina`	`godzina_utc`, `source`, `klasa`, `wersja_regul`, `probek`, `mediana`, `p90`, `srednia`, `ponad5min`, `ponad15min`, `przed1min`, `przed2min`
`agg_linia`	`godzina_utc`, `source`, `line`, `wersja_regul`, `probek`, `srednia`, `mediana`, `ponad5min`, `przed1min`, `przed2min`, `slupkow`
`ruch_godzina`	`godzina_utc`, `kategoria`, `zadan`
`ruch_wizyty`	`godzina_utc`, `wizyt`
`ruch_sciezka`	`godzina_utc`, `sciezka`, `zadan`
`ruch_klient`	`godzina_utc`, `klasa`, `zadan`, `wizyt`
`push_subskrypcja`	`endpoint`, `p256dh`, `auth`, `utworzono`, `ostatnio_ok`, `bledy`
`push_alarm`	`endpoint`, `alarm_id`, `o_ms`, `dodano`, `wyslano`
`ruch_dzien`	`dzien`, `wizyt`, `zadan`
`agg_przystanek`	`godzina_utc`, `stop_key`, `wersja_regul`, `probek`, `srednia`, `ponad5min`, `przed1min`, `linii`
`agg_gps_godzina`	`godzina_utc`, `pozycji`, `pojazdow`, `predkosc_sr`, `predkosc_med`, `stojacych`, `jakosc_zla`, `bez_kursu`
`agg_dryf`	`godzina_utc`, `horyzont_min`, `wersja_regul`, `kursow`, `mediana_abs`, `p90_abs`, `mediana_znak`, `srednia_znak`, `odrzuconych`, `stabilnych`, `wczesniej60`, `pozniej60`
`agg_widma`	`godzina_utc`, `klasa`, `literowa`, `wersja_regul`, `znikniec`

Żadna z tych tabel nie zawiera informacji o osobach korzystających z serwisu — opisują wyłącznie pojazdy, kursy i przystanki. Szczegóły: Prywatność.

Skąd brać dane źródłowe

Jeśli budujesz coś własnego, sięgaj bezpośrednio do API miast, a nie do tego serwisu: dane są tam pierwotne, a Twoje zapytania nie będą zależeć od dostępności cudzej nakładki.