149 lines
5.4 KiB
Markdown
149 lines
5.4 KiB
Markdown
# 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:
|
|
```bash
|
|
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:
|
|
|
|
```javascript
|
|
// 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.
|
|
|