5.8 KiB
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
SRSparameter for coordinate system - WMS 1.3.0: Uses
CRSparameter 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
Changelog
2026-01-16
- Created LAYER_NOTES.md for documentation and personal notes
- Initial structure with all current layers documented