Como Baixar Dados do OpenStreetMap no QGIS

Para baixar dados do OpenStreetMap no QGIS, instale o plugin QuickOSM, abra Vector > 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 delas você quer 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 de 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 layer do OpenStreetMap no QGIS são os dados." Não são. A entrada OpenStreetMap em XYZ Tiles no painel Browser é um conjunto de imagens desenhadas a partir dos dados. Você não pode selecionar um edifício nela, ler seus atributos ou medi-la.

A política de uso de tiles diz isso em uma linha: "Os dados do OpenStreetMap (OSM) são livres para todos usarem. Nossos servidores de tiles não são." Ela também proíbe o download em massa de tiles, 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 tiles do mapa, não nos dados. A página da wiki do OSM sobre tiles 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 todos os edifícios 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 layers. É 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 layers caem na memória, marcadas com o ícone de scratch layer no painel Layers, e desaparecem quando você fecha o QGIS sem salvá-las.

Para mantê-las, clique com o botão direito na layer, Make Permanent…, e escolha um caminho de GeoPackage. Os edifícios 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 dos 4,560 edifícios de Kisumu (98%) trazem apenas building=yes. Estilizar "por tipo de edifício" 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 chat 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 os edifícios e as vias principais do centro de Kisumu, no Quênia, do OpenStreetMap, colora os edifícios pela área da pegada e salve as duas layers em um GeoPackage.

Levou 3 minutos e 41 segundos e 39 ações. Ele geocodificou Kisumu, consultou o OpenStreetMap por edifícios 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 layers em Kisumu central OSM.gpkg ao lado do projeto, perguntando uma vez antes de gravar o arquivo.

As layers são layers QGIS comuns 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.

Experimente o AI Agent gratuitamente no QGIS

Uma segunda mensagem mostra algo que nenhum dos outros métodos faz em uma tacada. Pedi a ele que carregasse os edifícios do Overture Maps da mesma vista e contasse os que o OpenStreetMap não tem. Em 2 minutos e 41 segundos ele carregou 7,318 edifícios do Overture e os cruzou por ID: 4,572 vêm do OpenStreetMap, 2,367 do Google Open Buildings e 379 das pegadas de machine learning da Microsoft.

São 2,746 edifícios, 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 os edifícios 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 edifícios, que o QGIS trata como qualquer layer 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 layer por tema, mas a descrição do formato lista o que a versão gratuita deixa de fora: altura do edifício 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 todos os edifícios 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 todos os edifícios 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 layer que você compartilha como dado, um GeoPackage de edifícios 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 edifícios 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 layers temporárias até você usar Make Permanent… 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 edifícios enquanto o Overture, que soma pegadas do Google e da Microsoft, tinha 7,318.

Perguntas frequentes

Como faço para obter os edifícios ou as vias do OSM da minha cidade?

Dê zoom na cidade no QGIS, abra Vector > 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 Make Permanent….

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 tiles do mapa base, não nos dados do Overpass, e vem das regras de Referer e User-Agent do servidor de tiles.

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

Clique com o botão direito na layer no painel Layers, Make Permanent…, 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 edifícios do OSM é completa?

Não em todo lugar. Um estudo de 2023 na Nature Communications estimou a completude média dos edifícios 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% dos edifícios que o Overture tem não estão no OSM.

Compare com outras fontes antes de confiar nas contagens, ou detecte os que faltam a partir de imagens, como em detectando pegadas de edifícios no QGIS. O que é uma pegada de edifício 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 layer 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 layer de imagem da qual este post parte.

Experimente o AI Agent gratuitamente no QGIS