🇵🇱 Polski
Note
English README and documentation are not yet available.
The application currently supports only Polish.
Aplikacja webowa do śledzenia na żywo pojazdów komunikacji miejskiej w Poznaniu i okolicach.
Wykorzystuje dane GTFS Realtime oraz GTFS Schedule udostępniane przez Zarząd Transportu Miejskiego w Poznaniu.
Wyświetlane są dane dotyczące pojazdów kursujących na terenie Poznania (transport realizowany przez Miejskie Przedsiębiorstwo Komunikacyjne w Poznaniu) oraz okolicznych gmin, które przesyłają dane do ZTM (m.in. Swarzędz, Luboń, Komorniki, Suchy Las).
- Wyświetlanie pojazdów na mapie w czasie rzeczywistym
- Wyświetlanie szczegółów kursów i pojazdów (przebieg trasy, przystanki, itp.)
- Progresywna Aplikacja Webowa (PWA)
- Lokalizacje wszystkich przystanków
- Szczegóły przystanków (linie, najbliższe odjazdy)
- Lokalizacje punktów sprzedaży biletów
- Rozkłady jazdy dla dowolnych linii i przystanków
- Łatwe wyszukiwanie (linie, pojazdy, kursy i przystanki)
- Informacje o opóźnieniach i przewidywanym czasie przyjazdu
- Lepsze wsparcie offline (np. rozkłady jazdy)
- Poprawki błędów i ulepszenia UI/UX
Projekt ma charakter hobbystyczny i edukacyjny.
Jest rozwijany w wolnym czasie i może zawierać błędy lub niekompletne funkcje.
Prezentowane dane pochodzą z systemów zewnętrznych i mogą być niepełne, opóźnione, chwilowo nieaktualne lub chwilowo nieprawidłowe.
Aplikacja jest w trakcie ciągłego rozwoju i ulepszania.
Projekt oraz autor aplikacji nie są w żaden sposób powiązani z Zarządem Transportu Miejskiego w Poznaniu, Miejskim Przedsiębiorstwem Komunikacyjnym w Poznaniu ani innymi operatorami transportu publicznego.
Aplikacja korzysta wyłącznie z publicznie dostępnych, otwartych danych i nie stanowi oficjalnego źródła informacji o komunikacji miejskiej.
Dane GTFS (Realtime i Schedule): API ZTM Poznań
Mapy: OpenStreetMap
Frontend: Leaflet, Shoelace, Vite
Backend: Flask, gtfs-realtime-bindings
Note
Poniższe instrukcje są przeznaczone tylko do uruchomienia w celach testowych i deweloperskich.
Do uruchomienia produkcyjnego należy użyć odpowiedniego serwera i narzędzi. Szczegóły w dokumentacji.
-
Wymagania
-
Sklonuj repozytorium
git clone https://github.com/bartekl1/mapa-ztm.git
cd mapa-ztm- Zainstaluj zależności backendu
poetry install- Uruchom serwer backendu (Flask w trybie deweloperskim)
poetry run python app.py- W osobnym terminalu przejdź do plików frontendu
cd frontend- Zainstaluj zależności frontendu
npm install- Uruchom serwer frontendu (Vite w trybie deweloperskim)
npm run dev- Otwórz przeglądarkę i przejdź pod http://localhost:5173
🐳 Instalacja na Dockerze
🏗️ Ręczne budowanie obrazu Docker
📦 Instalacja natywna (bez Dockera)
Projekt jest publikowany na licencji GNU Affero General Public License v3.0.