Intégration QGIS

Mapalyze supporte deux chemins d'intégration QGIS :

1. OGC API - Features (recommandé, lecture/écriture)
2. PostGIS Direct (lecture seule pour l'analyse)

---

Option 1 : OGC API - Features (recommandé)

Utilisez ceci pour l'édition opérationnelle depuis QGIS (créer/modifier/supprimer).

Prérequis

• QGIS 3.40.4+
• Clé API avec portée read-write ou admin
• URL de l'endpoint OGC : https://<ref>.supabase.co/functions/v1/api-gateway/oapif

Configuration d'authentification dans QGIS

1. QGIS -> Settings > Options > Authentication
2. Ajouter une nouvelle configuration :
   • Type : API Header
   • Header : X-API-Key
   • Valeur : mk_live_... (ou mk_test_... en sandbox)

Ajouter une connexion OGC

1. Layer > Add Layer > Add WFS / OGC API - Features Layer
2. Créer une connexion :
   • URL : https://<ref>.supabase.co/functions/v1/api-gateway/oapif
   • Authentification : sélectionner la configuration ci-dessus
   • Activer la pagination : activé
3. Se connecter et ajouter les couches.

Paramètres de requête utiles

Paramètre	Exemple	Description
limit	200	Features par page
offset	0	Pagination par offset
bbox	-7,37,-6,38	Filtre spatial
datetime	2026-01-01T00:00:00Z/..	Filtre par date de mise à jour
project_id	uuid	Filtre par projet
f	geojson	Format de sortie (json ou geojson)

---

Option 2 : PostGIS Direct (lecture seule)

Utilisez ceci pour du SQL spatial avancé dans PostGIS.

Prérequis

• QGIS 3.x
• Identifiants de connexion directe à la BD
• Clé API Live (mk_live_...) avec portée de lecture (read-only, read-write ou admin)

Configuration de session (requise)

Après connexion, exécutez :

SELECT qgis.setup_session('mk_live_your_key_here');

Cela valide la clé et limite les données à votre organisation.

Important :

• qgis.setup_session nécessite des clés live.
• Les clés de test (mk_test_...) sont rejetées pour la configuration de session QGIS en production.

Vues disponibles (schéma qgis)

Couche	Description
qgis.records	Enregistrements spatiaux
qgis.records_all	Tous les enregistrements (y compris non spatiaux)
qgis.forms	Métadonnées des formulaires
qgis.projects	Métadonnées des projets

---

Dépannage

Couches vides / pas de features

• Confirmez que les enregistrements ont bien une géométrie.
• Confirmez que le formulaire a une version publiée.
• Confirmez que la clé a la portée de lecture et appartient à la bonne organisation.

Permission refusée sur les éditions (OGC)

• Utilisez une clé read-write ou admin.

QGIS access requires a live API key

• Utilisez une clé mk_live_... pour qgis.setup_session(...).

URL OGC invalide

• L'URL doit se terminer par /oapif.