Publicar mapas na internet com o plugin qgis2web

Alexandre Marques
Editado em nov 2026

Este tutorial ensina, passo a passo, a publicar mapas e camadas do QGIS na internet com o plugin qgis2web, usando como exemplo um mapa do semiárido brasileiro.

Você pode ver o tutorial na íntegra pelo vídeo em nosso canal no Youtube:

Publicando mapas com o plugin qgis2web

O plugin qgis2web publica mapas ou camadas do QGIS na internet, gerando uma página web com visualização interativa: título, descrição, legenda que pode ser mostrada ou ocultada, camadas que podem ser marcadas ou desmarcadas, zoom e janelas de informação (popups) ao clicar nas feições.

Ao final, você terá uma pasta com um arquivo index (página HTML) e as pastas de apoio, que pode ser aberta no navegador, colocada em um site ou enviada para outra pessoa.

Ambiente utilizado

  • QGIS 3.44″.
  • Plugin qgis2web, versão 4.4.0.
  • Camadas do exemplo: BR_UF_2022 (estados), Contorno_semiarido_IBGE_2022 (semiárido) e ESRI Topo (camada base).
  • Exportação para a pasta Downloads, com a biblioteca OpenLayers.

1. Exemplo de mapa publicado com o qgis2web

Um exemplo de mapa publicado com o qgis2web é o “Biomas brasileiros”, elaborado no curso de Mapas Temáticos com QGIS da Geoaplicada. Ele mostra:

Mapa Biomas brasileiros publicado com o qgis2web

Mapa “Biomas brasileiros” publicado com o qgis2web: título à esquerda e legenda à direita.

Descrição do mapa e legenda com as camadas Unidades da Federação

Descrição do mapa e legenda com as camadas Unidades da Federação (IBGE, 2023), Biomas (IBGE/MMA, 2019), Países da América do Sul (IBGE, 2023) e ESRI Topo.

Além das camadas do QGIS, o qgis2web permite incluir na tabela de atributos informações extras que aparecem ao clicar na feição: imagem ou figura, vídeo, links e arquivos PDF. Ao clicar, também aparecem as informações das camadas presentes no ponto (no exemplo: América do Sul, Brasil e os biomas).

Popup ao clicar em um bioma

A inclusão de imagem, vídeo, link e PDF nos popups não é detalhada neste tutorial.

2. Preparar o projeto: renomear as camadas

O exemplo usa três camadas: a camada base, uma camada dos estados do Brasil e uma camada do semiárido.

Por que renomear: o nome da camada no painel Camadas é o nome que aparecerá no mapa publicado. Para que ele saia do jeito que você quer, renomeie as camadas antes de exportar.

Os nomes podem ser editados diretamente no painel Camadas:

  1. Contorno_semiarido_IBGE_2022 passa a se chamar Semiárido (o semiárido brasileiro, divisão da Sudene/IBGE).
  2. BR_UF_2022 passa a se chamar Estados brasileiros.
  3. ESRI Topo (camada base) permanece com o mesmo nome.
Painel Camadas antes da alteração

Painel Camadas antes da alteração: BR_UF_2022, Contorno_semiarido_IBGE_2022 e ESRI Topo.

Camadas renomeadas Estados brasileiros, Semiárido e ESRI Topo

Camadas renomeadas: Estados brasileiros, Semiárido e ESRI Topo.

3. Instalar o plugin qgis2web no QGIS

  1. No menu Complementos, clique em Gerenciar e Instalar Complementos….
  2. Na janela de complementos, pesquise por qgis2web.
  3. Selecione o qgis2web e clique em Instalar complemento.
  4. Clique em Fechar.
Menu Complementos  Gerenciar e Instalar Complementos

Se o plugin já estiver instalado, aparece a opção Reinstalar Complemento no lugar de Instalar complemento.

Plugin qgis2web selecionado

4. Abrir o plugin qgis2web

Procure o plugin na barra de ferramentas: ele é representado por um ícone próprio. Ao passar o mouse sobre ele, aparece a dica Create web map. Clique no ícone para abrir a janela Export to web map.

Ícone do qgis2web na barra de ferramentas

5. As abas do plugin qgis2web e a aba Layers and Groups

A janela do plugin tem três abas principais:

  • Layers and Groups (camadas);
  • Appearance (aparência);
  • Export (exportar).

Na janela também aparecem as abas Settings e WIKI, que não são usadas neste tutorial.

Na aba Layers and Groups você vê quais camadas ficarão visíveis quando o mapa for exportado para a internet. Para cada camada há a opção de deixá-la visível ou não (Visible) e de exportá-la ou não (caixa de seleção ao lado do nome da camada).

Também é possível ver, para cada camada, a opção Popups e a lista Popup fields com os campos da tabela de atributos (para Estados brasileiros: CD_UF, NM_UF, SIGLA_UF, NM_REGIAO e AREA_KM2; para Semiárido: Nome). Esses campos aparecem no popup do mapa final (ver passo 9). Na parte inferior ficam a escolha entre OpenLayers e Leaflet e os botões Update preview e Export.

Aba Layers and Groups da janela Export to web map do qgis2web

6. Definir título e resumo nas propriedades do projeto

Na aba Appearance há a opção de incluir título, resumo, legenda e outras informações. Porém, o título (e o resumo) precisam ser definidos nas propriedades do projeto:

  1. No menu Projeto, clique em Propriedades… (atalho exibido no menu: Ctrl+Shift+P).
  2. Na lista à esquerda, abra Metadados (aba Identificação).
  3. No campo Título, digite o título do mapa.
  4. No campo Resumo, digite as informações complementares, por exemplo a fonte dos dados — e o que mais você quiser.
 Menu Projeto  > Propriedades...

No exemplo, o título é Semiárido brasileiro e a fonte vai para o Resumo: Fonte: IBGE/SUDENE, 2022. Esses textos aparecerão no mapa publicado.

Também é possível colocar a fonte no próprio título, como em “Semiárido brasileiro (SUDENE/IBGE, 2022)”; no exemplo, optou-se por um título mais simples.

Título final Semiárido brasileiro e Resumo Fonte IBGE - SUDENE, 2022

A janela de propriedades tem os botões OK, Cancelar, Aplicar e Ajuda. Em seguida, volte à janela do plugin.

7. Configurar a aba Appearance

Na aba Appearance, configure os seguintes campos:

CampoOpções disponíveisEscolha no exemplo
Title (título)—upper left (superior esquerdo)
Layers list (legenda)None, Collapsed, Expandedlegenda visível e expandida (Expanded)
Abstract (resumo)None, upper right, lower right, lower left, upper leftupper right (em cima, à direita)
Extent (extensão)Canvas extent, Fit to vector layers extentCanvas extent
Title em upper left e opções de Layers list no qgis2web

Title em “upper left” e opções de Layers list (None, Collapsed, Expanded).

Opções de posição para Abstract; no exemplo, upper right, no qgis2web

Opções de posição para Abstract; no exemplo, “upper right”.

Em Extent, é possível escolher mostrar toda a área de extensão ou mostrar só a área onde está o arquivo vetorial. No exemplo, fica selecionado Canvas extent.

Opções de Extent na seção ScaleZoom, no qgis2web

A aba também exibe outros campos (como Geolocate user, Measure tool, Address search, Layer search, Template e Max/Min zoom level), que não são usados neste tutorial.

8. Exportar o mapa

  1. Abra a aba Export.
  2. Em Exporter, escolha o destino. As opções são Export to folder (exportar para uma pasta, que depois você pode colocar em um site ou enviar para alguém) e Export to SFTP site (exportar direto para um servidor). No exemplo é usado Export to folder.
  3. Clique no botão de três pontos (…) ao lado do Exporter e escolha a pasta na janela Choose export folder (botão Selecionar pasta). No exemplo, a pasta escolhida é Downloads.
  4. Na parte inferior da janela, escolha a biblioteca para visualizar os mapas. No exemplo é escolhida OpenLayers (a outra opção é Leaflet).
  5. Clique em Export.

Na aba Export também aparecem os campos Minify GeoJSON files (marcado) e Precision (maintain), que não foram alterados no exemplo.

Aba Export opções do Exporter (Export to folder e Export to SFTP site)

Aba Export: opções do Exporter (Export to folder e Export to SFTP site).

Janela Choose export folder com a pasta Downloads selecionada

Janela “Choose export folder” com a pasta Downloads selecionada.

OpenLayers selecionado e botão Export na parte inferior da janela

OpenLayers selecionado e botão Export na parte inferior da janela.

Janela Progress durante a exportação no qgis2web

Janela Progress durante a exportação: “Creating OpenLayers map…”, exportação das bibliotecas e camadas.

9. Conferir o resultado

Concluída a exportação, abra no navegador o arquivo index gerado (ver passo 10). No exemplo, o resultado mostra:

  • o título Semiárido brasileiro no canto superior esquerdo;
  • a fonte (Fonte: IBGE/SUDENE, 2022.) no canto superior direito;
  • a legenda com as camadas Estados brasileiros, Semiárido e ESRI Topo, que podem ser ocultadas ou não;
  • ao clicar sobre o mapa, um popup com as informações das camadas: em Estados brasileiros, os dados inseridos de código, nome do estado, sigla, região e área (no exemplo, Bahia: 29, Bahia, BA, Nordeste, 564.760,429); em Semiárido, “Limite do Semiárido em 2022”.
Mapa exportado aberto no navegador, com título, fonte, legenda e popup de Estados brasileiros e Semiárido

Mapa exportado aberto no navegador, com título, fonte, legenda e popup de Estados brasileiros e Semiárido.

Também é possível fazer outras configurações, como incluir imagem, PDF e vídeo nos popups (conteúdo ensinado no curso da Geoaplicada).

10. Os arquivos gerados

O mapa fica salvo no computador. Na pasta escolhida é criada uma pasta com o nome iniciado por qgis2web_ seguido de data e hora — no exemplo, qgis2web_2026_11_15-16_08_26_141287. Dentro dela estão:

  • o arquivo index — é a página do mapa, que abre no navegador;
  • o arquivo README;
  • as pastas layers, styles, images, webfonts e resources.
Conteúdo da pasta gerada pelo qgis2web em Downloads

Conteúdo da pasta gerada pelo qgis2web em Downloads.

11. Publicar na internet

Para compartilhar o mapa com outras pessoas pela internet, os arquivos podem ser colocados em serviços como o GitHub Pages ou o Netlify.

Você pode subir os arquivos para uma hospedagem compartilhada também com Hotsgator, Hostinger, etc.

Não esqueça de salvar o projeto do QGIS no seu computador.

Curso Mapas Temáticos com QGIS

A Geoaplicada oferece o curso Mapas Temáticos com QGIS, com 21 módulos e bônus como “publicando mapas na internet”, que aborda também a inclusão de imagem, vídeo, link e PDF nos popups e a publicação em serviços como GitHub Pages e Netlify.

Alexandre Marques

Graduado em Análise e Desenvolvimento de Sistemas e Coautor da Geoaplicada.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *