QGIS-Integration

Mapalyze unterstützt zwei QGIS-Integrationswege:

1. OGC API - Features (empfohlen, Lesen/Schreiben)
2. Direkt PostGIS (nur Lesen für Analysen)

---

Option 1: OGC API - Features (empfohlen)

Verwenden Sie dies für die operative Bearbeitung aus QGIS (Erstellen/Aktualisieren/Löschen).

Voraussetzungen

• QGIS 3.40.4+
• API-Schlüssel mit Scope read-write oder admin
• OGC-Endpoint-URL: https://<ref>.supabase.co/functions/v1/api-gateway/oapif

Authentifizierungskonfiguration in QGIS

1. QGIS -> Settings > Options > Authentication
2. Neue Konfiguration hinzufügen:
   • Typ: API Header
   • Header: X-API-Key
   • Wert: mk_live_... (oder mk_test_... in Sandbox)

OGC-Verbindung hinzufügen

1. Layer > Add Layer > Add WFS / OGC API - Features Layer
2. Verbindung erstellen:
   • URL: https://<ref>.supabase.co/functions/v1/api-gateway/oapif
   • Authentifizierung: Konfiguration von oben auswählen
   • Paging aktivieren: aktiviert
3. Verbinden und Layer hinzufügen.

Nützliche Abfrageparameter

Parameter	Beispiel	Beschreibung
limit	200	Features pro Seite
offset	0	Offset-Paginierung
bbox	-7,37,-6,38	Räumlicher Filter
datetime	2026-01-01T00:00:00Z/..	Filter nach Aktualisierungsdatum
project_id	uuid	Projektfilter
f	geojson	Ausgabeformat (json oder geojson)

---

Option 2: Direkt PostGIS (nur Lesen)

Verwenden Sie dies für fortgeschrittenes räumliches SQL in PostGIS.

Voraussetzungen

• QGIS 3.x
• Direkte DB-Verbindungsdaten
• Live-API-Schlüssel (mk_live_...) mit Lese-Scope (read-only, read-write oder admin)

Session-Setup (erforderlich)

Nach dem Verbinden führen Sie aus:

SELECT qgis.setup_session('mk_live_your_key_here');

Dies validiert den Schlüssel und beschränkt die Daten auf Ihre Organisation.

Wichtig:

• qgis.setup_session erfordert live Schlüssel.
• Testschlüssel (mk_test_...) werden für das QGIS-Session-Setup in Produktion abgelehnt.

Verfügbare Views (Schema qgis)

Layer	Beschreibung
qgis.records	Räumliche Datensätze
qgis.records_all	Alle Datensätze (einschließlich nicht-räumlicher)
qgis.forms	Formular-Metadaten
qgis.projects	Projekt-Metadaten

---

Fehlerbehebung

Leere Layer / keine Features

• Bestätigen Sie, dass die Datensätze tatsächlich eine Geometrie haben.
• Bestätigen Sie, dass das Formular eine veröffentlichte Version hat.
• Bestätigen Sie, dass der Schlüssel Lese-Scope hat und zur richtigen Organisation gehört.

Berechtigung verweigert bei Bearbeitungen (OGC)

• Verwenden Sie einen read-write- oder admin-Schlüssel.

QGIS access requires a live API key

• Verwenden Sie einen mk_live_...-Schlüssel für qgis.setup_session(...).

Ungültige OGC-URL

• Die URL muss mit /oapif enden.