Integración con QGIS

Mapalyze soporta dos caminos de integración con QGIS:

1. OGC API - Features (recomendado, lectura/escritura)
2. PostGIS Directo (solo lectura para análisis)

---

Opción 1: OGC API - Features (recomendado)

Use esto para edición operativa desde QGIS (crear/actualizar/eliminar).

Requisitos

• QGIS 3.40.4+
• Clave API con alcance read-write o admin
• URL del endpoint OGC: https://<ref>.supabase.co/functions/v1/api-gateway/oapif

Configuración de autenticación en QGIS

1. QGIS -> Settings > Options > Authentication
2. Añadir nueva configuración:
   • Tipo: API Header
   • Header: X-API-Key
   • Valor: mk_live_... (o mk_test_... en sandbox)

Añadir conexión OGC

1. Layer > Add Layer > Add WFS / OGC API - Features Layer
2. Crear conexión:
   • URL: https://<ref>.supabase.co/functions/v1/api-gateway/oapif
   • Autenticación: seleccionar la configuración anterior
   • Habilitar paginación: activado
3. Conectar y añadir capas.

Parámetros de consulta útiles

Parámetro	Ejemplo	Descripción
limit	200	Features por página
offset	0	Paginación por offset
bbox	-7,37,-6,38	Filtro espacial
datetime	2026-01-01T00:00:00Z/..	Filtro por fecha de actualización
project_id	uuid	Filtro por proyecto
f	geojson	Formato de salida (json o geojson)

---

Opción 2: PostGIS Directo (solo lectura)

Use esto para SQL espacial avanzado en PostGIS.

Requisitos

• QGIS 3.x
• Credenciales de conexión directa a BD
• Clave API Live (mk_live_...) con alcance de lectura (read-only, read-write o admin)

Configuración de sesión (requerida)

Después de conectar, ejecute:

SELECT qgis.setup_session('mk_live_your_key_here');

Esto valida la clave y limita los datos a su organización.

Importante:

• qgis.setup_session requiere claves live.
• Las claves de prueba (mk_test_...) son rechazadas para la configuración de sesión QGIS en producción.

Vistas disponibles (esquema qgis)

Capa	Descripción
qgis.records	Registros espaciales
qgis.records_all	Todos los registros (incluyendo no espaciales)
qgis.forms	Metadatos de formularios
qgis.projects	Metadatos de proyectos

---

Solución de problemas

Capas vacías / sin features

• Confirme que los registros realmente tienen geometría.
• Confirme que el formulario tiene una versión publicada.
• Confirme que la clave tiene alcance de lectura y pertenece a la organización correcta.

Permiso denegado en ediciones (OGC)

• Use una clave read-write o admin.

QGIS access requires a live API key

• Use una clave mk_live_... para qgis.setup_session(...).

URL OGC inválida

• La URL debe terminar con /oapif.