wtyczka-zms/readme.md

Rozszerzenie Przeglądarki ZEDEMES 2.0

Rozszerzenie Chrome integrujące się z polskimi usługami geodezyjnymi i platformami mapowymi, zapewniające rozszerzoną funkcjonalność w pracy z danymi katastralnymi, dokumentami planowania przestrzennego i różnymi dostawcami map.

Funkcje

Integracja z Dostawcami Map

• Geoportal - Integracja z polskim geoportalem narodowym
• Google Maps - Szybki dostęp do Google Maps z bieżącymi współrzędnymi
• ISOK - System informacji o gospodarce wodnej
• SOPO - System oceny ryzyka osuwisk
• GDOS - Dane o ochronie środowiska
• LPP - Integracja z lokalnym portalem drogowym

Funkcje Danych Przestrzennych

• Działki Katastralne - Wyświetlanie granic katastralnych i numerów działek
• Planowanie Przestrzenne - Nakładka MPZP (miejscowe plany zagospodarowania przestrzennego) overlay
• Narzędzia Pozycji - Wyświetlanie i kopiowanie współrzędnych
• Profilowanie Przekrojów - Analiza przekrojów terenu
• Nakładka Osuwisk - Wizualizacja zagrożeń geologicznych

Obsługa Systemów Współrzędnych

• EPSG:2177 (Polski system współrzędnych)
• EPSG:2180 (PUWG 92)
• EPSG:4326 (WGS84)
• EPSG:3857 (Web Mercator)

Instalacja

1. Sklonuj repozytorium:

git clone https://git.wastpol.pl/admin/wtyczka-zms.git

2. Otwórz Chrome i przejdź do chrome://extensions/

3. Włącz "Tryb deweloperski" w prawym górnym rogu

4. Kliknij "Załaduj rozpakowane" i wybierz katalog rozszerzenia

Struktura Projektu

├── manifest.json          # Manifest rozszerzenia
├── js/
│   ├── background.js      # Skrypt w tle
│   ├── content.js         # Główny skrypt zawartości
│   ├── core.js           # Funkcjonalność podstawowa
│   ├── inject.js         # Skrypt wstrzykiwania na stronę
│   ├── intercept.js      # Przechwytywanie żądań
│   ├── functions/        # Implementacje funkcji
│   │   ├── dzialki.js    # Działki katastralne
│   │   ├── dzialki2.js   # Alternatywne źródło katastralne
│   │   ├── lines.js      # Narzędzia linii
│   │   ├── mpzp.js       # Planowanie przestrzenne
│   │   ├── osuwiska.js   # Dane o osuwiskach
│   │   ├── position.js   # Narzędzia pozycji
│   │   ├── section.js    # Profilowanie terenu
│   │   └── test.js       # Narzędzia testowe
│   ├── handlers/         # Obsługa wiadomości i zdarzeń
│   │   ├── geoButton.js  # Obsługa przycisku Geoportal
│   │   ├── getChelmiec.js # Obsługa gminy Chełmiec
│   │   ├── getGmina.js   # Wykrywanie gminy
│   │   ├── messages.js   # Obsługa wiadomości
│   │   └── translate.js  # Tłumaczenie współrzędnych
│   └── map_providers/    # Integracje z zewnętrznymi usługami mapowymi
│       ├── gdos.js       # Integracja z GDOS
│       ├── geoportal.js  # Integracja z Geoportal
│       ├── google.js     # Integracja z Google Maps
│       ├── isok.js       # Integracja z ISOK
│       ├── lpp.js        # Integracja z LPP
│       └── sopo.js       # Integracja z SOPO
├── icons/                # Ikony rozszerzenia i zasoby UI
└── readme.md            # Ten plik

Konfiguracja

Rozszerzenie korzysta z API MapTiler do transformacji współrzędnych. Może być konieczne zaktualizowanie klucza API w plikach dostawców map:

// Zaktualizuj ten klucz w plikach map_providers/*.js
const API_KEY = "OZa2pWHGvC94xakI0fVk";

Użycie

1. Przejdź na obsługiwaną stronę mapową (np. *.tauron-dystrybucja.pl)
2. Rozszerzenie automatycznie wstrzyknie przyciski narzędziowe dla różnych dostawców map
3. Kliknij dowolny przycisk dostawcy, aby otworzyć bieżący zakres mapy w tej usłudze
4. Użyj narzędzi rysowania do tworzenia profili terenu i oznaczania pozycji

Obsługiwane Gminy

• Chełmiec
• Łososina Dolna
• Nawojowa

Rozwój

Dodawanie Nowych Dostawców Map

1. Utwórz nowy plik w js/map_providers/
2. Zaimplementuj funkcję obsługi kliknięcia przycisku
3. Dodaj logikę transformacji współrzędnych
4. Zarejestruj dostawcę w manifest.json

Dodawanie Nowych Funkcji

1. Utwórz nowy plik w js/functions/
2. Zaimplementuj logikę funkcji
3. Dodaj elementy UI w js/handlers/messages.js
4. Zarejestruj w tablicy skryptów zawartości

Punkty Końcowe API

Rozszerzenie integruje się z kilkoma zewnętrznymi API:

• MapTiler API - Transformacje współrzędnych
• Usługi GUGIK - Polskie dane katastralne
• Geoportal.gov.pl - Usługi narodowego geoportalu
• Usługi PIG - Dane Państwowego Instytutu Geologicznego

Obsługa Przeglądarek

• Chrome 88+
• Kompatybilne z Manifest V3

Licencja

Ten projekt jest oprogramowaniem własnościowym opracowanym do użytku wewnętrznego.

Wkład

1. Sforkuj repozytorium
2. Utwórz gałąź funkcji
3. Zatwierdź swoje zmiany
4. Wypchnij do gałęzi
5. Utwórz Pull Request

Historia Wersji

• v0.0.13 - Bieżąca wersja z rozszerzoną integracją dostawców map
• Poprzednie wersje skupiały się na rozwoju podstawowej funkcjonalności

Kontakt

W przypadku pytań lub wsparcia skontaktuj się z zespołem deweloperskim w organizacji.