ScanMap - Aplikacja PWA do Skanowania Ulic

ScanMap to progresywna aplikacja webowa (PWA) zaprojektowana do systematycznego skanowania i mapowania ulic w wyznaczonych sektorach.

Funkcjonalności

1. Wybór Miasta

• Wyszukiwanie miast za pomocą API Nominatim
• Automatyczne centrowanie mapy na wybranym mieście

2. Podział na Sektory

• Automatyczny podział miasta na małe kwadraciki (siatka)
• Możliwość zaznaczania i grupowania kwadracików w sektory
• Tworzenie i nazywanie własnych sektorów
• Przechowywanie sektorów w pamięci lokalnej przeglądarki

3. Punkt Startu

• Ustawianie punktu początkowego na mapie
• Wizualna reprezentacja punktu startu

4. Wyznaczanie Trasy

• Wybór sektora do skanowania
• Automatyczne wyznaczanie optymalnej trasy przez wszystkie ulice w sektorze
• Numeracja kolejności przejazdu ulic

5. Śledzenie GPS

• Rozpoczęcie śledzenia pozycji w czasie rzeczywistym
• Automatyczne oznaczanie ulic jako przeskanowane podczas przejazdu
• Wizualna zmiana koloru: żółty (niezeskanowane) → przezroczysty szary (zeskanowane)
• Statystyki postępu skanowania

6. Statystyki

• Liczba przeskanowanych ulic
• Liczba pozostałych ulic
• Procentowy postęp wykonania

Technologie

• HTML5 - struktura aplikacji
• CSS3 - stylizacja i responsywny design
• JavaScript (ES6+) - logika aplikacji
• Leaflet.js - interaktywne mapy
• OpenStreetMap - dane mapowe
• Service Worker - funkcjonalność offline (PWA)
• Geolocation API - śledzenie GPS
• LocalStorage - przechowywanie danych lokalnie

Instalacja i Uruchomienie

Lokalne uruchomienie

1. Sklonuj repozytorium:

git clone https://github.com/c14b7/scanMap.git
cd scanMap

2. Uruchom lokalny serwer HTTP (wymagane dla Service Worker):

Opcja A - Python 3:

python3 -m http.server 8000

Opcja B - Python 2:

python -m SimpleHTTPServer 8000

Opcja C - Node.js (http-server):

npx http-server -p 8000

Opcja D - PHP:

php -S localhost:8000

3. Otwórz przeglądarkę i przejdź do:

http://localhost:8000

Instalacja jako PWA

1. Otwórz aplikację w przeglądarce obsługującej PWA (Chrome, Edge, Safari)
2. Kliknij ikonę "Zainstaluj" w pasku adresu
3. Aplikacja zostanie dodana do ekranu głównego/menu start

Użycie

Krok 1: Wybierz Miasto

1. Wpisz nazwę miasta w pole wyszukiwania
2. Kliknij "Szukaj"
3. Wybierz miasto z listy wyników

Krok 2: Utwórz Sektory

1. Kliknij "Pokaż/Ukryj Siatkę" aby wyświetlić siatkę
2. Kliknij "Utwórz Nowy Sektor"
3. Zaznacz kwadraciki na mapie klikając na nie
4. Nadaj nazwę sektorowi
5. Kliknij "Zapisz Sektor"

Krok 3: Ustaw Punkt Startu

1. Kliknij "Ustaw Punkt Startu"
2. Kliknij na mapie w miejscu, gdzie chcesz rozpocząć

Krok 4: Wyznacz Trasę

1. Wybierz sektor z listy rozwijanej
2. Kliknij "Wyznacz Trasę"
3. System wyznaczy optymalną trasę przez wszystkie ulice

Krok 5: Rozpocznij Skanowanie

1. Kliknij "Rozpocznij Śledzenie GPS"
2. Zezwól na dostęp do lokalizacji
3. Podczas jazdy ulice będą automatycznie oznaczane jako przeskanowane
4. Obserwuj postęp w sekcji statystyk

Wymagania

• Przeglądarka wspierająca:
  • Service Workers
  • Geolocation API
  • LocalStorage
  • ES6+
• Połączenie internetowe (do wczytania map, może działać offline po pierwszym załadowaniu)
• GPS/lokalizacja (do śledzenia pozycji)

Wsparcie Przeglądarek

• ✅ Chrome/Chromium 80+
• ✅ Edge 80+
• ✅ Safari 13+
• ✅ Firefox 75+
• ✅ Opera 67+

Prywatność i Dane

• Wszystkie dane są przechowywane lokalnie w przeglądarce
• Nie wysyłamy żadnych danych osobowych do serwerów
• Lokalizacja GPS jest wykorzystywana tylko lokalnie
• Dane sektorów można wyczyścić w ustawieniach przeglądarki

Rozwój

Aplikacja jest w fazie rozwoju. Planowane funkcje:

• Eksport/import danych sektorów
• Integracja z API OpenStreetMap Overpass dla rzeczywistych danych ulic
• Zaawansowane algorytmy optymalizacji tras (Chinese Postman Problem)
• Współdzielenie sektorów między użytkownikami
• Statystyki i raporty
• Tryb offline z pre-cachowanymi mapami

Licencja

MIT

Autorzy

Projekt ScanMap