Urban Explorer

Urban Explorer – Dokumentácia projektu

1. Prehľad projektu Urban Explorer je gamifikovaná webová aplikácia, ktorá premieňa pohyb v meste na dobrodružstvo. Cieľom používateľa je „odomknúť“ každú ulicu vo svojom meste tým, že po nej fyzicky prejde. Aplikácia vizualizuje progres, ukladá históriu trás a motivuje používateľov k objavovaniu nepoznaných zákutí ich lokality.

2. Cieľová skupina Mestskí prieskumníci (Urban Explorers): Ľudia, ktorí chcú poznať každý kút svojho mesta. Nadšenci do fitness: Motivácia k chôdzi/behu novými trasami (proti stereotypu). Turisti: Spôsob, ako interaktívne spoznať nové mesto.

3. Technologický Stack Aplikácia je postavená na moderných webových technológiách s dôrazom na rýchlosť a responzivitu: Frontend: HTML5, CSS3 (Tailwind CSS pre moderný Glassmorphism dizajn). Mapové jadro: Leaflet.js – open-source knižnica pre interaktívne mapy. Dáta o uliciach: OpenStreetMap (OSM) cez Overpass API (dynamické sťahovanie zoznamu všetkých ulíc mesta). Geolokácia: Browser Geolocation API (sledovanie polohy v reálnom čase). Reverse Geocoding: Nominatim API (premena GPS súradníc na názvy ulíc). Storage: LocalStorage (ukladanie nicku, obľúbených miest a progresu bez nutnosti backendu pre MVP verziu).

4. Kľúčové funkcie A. Dynamické načítanie mesta (Overpass API) Aplikácia automaticky deteguje aktuálnu polohu používateľa a cez Overpass API stiahne zoznam všetkých unikátnych názvov ulíc v danej administratívnej oblasti (meste/obci). Tým sa definuje „100 % cieľ“ pre danú lokalitu.

B. Live Tracking a Map Matching Po kliknutí na „Štart“ aplikácia sleduje pohyb používateľa. Vykresľuje reálnu trasu (Polyline) na mapu. Každých pár metrov dopytuje Reverse Geocoding API. Ak sa názov ulice, na ktorej sa používateľ nachádza, zhoduje s názvom v databáze mesta, ulica sa započíta do progresu.

C. Systém progresu V hornej časti obrazovky sa nachádza dynamický Progress Bar a percentuálny ukazovateľ. Výpočet prebieha v reálnom čase: Progres % = (Počet unikátnych navštívených ulíc / Celkový počet ulíc v meste) * 100

D. Hotspoty (Obľúbené miesta) Používateľ si môže počas prieskumu uložiť body záujmu (napr. pekný výhľad, kaviareň). Tieto body sú perzistentne uložené a prístupné cez výsuvný panel.

1. Integrácia AI (Budúci rozvoj cez Google AI Studio) V aktuálnej verzii je pripravená štruktúra pre nasadenie Gemini 1.5 Pro/Flash: AI Narrative: Gemini môže analyzovať zoznam prejdených ulíc a generovať personalizované príbehy z histórie danej štvrte. Smart Recommendations: Na základe "bieleho miesta" na mape (neobjavené ulice) a preferencií používateľa (napr. parky) Gemini navrhne ideálnu trasu pre ďalšiu prechádzku.

   Vision Recognition: Možnosť odfotiť pamiatku v odomknutej ulici a nechať si ju AI popísať do digitálneho denníka.

2. Inštalácia a spustenie Aplikácia je navrhnutá ako "Single Page Application" (SPA) v jednom súbore pre maximálnu jednoduchosť: Otvorte súbor index.html v ľubovoľnom modernom prehliadači (Chrome, Safari, Firefox). Povoľte prístup k polohe (vyžadované pre funkčnosť trackingu). Pre správne fungovanie Overpass API je odporúčané spúšťať aplikáciu cez lokálny server (napr. VS Code Live Server).

3. Bezpečnosť a súkromie Dáta o polohe sú spracovávané výhradne na zariadení používateľa. Žiadne citlivé údaje sa neodosielajú na externý server (okrem anonymných dopytov na mapové API).

Built With

• css3
• html5
• leaflet.js
• nominatim
• overpass
• tailwind