Integração com QGIS

O Mapalyze suporta dois caminhos de integração QGIS:

1. OGC API - Features (recomendado, leitura/escrita)
2. PostGIS Direto (somente leitura para análise)

---

Opção 1: OGC API - Features (recomendado)

Use isso para edição operacional a partir do QGIS (criar/atualizar/excluir).

Requisitos

• QGIS 3.40.4+
• Chave API com escopo read-write ou admin
• URL do endpoint OGC: https://<ref>.supabase.co/functions/v1/api-gateway/oapif

Configuração de autenticação no QGIS

1. QGIS -> Settings > Options > Authentication
2. Adicionar nova configuração:
   • Tipo: API Header
   • Header: X-API-Key
   • Valor: mk_live_... (ou mk_test_... em sandbox)

Adicionar conexão OGC

1. Layer > Add Layer > Add WFS / OGC API - Features Layer
2. Criar conexão:
   • URL: https://<ref>.supabase.co/functions/v1/api-gateway/oapif
   • Autenticação: selecionar a configuração acima
   • Habilitar paginação: ativado
3. Conectar e adicionar camadas.

Parâmetros de consulta úteis

Parâmetro	Exemplo	Descrição
limit	200	Features por página
offset	0	Paginação por offset
bbox	-7,37,-6,38	Filtro espacial
datetime	2026-01-01T00:00:00Z/..	Filtro por data de atualização
project_id	uuid	Filtro por projeto
f	geojson	Formato de saída (json ou geojson)

---

Opção 2: PostGIS Direto (somente leitura)

Use isso para SQL espacial avançado no PostGIS.

Requisitos

• QGIS 3.x
• Credenciais de conexão direta ao BD
• Chave API Live (mk_live_...) com escopo de leitura (read-only, read-write ou admin)

Configuração de sessão (obrigatória)

Após conectar, execute:

SELECT qgis.setup_session('mk_live_your_key_here');

Isso valida a chave e limita os dados à sua organização.

Importante:

• qgis.setup_session requer chaves live.
• Chaves de teste (mk_test_...) são rejeitadas para configuração de sessão QGIS em produção.

Views disponíveis (schema qgis)

Camada	Descrição
qgis.records	Registros espaciais
qgis.records_all	Todos os registros (incluindo não espaciais)
qgis.forms	Metadados de formulários
qgis.projects	Metadados de projetos

---

Solução de problemas

Camadas vazias / sem features

• Confirme que os registros realmente têm geometria.
• Confirme que o formulário tem uma versão publicada.
• Confirme que a chave tem escopo de leitura e pertence à organização correta.

Permissão negada em edições (OGC)

• Use uma chave read-write ou admin.

QGIS access requires a live API key

• Use uma chave mk_live_... para qgis.setup_session(...).

URL OGC inválida

• A URL deve terminar com /oapif.