docs: Create LAYER_NOTES.md for map layers documentation and implementation notes
This commit is contained in:
222
docs/LAYER_NOTES.md
Normal file
222
docs/LAYER_NOTES.md
Normal file
@@ -0,0 +1,222 @@
|
|||||||
|
# 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
|
||||||
Reference in New Issue
Block a user