Tutorial: Automação de Mapas de Localização no QGIS

Tutorial completo para criar mapas de localização padronizados automaticamente usando Python no QGIS.

Sobre o Projeto

Este repositório contém um tutorial completo para automatizar a criação de mapas de localização no QGIS usando scripts Python (PyQGIS). O fluxo de trabalho gera mapas padronizados com três níveis de recorte geográfico: nacional (América do Sul), estadual (UF) e municipal.

Características Principais

• Automação Completa: Script Python (Setup_Mapas_Municipais.py) para configuração automática de camadas
• Interface Intuitiva: Diálogos guiados para seleção de arquivos e municípios
• Padronização Visual: Layout template (.qpt) para mapas uniformes
• Variáveis de Projeto: Sistema parametrizado para títulos e escalas
• Exportação Flexível: Suporta PDF, PNG e JPG

Acesso ao Tutorial

Tutorial Online: samuelsantos.site/pyqgis-location-map-tutorial

Documentação Técnica: Documentação para Desenvolvedores - Entenda a arquitetura e lógica do código

Arquivos do Repositório

• index.html: Site do tutorial com passo a passo detalhado
• Setup_Mapas_Municipais.py: Script principal de automação
• dados/: Diretório para arquivos Shapefile (não incluídos no repositório)
• demo/: Exemplos de mapas gerados
• img/: Screenshots do tutorial passo a passo

Dados Necessários

Os arquivos de dados geográficos (Shapefiles) não estão incluídos neste repositório devido ao tamanho. Faça o download através do Google Drive:

Download de Dados: Google Drive

Arquivos necessários:

• América do Sul (Shapefile)
• Estados/UFs do Brasil (Shapefile)
• Municípios do Brasil (Shapefile)
• Hidrografia (Shapefile)
• Logo da instituição (PNG, JPG ou SVG)

Requisitos

• QGIS versão 3.x
• Conhecimentos básicos de QGIS
• Arquivos Shapefile (disponíveis no link acima)

Exemplos de Resultados

A pasta demo/ contém exemplos de mapas gerados automaticamente pelo script:

• Mapa de localização - Paragominas.png
• Mapa de localização - Bragança.png
• Mapa de localização - Monte Alegre.png

Tecnologias Utilizadas

• QGIS 3.x: Software de SIG open source
• PyQGIS: API Python para automação no QGIS
• Python: Linguagem de script
• HTML/CSS: Interface do tutorial online

Estrutura do Projeto

pyqgis-location-map-tutorial/
├── index.html                      # Tutorial online
├── Setup_Mapas_Municipais.py      # Script de automação
├── README.md                       # Este arquivo
├── LICENSE                         # Licença MIT
├── sitemap.xml                     # Sitemap para SEO
├── dados/                          # Shapefiles (não incluídos)
├── demo/                           # Mapas de exemplo
└── img/                            # Screenshots do tutorial

Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para:

• Reportar bugs via Issues
• Sugerir melhorias
• Enviar pull requests
• Compartilhar seus mapas criados com este tutorial

Licença

Este projeto está sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.

Contato

Samuel Santos

• Email: samuelsantosambiental@gmail.com
• LinkedIn: samuel-c-santos
• GitHub: @samuel-c-santos
• Portfólio: samuelsantos.site

Galeria de Exemplos

Exemplos de mapas gerados automaticamente pelo script:

Anapu, PA	Bragança, PA
Monte Alegre, PA	Paragominas, PA

---

Desenvolvido por Samuel Santos | Janeiro 2026