GisBR
Plugin QGIS que traz os dados espaciais oficiais do Brasil direto para a Caixa de Ferramentas de Processamento.
O Problema
Quem trabalha com análise espacial no Brasil conhece a rotina: para montar um mapa municipal, é preciso navegar pelo FTP do IBGE, localizar a malha do ano correto, baixar o arquivo compactado, extrair e só então carregar no QGIS. O pacote geobr, do IPEA, resolveu essa etapa de forma elegante para quem programa em R ou Python — uma função retorna a camada pronta —, mas deixou de fora a maior parte dos profissionais de geoprocessamento, que trabalham direto no QGIS e não escrevem código.
O mesmo vale para o diagnóstico de um município na elaboração de um Plano Diretor: reunir as bases oficiais de transporte, saneamento, demografia e meio ambiente significa consultar manualmente dezenas de servidores WFS, ArcGIS REST e portais de download diferentes, cada um com seu próprio formato e sistema de referência.
A Solução — Evolução do Projeto
Aprovação no repositório oficial de complementos do QGIS. Cada geografia do geobr vira um algoritmo de Processing: 55 ao todo, cobrindo divisão administrativa, censo, áreas urbanas e metropolitanas, meio ambiente e temas setoriais como saúde e educação, além do algoritmo join_censo, que cruza setores censitários com as tabelas demográficas do censobr. Decisão de projeto: zero dependências externas, só a API nativa do QGIS/Qt e a biblioteca padrão do Python.
Download da rede viária de qualquer município direto do OpenStreetMap via API Overpass, estruturada como links e nós com topologia mínima — a mesma lógica do osm2gmns, do professor Xuesong Zhou (Arizona State University), aplicada dentro do QGIS. Corrigido também um timeout que nunca era aplicado às consultas Overpass. Primeira versão publicada sem o rótulo "experimental".
Declaração explícita de suporte ao QGIS 4.x e correção de um bug de escopo de enum no PyQt6 que derrubava o catálogo de municípios e a checagem de erros do Overpass.
O suporte a certificados SSL, até então restrito ao downloader do IPEA, passou para um módulo único (core/ssl_support.py) e se estendeu a todos os conectores do plugin — WFS, ArcGIS REST, Overpass e o basemap de satélite —, resolvendo falhas de cadeia de certificado em instalações novas de Windows/OSGeo4W ao consultar fontes como SICAR, ANA/SNIRH, INDE, SGB e IBAMA.
O catálogo de fontes do diagnóstico ganhou seis novas bases públicas: risco geológico (SGB/CPRM), processos minerários (SIGMINE), poços de água subterrânea (SIAGAS), as camadas BC250 e de áreas urbanizadas do IBGE, e o conjunto BDIA de solo, geologia e vegetação (v0.5.0). A versão seguinte adicionou o conector do SIGEF, que lê parcelas certificadas do INCRA a partir de um arquivo baixado manualmente, já que o serviço exige login gov.br (v0.6.0).
A v0.7.0 trouxe um motor de POIs do OpenStreetMap, que baixa edifícios, comércios e pontos como estações para o eixo urbano, além do algoritmo de exportação para o formato GMNS usado em modelos de demanda. A v0.8.0 passou a permitir anexar as tabelas do Censo via censobr direto à camada de setores censitários do diagnóstico.
Nono eixo do diagnóstico, "Agricultura e Pecuária", com uso e cobertura da terra do MapBiomas e dados agropecuários do IBGE (PAM e Censo Agropecuário 2017).
A rede viária foi refeita a partir da topologia real do OpenStreetMap: as vias são quebradas em arcos nos nós compartilhados, e as redes veicular e pedonal passaram a ser geradas separadamente. Uma nova camada reúne os problemas de conectividade (ilhas, pontas soltas, armadilhas de mão única) classificados por severidade, substituindo a topologia mínima da v0.3.2, que perdia os cruzamentos no meio de uma via.
Primeiro lançamento 1.0: o diagnóstico ganhou um modo Região Metropolitana, que roda sobre o conjunto de municípios de uma RM em vez de um único município, cobrindo as 84 regiões metropolitanas do catálogo do IBGE.
Funcionalidades Principais
57 algoritmos de Processing: cada geografia oficial (país, estados, municípios, setores censitários, biomas, unidades de conservação, terras indígenas, favelas, locais de votação e mais) vira um algoritmo com parâmetros de ano, filtro por UF ou código IBGE e opção de geometria simplificada.
Diagnóstico de Plano Diretor: reúne 54 fontes oficiais organizadas em 9 eixos, já recortadas pelo polígono do município, em um único GeoPackage.
Modo Região Metropolitana: roda o mesmo diagnóstico sobre o conjunto de municípios de uma região metropolitana, cobrindo as 84 RMs do catálogo do IBGE.
Malha viária do OpenStreetMap: download das vias de qualquer município via Overpass, montada a partir da topologia real do OSM, com as vias quebradas em arcos nos nós compartilhados. As redes veicular e pedonal são geradas separadamente, e uma camada própria reúne os problemas de conectividade (ilhas, pontas soltas, armadilhas de mão única) com severidade, em SIRGAS 2000 (EPSG:4674).
Cache local com espelho no GitHub: downloads ficam em cache em disco; se o servidor do IPEA estiver fora do ar, o plugin busca os mesmos arquivos em um espelho no GitHub, sem interromper o fluxo de trabalho.
Certificados SSL embarcados: reconhece as cadeias de confiança de IPEA, SICAR, ANA/SNIRH, INDE, SGB, IBAMA, Overpass e o basemap de satélite, resolvendo falhas de instalações novas de Windows sem relaxar nenhuma verificação de segurança.
Zero dependências externas: funciona apenas com a API nativa do QGIS/Qt e a biblioteca padrão do Python — sem geopandas, pandas ou requests, o que evita conflitos com outros plugins e barreiras de instalação para usuários menos técnicos.
Stack Tecnológica
Python PyQGIS QGIS Processing Framework Overpass API GeoPackage / SQLite Parquet / GDAL
Impacto
O GisBR elimina a etapa manual de busca, download e conversão de dados oficiais para quem trabalha em QGIS, cobrindo dezenas de geografias administrativas, censitárias, ambientais e setoriais, além da malha viária do OpenStreetMap — tudo sem exigir conhecimento de programação. O plugin também faz o diagnóstico municipal para a elaboração e revisão de Planos Diretores, individualmente ou por região metropolitana, e reúne as bases oficiais já recortadas pelo polígono do território em um único GeoPackage.