Como baixar dados do OpenStreetMap no QGIS com QuickOSM

Para baixar dados do OpenStreetMap no QGIS, instale o plugin QuickOSM, abra Vetor > QuickOSM > QuickOSM…, digite uma chave como building na aba Quick query, escolha Canvas Extent e clique em Run query. Para um país inteiro, baixe o arquivo .osm.pbf da Geofabrik e arraste-o para o QGIS.

Qual método você usa depende de duas coisas: o tamanho da área e se você já conhece a tag do OpenStreetMap para o que precisa. Testei todos os métodos abaixo em Kisumu central, no Quênia, em 23 de setembro de 2026, no QGIS 3.44.7, e cronometrei cada um.

A resposta rápida

Minha opção padrão é o QuickOSM para qualquer coisa até o tamanho de uma cidade, e a Geofabrik assim que a área vira uma região. O caminho que eu evitaria é enviar uma consulta do tamanho de um país ao Overpass, e as próximas seções mostram o porquê.

Antes de começar

O OpenStreetMap armazena tudo como tags, pares de chave e valor: building=yes, highway=primary, amenity=school. Todo método de download pede uma chave, um valor ou ambos, então ajuda conferir a tag antes na página Map features da wiki do OSM. Uma chave sozinha (building) retorna todos os valores dela.

Você precisa do QGIS 3.34 ou mais recente para o QuickOSM 2.5.3, a versão atual no repositório de plugins (verificada em 23 de setembro de 2026), e de conexão com a internet. Na rota da Geofabrik, conte com algumas centenas de megabytes de disco por país.

Onde a web erra

"A camada do OpenStreetMap no QGIS são os dados." Não são. A entrada OpenStreetMap em XYZ Tiles no painel Navegador é um conjunto de imagens desenhadas a partir dos dados. Você não pode selecionar uma edificação nela, ler seus atributos ou medi-la.

A política de uso de blocos de mapa diz isso em uma linha: "Os dados do OpenStreetMap (OSM) são livres para todos usarem. Nossos servidores de blocos de mapa não são." Ela também proíbe o download em massa de blocos, então salvar o mapa base no disco também não é uma saída.

"Access blocked significa que o OpenStreetMap bloqueou você." A mensagem "Access blocked" é impressa nos blocos do mapa, não nos dados. A página da wiki do OSM sobre blocos bloqueados traz a mais comum: "403r. Access blocked. Referer is required by tile usage policy of OpenStreetMap's volunteer-run servers".

Isso significa que o aplicativo que mostra o mapa base não enviou um cabeçalho Referer ou User-Agent. Não tem nada a ver com os serviços de dados abaixo, que falham de outras maneiras.

"Overpass pode me dar um país inteiro." A wiki da Overpass API pede que usuários públicos fiquem abaixo de 10.000 consultas e 1 GB por dia, e direciona quem precisa de áreas grandes para os dumps regionais da Geofabrik. Meu teste pedindo ao QuickOSM todas as edificações do Quênia morreu após cerca de 32 segundos com um timeout, assunto que o Método 4 cobre.

Método 1: QuickOSM, para uma cidade ou a vista atual

O QuickOSM envia sua consulta para um servidor Overpass e carrega a resposta como camadas. É a rota mais rápida quando a área cabe na sua tela.

A seção Advanced importa mais do que parece. O timeout padrão é de 25 segundos, o que basta para uma cidade e não para uma região. O campo Directory vem como "Save to temporary file", então as camadas caem na memória, marcadas com o ícone de camada temporária no painel Camadas, e desaparecem quando você fecha o QGIS sem salvá-las.

Para mantê-las, clique com o botão direito na camada, Tornar permanente…, e escolha um caminho de GeoPackage. As edificações de Kisumu geraram um arquivo de 1,5 MB. Você também pode definir um diretório em Advanced antes de executar, e o QuickOSM grava direto em GeoPackage (o padrão), GeoJSON, Shapefile ou KML.

Eu não esperava que as tags fossem tão simples por aqui. 4.453 das 4.560 edificações de Kisumu (98%) trazem apenas building=yes. Estilizar "por tipo de edificação" dá uma cor e 107 exceções. As tags só têm o nível de detalhe que os mapeadores locais deram a elas, então confira as contagens de valores antes de prometer um mapa por tipo.

Use quando: a área é uma cidade ou menor e você conhece a chave que quer.

Evite quando: a área é uma região ou um país, ou a consulta precisa combinar várias tags de formas que o formulário Quick query não oferece.

Método 2: uma frase para um agente de IA no QGIS

Nós construímos uma dessas ferramentas, o AI Agent, um painel de conversa dentro do QGIS que executa os passos no projeto que você tem aberto. Esta seção é sobre nossa própria ferramenta.

Ela serve para quem não conhece as tags, ou para quem quer a cadeia inteira de uma vez: buscar, recortar, estilizar e salvar. Em um projeto novo, com zoom na mesma vista de Kisumu, digitei:

Carregue as edificações e as vias principais do centro de Kisumu, no Quênia, do OpenStreetMap, colora as edificações pela área do contorno e salve as duas camadas em um GeoPackage.

Levou 3 minutos e 41 segundos e 39 ações. Ele geocodificou Kisumu, consultou o OpenStreetMap por edificações e por vias marcadas de motorway até tertiary na vista de 6,2 km², recortou os dois àquela vista e calculou um campo area_m2 no fuso UTM 36S para que as áreas fiquem em metros quadrados reais. Depois aplicou um estilo graduado de cinco classes e gravou as duas camadas em Kisumu central OSM.gpkg ao lado do projeto, perguntando uma vez antes de gravar o arquivo.

As camadas são camadas comuns do QGIS em um GeoPackage, então seguem para o resto do seu projeto como as do QuickOSM. Para uma tag em uma vista, os 5 segundos do QuickOSM vencem. O agente leva minutos porque também recorta, adiciona o campo de área, estiliza e salva.

Uma segunda mensagem mostra algo que nenhum dos outros métodos faz em uma tacada. Pedi a ele que carregasse as edificações do Overture Maps da mesma vista e contasse as que o OpenStreetMap não tem. Em 2 minutos e 41 segundos ele carregou 7.318 edificações do Overture e as cruzou por ID: 4.572 vêm do OpenStreetMap, 2.367 do Google Open Buildings e 379 dos contornos de edificações (footprints) de machine learning da Microsoft.

São 2.746 edificações, 38% do total, que um download puramente OSM de Kisumu central deixa de fora.

Use quando: a área é uma cidade ou a vista que você tem aberta, e você quer os dados estilizados, recortados ou comparados, não apenas carregados.

Evite quando: você precisa de uma região ou de um país. Ele funciona na escala de uma cidade, requisições de áreas grandes estouram o timeout com mais frequência, e um extrato da Geofabrik é a rota mais rápida por lá.

Método 3: um extrato da Geofabrik, para uma região ou um país

A Geofabrik publica extratos gratuitos do OpenStreetMap por continente, país e, para alguns países, por região. Nada é consultado: você baixa um arquivo que já contém todos os objetos.

Não trabalhe com o arquivo do país como ele é. O QGIS lê o .osm.pbf do início ao fim toda vez que desenha ou conta, seja qual for o zoom. Desenhar a vista de Kisumu direto do arquivo do Quênia levou 19 minutos no meu notebook da primeira vez, com outro trabalho lendo o mesmo arquivo, e contar as edificações daquela vista em uma segunda passada levou 2 minutos e 42 segundos. Recorte uma vez com o ogr2ogr, a ferramenta GDAL que vem com o QGIS:

ogr2ogr -f GPKG kisumu.gpkg kenya-latest.osm.pbf multipolygons -spat 34.745 -0.1114 34.772 -0.0926 -where "building IS NOT NULL"

Isso levou 6 minutos e 28 segundos e deixou um GeoPackage de 1,3 MB com 4.576 edificações, que o QGIS trata como qualquer camada pequena. Os quatro números depois de -spat são oeste, sul, leste e norte em graus.

Os zips de shapefile e GeoPackage são mais fáceis de abrir, com uma camada por tema, mas a descrição do formato lista o que a versão gratuita deixa de fora: altura da edificação e número de pavimentos entre outros. O .pbf mantém todas as tags.

Use quando: a área é uma região ou um país, ou você vai consultar a mesma área muitas vezes.

Evite quando: você precisa de uma tag em um único bairro. Baixar 334 MB por 6 km² é o caminho lento.

Método 4: Overpass Turbo, para uma consulta que você quer ver primeiro

O Overpass Turbo é uma página web onde você escreve uma consulta Overpass, executa na vista de mapa atual e confere o resultado antes de baixar qualquer coisa. É o lugar para montar uma consulta que o formulário do QuickOSM não consegue expressar.

As três linhas abaixo pedem todas as edificações da vista de mapa atual:

[out:json][timeout:25];
way["building"]({{bbox}});
out geom;

É daqui que vêm os timeouts, porque o QuickOSM e o Overpass Turbo falam com os mesmos servidores. A configuração [timeout:] tem padrão de 180 segundos e [maxsize:] de 512 MB de memória do servidor, segundo a documentação Overpass QL. Uma consulta que passa de qualquer um dos dois é cortada. O QuickOSM envia 25 segundos por padrão. Quando pedi a ele todas as edificações do Quênia, a resposta após cerca de 32 segundos foi:

Overpass error: Query timed out in "area-query" at line 5 after 30 seconds.

O servidor público também raciona requisições. Consultando-o diretamente em um loop rápido para escolher uma cidade para este post, minha quinta requisição em cerca de 20 segundos voltou com 429 Too Many Requests e a sexta com 504 Gateway Timeout. O conselho da wiki para um 429 é pausar 30 segundos antes de enviar a próxima. Aumentar [timeout:] ajuda uma consulta que está quase rápida o suficiente. Para um país, só faz você esperar mais pela mesma resposta.

Use quando: você está escrevendo uma consulta personalizada e quer conferir o resultado em um mapa antes de carregá-lo.

Evite quando: a área é grande, ou você vai repetir o download com frequência. Use o Método 3.

Dê crédito ao OpenStreetMap ao publicar

Os dados do OpenStreetMap estão sob a Open Database License. A página de copyright pede duas coisas onde quer que você use: dar crédito ao OpenStreetMap e deixar claro que os dados estão sob a ODbL, o que um link para openstreetmap.org/copyright resolve. As diretrizes de atribuição aceitam "© OpenStreetMap contributors" e querem que isso fique ao lado do mapa ou onde o leitor esperaria os créditos.

Uma imagem de mapa ou um PDF é um trabalho produzido, e o crédito basta. Uma camada que você compartilha como dado, um GeoPackage de edificações que você corrigiu, por exemplo, continua sob a ODbL. A mesma página diz: "Se você alterar ou construir sobre os nossos dados, só pode distribuir o resultado sob a mesma licença." Num layout de impressão do QGIS, um item de texto com o crédito no canto do mapa cobre o primeiro caso.

O que lembrar

• Escolha o método pela área: QuickOSM para uma cidade ou a vista atual (5 segundos para 4.560 edificações em Kisumu), um agente de IA quando você quiser tudo recortado, estilizado e salvo em uma única mensagem, um .pbf da Geofabrik para uma região ou um país, Overpass Turbo para testar uma consulta personalizada.
• O mapa base do OpenStreetMap no QGIS é uma imagem desenhada a partir dos dados, e "Access blocked" é uma mensagem sobre essas imagens, não sobre os dados.
• Os resultados do QuickOSM são camadas temporárias até você usar Tornar permanente… ou definir um diretório em Advanced.
• Consultas Overpass falham em áreas grandes: o timeout padrão do QuickOSM é de 25 segundos, o servidor raciona requisições com um 429, e um país pertence a um extrato da Geofabrik.
• A cobertura do OpenStreetMap é desigual: em Kisumu central, o Overpass retornou 4.572 edificações enquanto o Overture, que soma contornos do Google e da Microsoft, tinha 7.318.
• Com os dados carregados, uma junção espacial no QGIS os associa às suas próprias áreas, como o distrito em que fica cada escola.

Perguntas frequentes

Como faço para obter as edificações ou as vias do OSM da minha cidade?

Dê zoom na cidade no QGIS, abra Vetor > QuickOSM > QuickOSM…, digite building (ou highway para vias) como chave, defina Canvas Extent e execute a consulta. Para vias, adicione um valor como primary, ou deixe vazio para obter todas as classes de via, incluindo trilhas. Salve o resultado com Tornar permanente….

QuickOSM, Geofabrik ou Overpass: qual usar?

QuickOSM para uma cidade ou algo menor, quando você conhece a tag. Geofabrik para uma região ou um país, ou quando você vai reutilizar a área. Overpass Turbo quando você quer escrever e testar uma consulta em um mapa primeiro. QuickOSM e Overpass Turbo usam os mesmos servidores Overpass, então compartilham os mesmos limites de tamanho.

Por que minha consulta Overpass dá timeout ou mostra access blocked?

Um timeout significa que a consulta passou do seu [timeout:] (25 segundos no QuickOSM, 180 por padrão no Overpass) ou do seu limite de memória, então diminua a área ou troque por um extrato da Geofabrik. Um 429 Too Many Requests significa que você enviou muitas em pouco tempo. Espere 30 segundos. "Access blocked" é impresso nos blocos do mapa base, não nos dados do Overpass, e vem das regras de Referer e User-Agent do servidor de blocos.

Como salvo a camada temporária que o QuickOSM cria?

Clique com o botão direito na camada no painel Camadas, Tornar permanente…, escolha GeoPackage e um caminho de arquivo. Para pular o passo na próxima vez, defina um Directory na seção Advanced do QuickOSM antes de executar a consulta, e ele grava o arquivo direto.

O que a licença ODbL exige quando publico um mapa?

Dar crédito ao OpenStreetMap, por exemplo "© OpenStreetMap contributors", ao lado do mapa, e deixar claro que os dados estão sob a ODbL, normalmente com um link para openstreetmap.org/copyright. Se você compartilhar os dados em si, alterados ou não, eles têm que permanecer sob a ODbL.

A cobertura de edificações do OSM é completa?

Não em todo lugar. Um estudo de 2023 na Nature Communications estimou a completude média das edificações do OSM em 24% por centro urbano no mundo, com 71% na Europa e Ásia Central e 9% no Sul da Ásia. Em Kisumu central, 38% das edificações que o Overture tem não estão no OSM.

Compare com outras fontes antes de confiar nas contagens, ou detecte as que faltam a partir de imagens, como em detectando contornos de edificações no QGIS. O que é um contorno de edificação cobre a diferença entre os conjuntos de dados.

Com os dados carregados, o guia do AI Agent mostra o que mais uma mensagem pode fazer com eles. Se sua próxima camada for de imagens em vez de vetores, baixando Sentinel-2 no QGIS e georreferenciando um mapa escaneado são os dois tutoriais complementares, e adicionando um mapa base cobre a camada de imagem da qual este post parte.

Leia a seguirComo automatizar o QGIS: 4 métodos testados em 2 cidades