Desenhe um retângulo no mapa. O plugin encontra as folhas TOPODATA que o intersectam, mostra quantos arquivos e quantos megabytes serão baixados e traz os GeoTIFF originais do INPE — altitude, declividade, curvaturas, orientação, forma de terreno, relevo sombreado e divisores — sem travar o QGIS.
⬇ Instalar o plugin ★ Código no GitHub
Visão geral
O TOPODATA é o banco de dados geomorfométricos do INPE, derivado do SRTM e refinado para 1 segundo de arco (~30 m), com cobertura de todo o território brasileiro em folhas de 1° × 1,5°. Encontrar as folhas certas e baixar produto por produto é trabalhoso; o plugin faz isso a partir de uma área desenhada no mapa.
Clique e arraste no mapa, em qualquer SRC. A seleção é convertida para EPSG:4326 e cruzada com a grade local de 556 folhas.
Arquivos por produto e por folha, sem duplicatas, e o tamanho exato informado pelo servidor do INPE — ou “não disponível”, nunca um chute.
Em segundo plano, cancelável, com repetição limitada e retomada validada. Um arquivo incompleto nunca recebe o nome final.
Cada GeoTIFF vira uma camada separada no grupo TOPODATA, com cores por classe nos produtos classificados.
07S36_ZN.tif);Instalação
Nenhuma biblioteca extra: o plugin usa só o PyQGIS e a biblioteca padrão do Python que vêm com o QGIS.
data.inpe.br).Baixe o código do repositório (Code → Download ZIP ou git clone) e, na pasta dele, rode o script abaixo. Ele cria dist/topodata_downloader-0.1.0.zip.
git clone https://github.com/marcellobenigno/topodata-downloader.git
cd topodata-downloader
python scripts/make_zip.pyComplementos → Gerenciar e instalar complementos → Instalar a partir do ZIP, escolha o arquivo e confirme. Como o plugin é experimental, marque Mostrar também os complementos experimentais nas Configurações do gerenciador.
Na aba Instalados, TOPODATA Downloader deve estar marcado. O botão 
aparece na barra de complementos e em Raster → TOPODATA Downloader.
Ligue a pasta topodata_downloader/ do repositório à pasta de complementos do seu perfil; cada mudança no código vale depois de recarregar o plugin (Plugin Reloader) ou reiniciar o QGIS.
# macOS
ln -s "$PWD/topodata_downloader" \
"$HOME/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins/topodata_downloader"
# Linux
ln -s "$PWD/topodata_downloader" \
"$HOME/.local/share/QGIS/QGIS3/profiles/default/python/plugins/topodata_downloader"No Windows, a pasta é %APPDATA%\QGIS\QGIS3\profiles\default\python\plugins; copie a pasta para lá ou crie uma junção com mklink /J.
Primeiros passos
Um primeiro uso na Paraíba, entre João Pessoa e Campina Grande, com produtos pequenos (alguns MB por folha) para terminar em poucos segundos.
Clique no botão Baixar dados TOPODATA por área e clique e arraste no mapa sobre a região de interesse. Esc cancela; um clique sem arrasto é recusado com um aviso. Resultado esperado: o diálogo abre com oeste, sul, leste e norte em graus e as folhas encontradas.
Escolha a pasta de destino (ela é criada se não existir) e marque, por exemplo, Decliv. (A), Orientação — octantes e Forma de terreno. Resultado esperado: o resumo mostra os arquivos por produto e, depois de alguns segundos, o tamanho exato de cada um.
Baixar N arquivo(s) passa para a página de execução. O QGIS continua livre para uso; a tarefa também aparece na barra de status. Resultado esperado: “Concluído com sucesso” e as camadas no grupo TOPODATA.
Produtos
Cada folha tem os mesmos 16 produtos. Os numéricos (Float32) guardam o valor da variável; os classificados (Byte) guardam classes. A URL de cada produto é a da grade com o código trocado: …/07S/36_/07S36_ZN.tif → …/07S36_SA.tif.
07S36_ (0,6° × 0,4°, entre Itabaiana e Campina Grande, PB) nos 16 produtos. Classificados com as cores que o plugin aplica ao carregar; numéricos com rampas de cor escolhidas para a figura.| Rótulo | Código | Tipo | Conteúdo | Cores no QGIS | Tamanho por folha* |
|---|---|---|---|---|---|
| Altitude | ZN | numérico | MDE refinado; altitude ortométrica em m (EGM96) | cinza (padrão do QGIS) | 31–103 MB |
| Declividade | SN | numérico | declividade em % | cinza (padrão do QGIS) | 31–113 MB |
| Decliv. (A) | SA | 4 classes | Marques (1971), atualizada em Lepsch et al. (1991) | 0,4–2,1 MB | |
| Decliv. (B) | SB | 7 classes | A a G (Lepsch et al., 1991) | 0,6–3,2 MB | |
| Decliv. (C) | SC | 6 classes | EMBRAPA (1999): plano a escarpado | 0,4–2,9 MB | |
| Curv. vertical | VN | numérico | °/m; convexo (+), côncavo (−) | cinza (padrão do QGIS) | 32–118 MB |
| Curv. vertical — 3 classes | V3 | 3 classes | côncava, retilínea, convexa | 0,4–3,1 MB | |
| Curv. vertical — 5 classes | V5 | 5 classes | graus de concavidade e convexidade | 1,5–5,3 MB | |
| Curv. horizontal | HN | numérico | °/m; convergente (−), divergente (+) | cinza (padrão do QGIS) | 20–69 MB |
| Curv. horizontal — 3 classes | H3 | 3 classes | convergente, planar, divergente | 1,7–5,3 MB | |
| Curv. horizontal — 5 classes | H5 | 5 classes | graus de convergência e divergência | 1,8–5,9 MB | |
| Orientação | ON | numérico | azimute da vertente, 0° a 360° | cinza (padrão do QGIS) | 31–114 MB |
| Orientação — octantes | OC | 8 classes | N, NE, E, SE, S, SW, W, NW | 3,3–10 MB | |
| Forma de terreno | FT | 9 classes | curvatura vertical × horizontal | 1,9–7,7 MB | |
| Relevo sombreado | RS | numérico | relevo sombreado (hillshade) | cinza (padrão do QGIS) | 28–107 MB |
| Divisores e talvegues | DD | 16 + 2 classes | orientação em 16 semioctantes + linhas de talvegue e divisor (processo ADD) | 4,1–13 MB |
* Faixa medida por consulta HEAD em quatro folhas de tamanhos diferentes (01N495, 09S375, 23S465, 33S54_). O plugin mostra o tamanho exato de cada arquivo da sua seleção antes de baixar.
Como funciona
Três escolhas explicam o comportamento do plugin: quais folhas entram, como a contagem e o tamanho são calculados e como um download é considerado completo.
intersectsA grade (grade_topodata.geojson, 556 polígonos em EPSG:4326, campos scene e url) vai junto com o plugin e é indexada uma vez por sessão. Um índice espacial pré-seleciona as folhas pela caixa envolvente; cada candidata é confirmada com intersects sobre a geometria real. Folhas apenas tocadas pela borda ou por um vértice do retângulo entram.
06S375 e 06S36_: entram as duas.07S36_, com a borda oeste exatamente na divisa: 07S375, só tocada, também entra.07S375: só ela entra.As folhas reais têm meia margem de pixel (~0,000139°, ~15 m) além do limite nominal, então vizinhas se sobrepõem levemente. Um retângulo que começa até 15 m antes da divisa já inclui as duas folhas.
A seleção é feita no SRC do projeto (UTM, Web Mercator, Policônica…). O retângulo vira um polígono com 32 vértices extras por lado e é transformado para EPSG:4326 com o contexto de transformação do projeto. Num SRC projetado a consulta usa a forma real da seleção em coordenadas geográficas, não uma caixa envolvente maior. O diálogo mostra a caixa envolvente da seleção já em graus.
Content-Length de cada arquivo (requisição HEAD, sem baixar dados; 6 em paralelo, guardadas na sessão). É o tamanho exato do arquivo atual..part; o nome final só é dado depois de conferir o tamanho contra o Content-Length e o cabeçalho TIFF (uma página de erro, por exemplo, é descartada)..part.json. Na retomada são enviados Range e If-Range; os bytes só são anexados se a resposta for 206 com Content-Range começando exatamente no fim do parcial e com o mesmo total. Arquivo mudado no servidor, parcial sem ETag ou faixa que não confere: o parcial é descartado e o download recomeça do zero..part; os não iniciados aparecem como “Cancelado”.Com Carregar as imagens no QGIS ao concluir marcado, cada arquivo disponível (baixado ou reutilizado) vira uma camada separada no grupo TOPODATA, com o caminho final e o nome 07S36_SA — Decliv. (A). Arquivos que já estão no projeto não são duplicados; os que o GDAL não abre aparecem na tabela com o motivo.
07S375 e 07S36_) de três produtos. Sem mosaico, recorte nem reprojeção — a divisa entre as folhas continua visível.Ajuda
Cada mensagem do plugin traz uma explicação curta; o detalhe técnico fica em Detalhes técnicos (pode ser copiado) e em Exibir → Painéis → Mensagens de log, aba TOPODATA Downloader.
A consulta HEAD ao servidor do INPE falhou para algum arquivo: sem internet, proxy do QGIS inacessível ou servidor fora do ar. Confira a conexão e o proxy em Configurações → Opções → Rede e use Consultar tamanhos novamente. O download pode ser feito mesmo sem o tamanho; o progresso passa a ser contado por arquivos.
A rede não alcança data.inpe.br. A causa mais comum é um proxy ligado no QGIS que não existe mais; desligue-o ou corrija-o em Configurações → Opções → Rede. As falhas temporárias já são repetidas automaticamente até 4 vezes.
.part e .part.json na pastaSão downloads interrompidos (cancelamento, falha ou QGIS fechado). Baixe de novo com a mesma pasta: o plugin retoma do ponto em que parou se o servidor confirmar que o arquivo não mudou; senão recomeça. Pode apagá-los com segurança se não for continuar.
O arquivo já estava na pasta com o mesmo tamanho do servidor e cabeçalho TIFF válido, então não foi baixado de novo. Para forçar, marque Baixar novamente arquivos que já existem na pasta.
Acontece ao abrir os arquivos classificados direto no QGIS (sem o plugin): a tabela de cores que vem nos arquivos é cinza quase preta. Carregue-os pelo plugin (Carregar no QGIS) para receber as cores por classe, ou escolha Valores únicos em Propriedades → Simbologia.
Depende da conexão, do servidor do INPE e do volume. Produtos classificados têm poucos MB por folha; os numéricos e o relevo sombreado têm 30–120 MB por folha cada um. Marcar todos os produtos numa área de 4 folhas passa de 1 GB.
O plugin pergunta antes (inclusive com Esc). Ao confirmar, o download é cancelado: os arquivos concluídos ficam, o em andamento vira .part.
Dados
Banco de dados geomorfométricos do Brasil, do Instituto Nacional de Pesquisas Espaciais (INPE). Os dados de elevação do SRTM (fevereiro de 2000) foram refinados por krigagem de 3 para 1 segundo de arco, para favorecer as derivações geomorfométricas, e todo o processamento foi feito em coordenadas geográficas, sem reprojeção.
~30 m
pixel de 0,00027777° (1″), refinado do SRTM de 3″ (~90 m)
556
folhas de 1° × 1,5°, articulação 1:250.000, cobrindo todo o Brasil
4326
coordenadas geográficas WGS 84; altitudes ortométricas (EGM96)
COG
GeoTIFF otimizado para nuvem; Float32 numéricos, Byte classificados
O plugin não é um produto do INPE; só automatiza o acesso aos arquivos públicos. Cite o TOPODATA/INPE ao usar os dados.
Sobre o autor
Professor do Curso Superior de Tecnologia em Geoprocessamento do Instituto Federal da Paraíba (IFPB).
Marcello Benigno é mestre em Ciências Geodésicas e Tecnologias da Geoinformação pela UFPE e engenheiro civil pela UFCG. Atua há mais de 20 anos no ensino e no desenvolvimento de soluções geotecnológicas de código aberto.
Sua experiência inclui desenvolvimento Web GIS e automação espacial com Python — especialmente PyQGIS, OSMnx, NetworkX e Django —, frontend de mapas web com Leaflet e Vue.js, modelagem de bancos de dados geográficos e arquiteturas em ambiente Linux. Esse trabalho orienta o desenvolvimento de ferramentas que integram análise espacial e geoprocessamento ao ecossistema QGIS.