Jak działają dane o pociągach w Wsiadam?

Najważniejsza zasada jest prosta: nie przedstawiać informacji jako pewniejszej, niż pozwala źródło. Jeżeli coś jest planem, powinno pozostać planem. Jeżeli jest orientacyjną projekcją, nie może wyglądać jak potwierdzony fakt.

Zanim pociąg ruszy: dane planowane

Podstawą podróży jest rozkład, czyli planowany przebieg kursu. PKP PLK udostępnia otwarte dane dotyczące planowanego ruchu pasażerskiego oraz jego realizacji.

Plan odpowiada na pytanie „co powinno się wydarzyć?”. Nie odpowiada sam z siebie na pytanie „co już się wydarzyło?”. Dlatego godzina z rozkładu nie powinna być przedstawiana jak bieżące potwierdzenie przejazdu.

Co wiadomo z realizacji ruchu

Gdy pojawiają się dane o realizacji, można odróżnić plan od zdarzeń już odnotowanych w przebiegu pociągu. Oficjalne narzędzia pasażerskie rozdzielają informacje rozkładowe, zrealizowane i prognozowane.

Dla pasażera różnica jest istotna. Zrealizowany punkt mówi o tym, co już zostało odnotowane. Nie oznacza automatycznie, że znamy dokładną fizyczną pozycję pociągu pomiędzy kolejnymi punktami trasy.

Co oznacza prognoza dalszego przejazdu

Prognoza opisuje przyszłość na podstawie dostępnych danych. Może być bardzo użyteczna, bo pomaga zorientować się, czego spodziewać się dalej. Nadal jednak może się zmienić.

Dlatego nie należy zamieniać prognozowanego czasu przyjazdu w obietnicę konkretnej minuty. Jeżeli nowsze dane zmienią obraz przejazdu, prognoza również powinna zostać potraktowana jako zmienna informacja.

GPS a informacja o przejeździe

GPS w oficjalnych narzędziach kolejowych

Oficjalne narzędzia PLK mogą korzystać z GPS dla wybranych pociągów. Jeżeli źródło rzeczywiście dostarcza lokalizację GPS, można ją opisywać zgodnie z zakresem i świeżością tej informacji.

Nie wolno uogólniać tej funkcji na cały ruch. Nie każdy pociąg ma dostępną oficjalną lokalizację GPS, a nie każda informacja o położeniu pociągu w wsiadam jest odczytem GPS.

Kiedy lokalizacja jest tylko przybliżona

Pozycja pomiędzy punktami może być przybliżeniem lub wynikiem wnioskowania. W takim przypadku użytkownik powinien widzieć różnicę między fizycznym pomiarem a informacją wyliczoną z innych danych.

Jeżeli dane nie pozwalają potwierdzić dokładnej lokalizacji, nie udajemy większej dokładności.

Jak wsiadam rozróżnia informacje w Twoim przejeździe

wsiadam traktuje inaczej plan, oficjalne potwierdzenie, informację orientacyjną i dane związane z Twoją własną lokalizacją. To rozróżnienie decyduje o tym, jaką pewność można przypisać komunikatowi.

Planowane

Informacja planowana pochodzi z rozkładu i opisuje to, co powinno się wydarzyć. Sam rozkład nie jest dowodem, że pociąg rzeczywiście przyjechał, odjechał albo minął dany punkt.

Jeżeli dostępny jest tylko plan, wsiadam nie powinien przedstawiać wynikającego z niego postępu jako fizycznie lub oficjalnie potwierdzonego przejazdu.

Oficjalnie potwierdzone

wsiadam może uznać zdarzenie za oficjalnie potwierdzone, gdy dostępna zaakceptowana informacja kolejowa potwierdza rzeczywisty przyjazd, odjazd albo przejazd przez dany punkt.

Takie potwierdzenie dotyczy konkretnego zdarzenia. Nie oznacza automatycznie, że wsiadam zna dokładną, ciągłą pozycję fizyczną pociągu pomiędzy stacjami.

Znaczenie mają też dwa różne momenty: kiedy zdarzenie rzeczywiście nastąpiło oraz kiedy informacja o nim dotarła do wsiadam. To nie zawsze jest ta sama chwila, dlatego świeżość danych trzeba oceniać oddzielnie od czasu samego zdarzenia.

Orientacyjne

wsiadam może pokazywać orientacyjny postęp podróży na podstawie dostępnych dowodów: rozkładu, znanego opóźnienia lub czasów przejazdu, ostatniego oficjalnie potwierdzonego punktu i kolejnych planowanych punktów trasy.

Taka informacja pomaga odpowiedzieć na praktyczne pytanie „na jakim etapie przejazdu prawdopodobnie jesteśmy?”. Powinna być jednak opisana jako orientacyjna, „według dostępnych danych” albo „na podstawie ostatniego potwierdzenia i rozkładu”.

Orientacja lub projekcja nie jest oficjalnym potwierdzeniem i nie jest dokładną pozycją pociągu.

Osobiste dane z lokalizacji użytkownika

Po zgodzie użytkownika wsiadam może korzystać z lokalizacji jego telefonu, aby pomóc w osobistym kontekście podróży — na przykład rozpoznać, że użytkownik jest w pobliżu punktu trasy, pomiędzy przystankami, zbliża się do kolejnego punktu albo jest blisko celu. Taka informacja jest używana dopiero po sprawdzeniu jej jakości i ciągłości.

W osobistym widoku świeża lokalizacja telefonu może czasem być bardziej użyteczna niż starsza, zachowana informacja o przebiegu pociągu. Nie zmienia to jednak statusu danych kolejowych.

Lokalizacja telefonu nie staje się oficjalną pozycją pociągu. Nie zmienia oficjalnego przebiegu pociągu w wsiadam, surowe współrzędne GPS użytkownika nie stają się serwerową, oficjalną historią pociągu, a GPS telefonu nie służy do wyliczania czasu przyjazdu pociągu.

Dlaczego czas aktualizacji ma znaczenie

„Aktualne” nie znaczy tego samego co „ostatnio znane”. Świeża informacja czasu rzeczywistego może być prezentowana jako bieżąca. Starsza, zachowana informacja czasu rzeczywistego może nadal być najlepszą dostępną wskazówką, ale nie powinna wyglądać jak świeży status.

Jeżeli nie ma bieżącego potwierdzenia, rozkład nadal może służyć jako plan i punkt orientacyjny. Nie staje się przez to informacją o tym, co faktycznie wydarzyło się w trasie.

wsiadam nie obiecuje stałej częstotliwości odświeżania ani nie publikuje wewnętrznych progów świeżości. Ważne jest natomiast rozdzielenie czasu zdarzenia od czasu, w którym dowód o tym zdarzeniu został odebrany.

Dlaczego prognoza nie powinna udawać pewnej godziny

Dokładna minuta wygląda jak konkretna obietnica. Jeżeli jednak wartość jest prognozą albo wynikiem wnioskowania, prezentowanie jej bez odpowiedniego kontekstu może sugerować pewność, której dane nie mają.

wsiadam może pokazywać prognozowane czasy otrzymane w danych kolejowych, korzystać z potwierdzonych czasów i opóźnień oraz tworzyć orientację wynikającą z rozkładu lub ostatniego oficjalnie potwierdzonego zdarzenia. Taki kontekst nadal pozostaje orientacją, jeżeli nie ma potwierdzenia.

wsiadam nie tworzy własnego precyzyjnego ETA na podstawie GPS i nie używa lokalizacji telefonu użytkownika do obliczania czasu przyjazdu pociągu.

Co może zmienić się podczas podróży

Realizacja przejazdu, opóźnienie, prognoza kolejnych punktów i komunikaty operacyjne mogą zmieniać się wraz z rozwojem sytuacji. Z tego powodu pasażer powinien móc odróżnić to, co zaplanowane, od tego, co już potwierdzone, oraz od informacji mniej pewnej.

W praktyce oznacza to, że nowe oficjalne potwierdzenie może zmienić wcześniejszą orientację, a starsza informacja może przestać być wystarczająco świeża, by opisywać ją jako bieżącą.

Źródła danych i ograniczenia

wsiadam korzysta obecnie po stronie serwera z informacji kolejowych udostępnianych przez PKP Polskie Linie Kolejowe S.A. — API Otwarte Dane Kolejowe. Portal Pasażera i publiczne materiały PKP PLK mogą służyć jako oficjalne materiały referencyjne przy wyjaśnianiu znaczenia danych; nie przedstawiamy Portalu Pasażera jako osobnego źródła zasilającego wsiadam.

wsiadam jest niezależnym projektem. Nie jest oficjalną aplikacją PKP PLK ani przewoźnika kolejowego.

Dane kolejowe mogą opisywać plan, realizację i prognozy, ale nie każda informacja oznacza ciągły pomiar fizycznej pozycji pociągu. Dlatego przy konkretnym przejeździe warto patrzeć jednocześnie na rodzaj informacji, jej źródło i świeżość.

Jeżeli dane nie pozwalają czegoś potwierdzić, nie udajemy większej dokładności.