O Que Sao Variaveis no QGIS
Variaveis no QGIS sao valores identificados pelo prefixo@ que retornam informacoes contextuais automaticamente. Elas existem em diferentes niveis:– Globais — informacoes do sistema (versao do QGIS, sistema operacional)
– Projeto — titulo, caminho do arquivo, SRC do projeto
– Camada — nome, contagem de feicoes, extensao
– Mapa — escala, extensao visivel, centro do mapa
– Atlas — feicao atual, numero da pagina, total de paginas
– Personalizadas — valores que voce mesmo defineVoce pode usar variaveis em qualquer lugar que aceite expressoes: rotulos, simbologia, calculadora de campo e compositor de impressao.Onde Consultar as Variaveis Disponiveis
Para ver todas as variaveis ativas no seu projeto:– Abra o construtor de expressoes (clique no epsilon em qualquer campo) – Na lista de funcoes, expanda o grupo Variaveis – Cada variavel mostra seu valor atual na pre-visualizacaoVoce tambem pode acessar pelo menu Configuracoes, Opcoes, aba Variaveis para ver e criar variaveis globais e de projeto.Consulte a documentacao oficial do QGIS para a lista completa.
12 Variaveis Mais Uteis no QGIS
As que voce mais vai usar no dia a dia.Variaveis de Projeto
@project_title — titulo do projeto definido em Propriedades do Projeto. Use em caixas de texto do compositor para gerar cabecalhos automaticos.@project_crs — codigo EPSG do SRC do projeto (ex: EPSG:31983). Exiba no layout para documentar o sistema de referencia.@project_folder — caminho da pasta do projeto. Util para logs e automacoes.Variaveis de Mapa
@map_scale — escala atual do mapa. Essencial para exibir a escala numerica no compositor de impressao.@map_extent — extensao visivel como geometria retangular. Use para filtrar feicoes visiveis na tela.@map_crs — SRC do item mapa no compositor, que pode diferir do projeto.Variaveis do Atlas
@atlas_feature — geometria da feicao atual do Atlas. Fundamental para criar layouts que se adaptam a cada feicao automaticamente.@atlas_featureid — ID da feicao atual. Use para numerar paginas ou criar codigos sequenciais.@atlas_totalfeatures — total de feicoes no Atlas. Exiba como “Pagina X de Y” no layout.Variaveis de Camada
@layer_name — nome da camada ativa. Util em expressoes genericas que funcionam em qualquer camada.@layer_id — identificador unico da camada. Estavel mesmo que o nome mude.Variaveis de Geometria
@geometry — geometria da feicao atual. Atalho para $geometry dentro de expressoes contextuais.
Como Criar Variaveis Personalizadas
Voce pode criar suas proprias variaveis em tres niveis:– Global — Configuracoes, Opcoes, aba Variaveis. Disponivel em todos os projetos. – Projeto — Projeto, Propriedades, aba Variaveis. Salva junto com o projeto. – Camada — Propriedades da Camada, aba Variaveis. Especifica de uma camada.Exemplo pratico: crie uma variavel de projeto chamadaresponsavel_tecnico com o nome do profissional. Use @responsavel_tecnico em todos os layouts para preencher o campo automaticamente.Variaveis no Compositor de Impressao
O principal uso de variaveis e no compositor de impressao para criar layouts dinamicos:– Titulo —[% @project_title %]
– Escala — Escala 1:[% @map_scale %]
– Data — [% format_date(now(), 'dd/MM/yyyy') %]
– SRC — [% @project_crs %]
– Paginacao Atlas — Folha [% @atlas_featureid %] de [% @atlas_totalfeatures %]Com essas insercoes, o layout se atualiza automaticamente quando voce muda o projeto, a escala ou a feicao do Atlas.Aprenda mais sobre expressoes no QGIS para combinar variaveis com funcoes. Veja tambem o compositor de impressao para aplicar variaveis nos layouts.
Perguntas Frequentes sobre Variaveis no QGIS
O que sao variaveis no QGIS?
Sao valores dinamicos identificados pelo prefixo @ que retornam informacoes do projeto, mapa, camada e Atlas automaticamente. Podem ser usadas em qualquer campo que aceite expressoes.
Como criar uma variavel personalizada no QGIS?
Va em Projeto, Propriedades, aba Variaveis e clique no botao +. Defina nome e valor. A variavel fica disponivel como @nome_da_variavel em todo o projeto.
Qual a diferenca entre @geometry e $geometry?
Funcionam de forma semelhante na maioria dos contextos. O @geometry e uma variavel de contexto, enquanto $geometry e uma funcao. Em expressoes de geometria geradora, prefira $geometry.
As variaveis personalizadas sao salvas com o projeto?
Variaveis de projeto sim. Variaveis globais ficam no perfil do usuario e estao disponiveis em qualquer projeto aberto naquela instalacao do QGIS.
Posso usar variaveis na calculadora de campo?
Sim. Qualquer variavel pode ser usada na calculadora de campo. Por exemplo, @layer_name retorna o nome da camada ativa e pode ser gravado como atributo.
Domine variaveis no QGIS e automatize seus layouts e expressoes. Conheca a Formacao GeoPro e aprenda QGIS do zero ao avancado.
Veja tambem: Expressoes no QGIS | Rotulos dinamicos | Calculadora de campo | Compositor de impressao

