Interaktywna mapa tras rowerowych Kudowa-Zdrój — projekt Interreg CZ-PL
W 1 miesiąc zrealizowaliśmy dla Gminy Kudowa-Zdrój interaktywną platformę z 5 transgranicznymi trasami rowerowymi i 57 punktami atrakcji turystycznych. Projekt powstał w ramach programu Interreg Czechy-Polska 2021-2027, łączy polskie i czeskie pograniczne ścieżki rowerowe, oraz oferuje podróżującym pełen zestaw narzędzi: profile wzniesień, eksport GPX, filtrowanie tras, mapy POI, dwujęzyczny interfejs.
Klient i kontekst projektu
Gmina Kudowa-Zdrój to znane polskie uzdrowisko w Górach Stołowych, na samej granicy z Czechami. Region ma znaczący potencjał turystyki rowerowej — łączy dwa kraje historyczną ścieżką ruchową, posiada zabytkowe miasteczka, parki, źródła zdrojowe oraz unikalną przyrodę.
Klient pozyskał finansowanie w ramach programu Interreg Czechy-Polska 2021-2027 na realizację projektu „Ścieżka rowerowa Kudowa-Zdrój – Žďárky", który łączy polską Kudowę z czeską miejscowością Žďárky w paśmie Gór Stołowych. Pełna realizacja projektu obejmowała wybudowanie ścieżki, oznakowanie POI, oraz stworzenie interaktywnej mapy online, która udostępnia trasę rowerzystom z całego świata.
ByteWave wybraliśmy jako wykonawcę części cyfrowej projektu — interaktywnej mapy z systemem zarządzania treścią. Wymóg był jasny: realizacja w 1 miesiąc, dwujęzyczny interfejs PL/CZ, integracja w transgranicznym programie unijnym.
Wyzwanie
Stworzenie interaktywnej mapy turystycznej dla projektu unijnego to projekt o specyficznych wymaganiach — łączy aspekty geograficzne (geodane, mapy, GPX), turystyczne (opisy tras, atrakcji), publiczne (zgodność z wymaganiami programu Interreg) oraz technologiczne (interaktywność, wydajność, mobilność).
Najpoważniejszym wyzwaniem był krótki termin realizacji — 1 miesiąc. W tak krótkim czasie należało zaprojektować mapę, zintegrować geodane (5 tras + 57 POI w 9 kategoriach), zbudować custom CMS dla gminy, wdrożyć dwujęzyczność PL/CZ, oraz przygotować dokumentację dla programu Interreg.
Drugim wyzwaniem było automatyczne wprowadzanie POI — 57 punktów to dużo do ręcznego wprowadzania. Stworzyliśmy dedykowany skrypt importu, który pobiera dane geograficzne i opisowe z formatu zewnętrznego, waliduje je, i automatycznie tworzy obiekty w naszym CMS — gmina dostała narzędzie, którym może w przyszłości łatwo dodawać kolejne punkty bez angażowania programistów.
Konkretne wymagania
- Interaktywna mapa z 5 trasami rowerowymi w pasie pogranicznym Kudowa-Zdrój – Žďárky
- 57 punktów POI w 9 kategoriach: Zabytki, Przyroda, Punkty widokowe, Muzea, Odpoczynek, Informacja, Kościoły, Przejścia graniczne, Parki
- Dwujęzyczny interfejs (PL/CZ) z możliwością łatwego rozszerzenia
- Filtrowanie tras po trudności (łatwa, średnia, trudna)
- Profile wzniesień dla każdej trasy (elevation chart)
- GPS / Pobieranie GPX dla każdej trasy
- Panel administracyjny CMS dla gminy do samodzielnego dodawania POI i tras
- Pełna dokumentacja techniczna jako wymóg projektu
- Realizacja w 1 miesiąc — twardy termin programu Interreg
- Zgodność z wymogami transgranicznego programu UE
- Mobile-first design — większość użytkowników to rowerzyści w terenie
Proces realizacji w 1 miesiąc
Kompresja projektu do 1 miesiąca wymagała równoległej realizacji wielu wątków oraz wykorzystania sprawdzonego stacku technologicznego. Każdy tydzień miał konkretny milestone z weryfikacją u klienta.
Discovery i przygotowanie danych
1 tydzieńSpotkania z gminą Kudowa-Zdrój, analiza projektu Interreg, ustalenia z czeskimi partnerami z Žďárky. Zebranie geodanych dla 5 tras (KML/GPX), opisów 57 POI w 9 kategoriach, zdjęć atrakcji, treści gminnych. Mapowanie struktury CMS.
Architektura i prototyp mapy
1 tydzieńKonfiguracja Leaflet + tile providers (OpenStreetMap), projekt układu mapy, filtrów, list tras, sidebara POI. Prototyp interaktywności: zoom, kliknięcie POI, otwarcie szczegółów trasy. Tworzenie schematu bazy danych dla tras i POI.
Development i CMS
1.5 tygodniaImplementacja frontendu (Leaflet + JS), backendu (PHP API), własnego CMS dla gminy, mechanizmu importu POI, profile wzniesień, eksport GPX. Implementacja dwujęzyczności PL/CZ. Testy na urządzeniach mobilnych.
Testy, dokumentacja, deployment
0.5 tygodniaTesty z gminą Kudowa-Zdrój i czeskimi partnerami, korekty językowe, optymalizacja wydajności, przygotowanie dokumentacji technicznej dla programu Interreg, szkolenie zespołu gminy z obsługi CMS, wdrożenie produkcyjne.
Rozwiązanie techniczne
Sercem mapy jest Leaflet — open-source biblioteka JavaScript do interaktywnych map. Wybór nieprzypadkowy: Leaflet jest dojrzały, szybki, lekki, ma bogaty ekosystem pluginów, oraz może korzystać z różnych dostawców tile (OpenStreetMap, Mapbox). Brak zależności od komercyjnego API (jak Google Maps) co jest kluczowe dla projektu publicznego — gmina nie ponosi opłat per request.
Dane POI obsługujemy przez dedykowany skrypt importu, który zaprojektowaliśmy. Gmina lub partnerzy projektu mogą przygotować dane w prostym formacie (CSV, GeoJSON), skrypt automatycznie waliduje pola, normalizuje współrzędne, kategoryzuje POI, i tworzy obiekty w bazie. Dzięki temu dodawanie kolejnych 57 lub więcej punktów to kwestia minut, nie dni.
Frontend ma wbudowane profile wzniesień dla każdej trasy — wykresy elevation generowane z punktów GPX. Daje to rowerzystom wgląd w trudność trasy zanim wyruszą. Eksport GPX umożliwia pobranie pliku do nawigacji zewnętrznej (Garmin, Wahoo, app rowerowe). Mobile-first design — większość rowerzystów konsultuje mapę na telefonie podczas trasy.
Dlaczego Leaflet zamiast Google Maps?
Google Maps to komercyjne API z opłatami per request — dla gminy to ryzyko nieprzewidywalnych kosztów. Leaflet + OpenStreetMap to darmowe rozwiązanie open-source. Dodatkowo Leaflet daje pełną kontrolę nad UX (custom markers, layers, kontrolki) — ważne dla projektu z dedykowanym brandingiem.
Dlaczego własny CMS, a nie WordPress?
WordPress świetnie sprawdza się dla treści edytorialnych, ale zarządzanie geodanymi (trasy, POI z koordynatami) wymaga specjalistycznego interfejsu. Własny lekki CMS pozwolił dopasować UI dokładnie do potrzeb gminy: dodawanie POI z mapy z kliknięciem, zarządzanie kategoriami, edycja tłumaczeń PL/CZ obok siebie.
Dlaczego automatyczny import POI?
57 punktów to za dużo do ręcznego wprowadzania w terminie 1 miesiąca. Skrypt importu pozwolił zaimportować wszystkie POI w ciągu kilku godzin, plus stworzył narzędzie dla gminy na przyszłość. Każda kolejna aktualizacja danych może być zaimportowana automatycznie.
Kluczowe funkcje platformy
Platforma została zaprojektowana z myślą o trzech grupach użytkowników: rowerzystach planujących trasę, turystach szukających atrakcji, oraz administratorach gminnych zarządzających contentem.
5 transgranicznych tras rowerowych
Trasy łączące polską Kudowę-Zdrój z czeską Žďárky — od łatwych (Kudowa-Słone-Náchod Bělovés, 20 km), przez średnie (Kudowa-Žďárky-Hronov 19 km, Kudowa-Žďárky-Pstrążna-Czermna 15 km), po trudne trasy górskie (29-32 km).
57 punktów POI w 9 kategoriach
Zabytki, Przyroda, Punkty widokowe, Muzea, Odpoczynek, Informacja, Kościoły, Przejścia graniczne, Parki. Każdy POI z opisem, zdjęciami, koordynatami, godzinami otwarcia (gdy istotne).
Filtrowanie tras po trudności
Łatwe / Średnie / Trudne — z natychmiastowym podświetleniem na mapie. Rowerzysta szybko widzi opcje pasujące do jego poziomu.
Profile wzniesień (elevation charts)
Każda trasa ma wbudowany wykres wzniesień generowany z punktów GPX. Rowerzysta widzi trudność trasy zanim wyruszy w teren.
Eksport GPX dla każdej trasy
Pobranie pliku GPX umożliwia załadowanie trasy do nawigacji zewnętrznej — Garmin, Wahoo, aplikacji typu Komoot, Strava.
GPS i lokalizacja użytkownika
Funkcja "Gdzie jestem?" pokazuje pozycję rowerzysty na mapie — kluczowe dla użytkowania w terenie podczas trasy.
Dwujęzyczny interfejs PL/CZ
Pełne tłumaczenia interfejsu i treści między polskim a czeskim. Przełącznik flag w nagłówku. Możliwość dodania kolejnych języków bez zmiany struktury.
Własny CMS dla gminy
Panel administracyjny pozwala gminie samodzielnie dodawać POI (z kliknięciem na mapie), zarządzać trasami, edytować opisy w obu językach, dodawać zdjęcia. Bez angażowania programistów.
Automatyczny import POI
Dedykowany skrypt pozwala importować większą ilość POI z formatu CSV/GeoJSON. Walidacja, normalizacja, kategoryzacja — wszystko automatycznie.
Mobile-first design
Większość użytkowania to rowerzysta w terenie, na telefonie. Interfejs zoptymalizowany pod dotykową obsługę, kompaktowe widoki, szybkie ładowanie nawet przy słabym sygnale.
Stack technologiczny
Stack open-source dający pełną kontrolę nad funkcjonalnością i brak opłat per request.
Wyniki
Mapa tras rowerowych Kudowa-Zdrój została zrealizowana w terminie 1 miesiąca i wdrożona produkcyjnie pod adresem trasyrowerowe.kudowa.pl. Spełnia wszystkie wymagania programu Interreg Czechy-Polska 2021-2027 — od strony funkcjonalnej (5 tras, 57 POI, dwujęzyczność) po dokumentacyjną (pełna dokumentacja techniczna).
Gmina Kudowa-Zdrój wystawiła referencje, w których podkreśla terminowość, profesjonalne podejście i wiedzę merytoryczną wykonawcy. Pełna treść listu referencyjnego dostępna na podstronie /referencje/kudowa/.
Z perspektywy turystów platforma stała się głównym narzędziem planowania wycieczek rowerowych w Górach Stołowych — łączy polską Kudowę z czeskim Žďárky, oferuje pełną mapę POI, profile wzniesień, GPX. Z perspektywy gminy CMS umożliwia samodzielne aktualizowanie treści — dodawanie nowych POI, korekta opisów, dodawanie zdjęć — bez angażowania ByteWave.
Co dalej
Mapa tras Kudowa-Zdrój jest aktywnie utrzymywana przez gminę — dodawane są nowe POI, aktualizowane opisy, dodawane sezonowe atrakcje. Roadmap obejmuje rozszerzenie o kolejne trasy w regionie, dodanie zdjęć panoramicznych 360° dla najbardziej widokowych punktów, oraz integrację z aplikacjami rowerowymi.
"Zadanie zostało zrealizowane z należytą starannością oraz w ustalonym terminie. Wykonawca wykazał się odpowiednią wiedzą merytoryczną, doświadczeniem oraz profesjonalnym podejściem do powierzonych obowiązków."
Przeczytaj pełny list referencyjny