Files
panel/docs/LAYER_NOTES.md

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 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

GUGiK (Główny Urząd Geodezji i Kartografii)

LP-Portal

Leaflet Documentation


Changelog

2026-01-16

  • Created LAYER_NOTES.md for documentation and personal notes
  • Initial structure with all current layers documented