Instrukcja obsługi (JSON):
Aktualna wersja: 1.0-beta
/bilkom/api/{typ}/{tryb}/{numerStacji}
gdzie {typ} oznacza jedną z wartości:
- arrivals - tablica przyjazdów wszystkich pociągów
- departures - tablica odjazdów wszystkich pociągów
- nextarrival - najbliższy przyjazd pociągu (uwzględniając opóźnienie)
- nextdeparture - najbliższy odjazd pociągu (uwzględniając opóźnienie)
{tryb} może przyjmować wartości:
- normal - informacje podstawowe
- extended - informacje rozszerzone: stacje pośrednie, godziny zatrzymań na poszczególnych stacjach, informacje o pociągu. Mocno niezalecane w połączeniu z arrival/departures z uwagi na obciążanie serwera.
a {numerStacji} jest unikalnym numerem stacji według bilkom.pl.
Zwraca on dane w formacie JSON:
- extralink - URL do danych szczegółowych danego pociągu
- trainCode - kod przewoźnika i numer pociągu
- timestamp - godzina przyjazdu/odjazdu w formacie timestamp
- track - tor
- platform - peron (cyfry rzymskie)
- arrivalStation - stacja początkowa
- delay - aktualne opóźnienie pociągu w minutach
- calculatedTime - godzina przyjazdu/odjazdu z uwzględnieniem opóźnienia, w formacie timestamp
- currentStation - bieżąca stacja
- amenities - (informacje rozszerzone) array zawierająca listę udogodnień w danym pociągu (klimatyzacja, wagon dla niepełnosprawnych, etc)
- via - (informacje rozszerzone) array zawierające informacje o stacjach pośrednich:
- arrival - godzina przyjazdu do stacji pośredniej (timestamp)
- departure - godzina odjazdu ze stacji pośredniej (timestamp)
- delayonarrival - opóźnienie przyjazdu do stacji pośredniej, w minutach
- delayondeparture - opóźnienie odjazdu ze stacji pośredniej, w minutach
- stop - czas planowego postoju, w minutach
- station - nazwa stacji pośredniej
- ondemand - przyjmuje wartość true jeżeli stacja ma status NŻ, false w przeciwnym wypadku
- beforeThisStation - wartość true, jeżeli stacja z listy znajduje się wcześniej na trasie pociągu, niż ta, która aktualnie jest sprawdzana. Nie działa poprawnie przy stacjach zbiorczych.
- thisStation - wartość true, jeżeli stacja z listy to stacja aktualnie przeglądana. Nie działa prawidłowo na stacjach zbiorczych.
Czekanie na odpowiedź może trochę potrwać, z racji tego, że crawler może przemielić za jednym zamachem do 40
stron. Proszę NIE nadużywać pobierania informacji rozszerzonych, chyba, że jest to konieczne (panowie z bilkomu mogą być źli).
Czasami może pojawić się błąd "Bilkom data download error". Oznacza to, że system Bilkom jest przeciążony. Zwykle powtórzenie zapytania załatwia sprawę.
Przykład: