# 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