Files
panel/docs/LAYER_NOTES.md

223 lines
5.8 KiB
Markdown

# Map Layers - Implementation Notes & Documentation
Personal notes and official documentation references for each map layer implementation.
---
## Base Layers
### OpenStreetMap
**Status:** ✅ Working
**Type:** XYZ Tiles
**URL:** `https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png`
**Implementation Notes:**
- OSM - up to zoom 20
---
### 🇵🇱 Polish Orthophoto (Standard Resolution)
**Status:** ✅ Working (minor issue)
**Type:** WMTS
**Service:** Polish Geoportal PZGIK/ORTO
**URL:** `https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMTS/StandardResolution`
**Implementation Notes:**
- Polish Ortophoto stantard - ok up to zoom 19
**Official Documentation:**
- GetCapabilities WMTS: `https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMTS/StandardResolution?Service=WMTS&Request=GetCapabilities`
- GetCapabilities WMS: `https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMS/StandardResolution?Service=WMS&Request=GetCapabilities`
---
### 🇵🇱 Polish Orthophoto (High Resolution)
**Status:** Not Working
**Type:** WMTS
**Service:** Polish Geoportal PZGIK/ORTO
**URL:** `https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMTS/HighResolution`
**Implementation Notes:**
- Polish Ortophoto Hirez - doesnt load at all
**Official Documentation:**
- GetCapabilities WMTS: `https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMTS/HighResolution?Service=WMTS&Request=GetCapabilities`
- GetCapabilities WMS: `https://mapy.geoportal.gov.pl/wss/service/PZGIK/ORTO/WMS/HighResolution?Service=WMS&Request=GetCapabilities`
---
### 🌍 Google Satellite
**Status:** ✅ Working
**Type:** XYZ Tiles
**URL:** `http://mt1.google.com/vt/lyrs=s&hl=pl&x={x}&y={y}&z={z}`
**Implementation Notes:**
- Google sat - ok (20)
---
### 🌍 Google Hybrid
**Status:** ✅ Working
**Type:** XYZ Tiles
**URL:** `http://mt1.google.com/vt/lyrs=y&hl=pl&x={x}&y={y}&z={z}`
**Implementation Notes:**
- Google hyb - ok (20)
---
### Satellite (Esri)
**Status:** ✅ Working
**Type:** XYZ Tiles
**Service:** ArcGIS Online World Imagery
**URL:** `https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}`
**Implementation Notes:**
- Esri - ok (20)
---
### Topographic
**Status:** ✅ Working
**Type:** XYZ Tiles
**Service:** CARTO Voyager
**URL:** `https://{s}.basemaps.cartocdn.com/rastertiles/voyager/{z}/{x}/{y}{r}.png`
**Implementation Notes:**
- Topo - ok (20)
---
## Overlay Layers - Polish Government
### 📋 Polish Cadastral Data (Działki) - Server 1
**Status:** - VERY SLOW
**Type:** WMS 1.3.0
**Service:** GUGiK - Krajowa Integracja Ewidencji Gruntów
**URL:** `https://integracja01.gugik.gov.pl/cgi-bin/KrajowaIntegracjaEwidencjiGruntow`
**Opacity:** 0.8
**Layers:** `powiaty,powiaty_obreby,zsin,obreby,dzialki,geoportal,numery_dzialek,budynki`
**Implementation Notes:**
- Polish cadastral data server 1 - very slow, works only up to zoom 18
**Official Documentation:**
- GetCapabilities: `https://integracja01.gugik.gov.pl/cgi-bin/KrajowaIntegracjaEwidencjiGruntow?Service=WMS&Request=GetCapabilities`
---
### 📋 Polish Cadastral Data (Działki) - Server 2
**Status:** - VERY SLOW
**Type:** WMS 1.3.0
**Service:** GUGiK - Krajowa Integracja Ewidencji Gruntów
**URL:** `https://integracja.gugik.gov.pl/cgi-bin/KrajowaIntegracjaEwidencjiGruntow`
**Opacity:** 0.8
**Layers:** `dzialki,obreby,numery_dzialek,budynki,kontury,uzytki`
**Implementation Notes:**
- Polish cadastral data server 2 - very slow, works only up to zoom 18 (this is the current official one afaik)
**Official Documentation:**
- GetCapabilities: `https://integracja.gugik.gov.pl/cgi-bin/KrajowaIntegracjaEwidencjiGruntow?Service=WMS&Request=GetCapabilities`
---
### 🏗️ Polish Spatial Planning
**Status:** Not Working
**Type:** WMS 1.3.0
**Service:** Geoportal - Krajowa Integracja Miejscowych Planów Zagospodarowania Przestrzennego
**URL:** `https://mapy.geoportal.gov.pl/wss/ext/KrajowaIntegracjaMiejscowychPlanowZagospodarowaniaPrzestrzennego`
**Opacity:** 0.7
**Layers:** `raster,wektor-str,wektor-lzb,wektor-pow,wektor-lin,wektor-pkt,granice`
**Implementation Notes:**
- doesnt seem to work, or is extremely slow
**Official Documentation:**
- GetCapabilities: `https://mapy.geoportal.gov.pl/wss/ext/KrajowaIntegracjaMiejscowychPlanowZagospodarowaniaPrzestrzennego?Service=WMS&Request=GetCapabilities`
-
---
## Overlay Layers - Utility
### 🌍 Google Roads
**Status:** ✅ Working
**Type:** XYZ Tiles Overlay
**URL:** `http://mt1.google.com/vt/lyrs=h&hl=pl&x={x}&y={y}&z={z}`
**Opacity:** 1.0
**Implementation Notes:**
- Ok
---
## Technical Notes
### Coordinate Reference Systems
- **EPSG:3857** - Web Mercator (current implementation for all layers)
- **EPSG:2180** - Polish national projection (PUWG 1992)
- Some Polish services support this natively
- Would require proj4leaflet for proper support
### WMS Version Differences
- **WMS 1.1.1:** Uses `SRS` parameter for coordinate system
- **WMS 1.3.0:** Uses `CRS` parameter for coordinate system
- Current implementation auto-detects and handles both
### Performance Considerations
-
### Known Issues
-
---
## Future Enhancements
### Planned
- [ ] Dynamic opacity controls
- [ ] Layer legends/metadata panels
- [ ] EPSG:2180 support via proj4leaflet
- [ ] Layer error handling with fallbacks
- [ ] Mobile-optimized layer control
### Ideas
-
---
## References & Resources
### Polish Geoportal
- Main portal: https://www.geoportal.gov.pl/
- Service catalog: https://www.geoportal.gov.pl/uslugi
-
### GUGiK (Główny Urząd Geodezji i Kartografii)
- Main website: https://www.gugik.gov.pl/
-
### LP-Portal
- Website: https://lp-portal.pl/
-
### Leaflet Documentation
- WMS Layers: https://leafletjs.com/reference.html#tilelayer-wms
-
---
## Changelog
### 2026-01-16
- Created LAYER_NOTES.md for documentation and personal notes
- Initial structure with all current layers documented