Saltar al contenido
Volver al blog
AI Agent
QGIS
Tutorial

Cómo descargar datos de OpenStreetMap en QGIS

Published

El centro de Kisumu, Kenia, dividido en dos: el mapa base de OpenStreetMap a la izquierda y, a la derecha, las mismas calles como datos cargados, edificios coloreados por área de huella y carreteras principales.
El centro de Kisumu, Kenia. A la izquierda, el mapa base de OpenStreetMap: una imagen. A la derecha, el mismo lugar como datos que puedes seleccionar, medir y guardar: 4,572 edificios y 128 segmentos de carretera principal.

Para descargar datos de OpenStreetMap en QGIS, instala el plugin QuickOSM, abre Vector > QuickOSM > QuickOSM…, escribe una clave como building en la pestaña Quick query, elige Canvas Extent y haz clic en Run query. Para un país entero, descarga el archivo .osm.pbf desde Geofabrik y arrástralo a QGIS.

Cuál quieres depende de dos cosas: de lo grande que sea el área y de si ya conoces la etiqueta de OpenStreetMap para lo que necesitas. Probé todos los métodos siguientes en el centro de Kisumu, Kenia, el 23 de septiembre de 2026, en QGIS 3.44.7, y cronometré cada uno.

La respuesta corta

Tu áreaMétodoMedido en Kisumu
Un municipio o la vista que tienes abierta, y conoces la etiquetaMétodo 1: QuickOSM5 segundos para 4,560 edificios en 6.3 km²
No conoces las etiquetas, o quieres que quede estilizado y guardado de una vezMétodo 2: un agente AI en QGIS3 min 41 s para edificios, carreteras principales, estilizado y un GeoPackage
Una región o un país enteroMétodo 3: una extracción de Geofabrik57 s para descargar Kenia (334 MB), 6 min 28 s para recortar Kisumu
Una consulta que quieres probar antes en un mapaMétodo 4: Overpass Turbo, exportar GeoJSON417 edificios en pantalla en unos segundos

Mi opción por defecto es QuickOSM para cualquier cosa hasta el tamaño de un municipio, y Geofabrik en cuanto el área es una región. La ruta que evitaría es enviar una consulta del tamaño de un país a Overpass, y las siguientes secciones explican por qué.

Antes de empezar

OpenStreetMap lo guarda todo como etiquetas, pares de una clave y un valor: building=yes, highway=primary, amenity=school. Todos los métodos de descarga te piden una clave, un valor o ambos, así que conviene buscar la etiqueta primero en la página Map features de la wiki de OSM. Una clave sola (building) devuelve todos sus valores.

Necesitas QGIS 3.34 o posterior para QuickOSM 2.5.3, la versión actual del repositorio de plugins (consultado el 23 de septiembre de 2026), y conexión a internet. Para la ruta de Geofabrik, cuenta con unos cientos de megabytes de disco por país.

Donde la web se equivoca

"La layer de OpenStreetMap en QGIS son los datos." No lo es. La entrada OpenStreetMap dentro de XYZ Tiles en el panel Browser es un conjunto de imágenes dibujadas a partir de los datos. No puedes seleccionar un edificio en ella, leer sus atributos ni medirla.

La política de uso de tiles lo dice en una línea: "Los datos de OpenStreetMap (OSM) son libres para que los use todo el mundo. Nuestros servidores de tiles no." También prohíbe la descarga masiva de tiles, así que guardar el mapa base en disco tampoco es una forma de evitarlo.

"Access blocked significa que OpenStreetMap te bloqueó." El mensaje "Access blocked" aparece impreso en los tiles del mapa, no en los datos. La página de la wiki de OSM sobre tiles bloqueados da el más común: "403r. Access blocked. Referer is required by tile usage policy of OpenStreetMap's volunteer-run servers".

Significa que la aplicación que muestra el mapa base no envió una cabecera Referer o User-Agent. No tiene nada que ver con los servicios de datos de abajo, que fallan de otras maneras.

"Overpass puede darme un país entero." La wiki de la API de Overpass pide a los usuarios públicos que se mantengan por debajo de 10,000 consultas y 1 GB al día, y remite a quien necesita áreas grandes a los volcados regionales de Geofabrik. Mi prueba pidiendo a QuickOSM todos los edificios de Kenia murió tras unos 32 segundos por tiempo de espera agotado, algo que cubre el Método 4.

Método 1: QuickOSM, para un municipio o la vista actual

QuickOSM envía tu consulta a un servidor Overpass y carga la respuesta como layers. Es la ruta más rápida cuando el área cabe en tu pantalla.

Instalar QuickOSM

Plugins > Manage and Install Plugins, busca QuickOSM, Install Plugin. La primera vez que lo abres, muestra un recordatorio de que los datos de OSM están bajo la ODbL y pide el crédito "© OpenStreetMap contributors".

Haz zoom a tu área

Encuadra el municipio o el barrio en el lienzo. Yo hice zoom al centro de Kisumu, unos 3 km por 2 km.

Rellena la pestaña Quick query

Vector > QuickOSM > QuickOSM…, luego Quick query. Escribe building como clave, deja el valor vacío (pone "Query on all values") y establece la extensión en Canvas Extent. Las otras opciones de extensión son In (un nombre de lugar), Around, Layer Extent y Not Spatial.

Ejecutar la consulta

Haz clic en Run query. Kisumu volvió en 5 segundos como dos layers: 4,560 polígonos de edificios con 58 campos de atributos, y 3 edificios mapeados como puntos.
La pestaña Quick query de QuickOSM con la clave building, el valor vacío, Canvas Extent seleccionado y la sección Advanced abierta mostrando un tiempo de espera de 25 segundos y Save to temporary file.
La pestaña Quick query, con Advanced abierta. Fíjate en la parte inferior: un tiempo de espera de 25 segundos y 'Save to temporary file' son los valores por defecto.

La sección Advanced importa más de lo que parece. El tiempo de espera por defecto es de 25 segundos, suficiente para un municipio y no para una región. El campo Directory tiene por defecto "Save to temporary file", así que las layers acaban en memoria, marcadas con el icono de layer temporal en el panel Layers, y desaparecen cuando cierras QGIS sin guardarlas.

QGIS con 4,560 edificios de OpenStreetMap en rojo sobre el mapa base de OpenStreetMap del centro de Kisumu, y dos layers llamadas building en el panel Layers con el icono de layer temporal.
El resultado de QuickOSM sobre el mapa base. Las dos layers 'building' llevan el icono de temporal a la derecha de sus nombres: todavía no hay nada en disco.

Para conservarlas, haz clic derecho en la layer, Make Permanent… y elige una ruta de GeoPackage. Los edificios de Kisumu generaron un archivo de 1.5 MB. También puedes definir un directorio en Advanced antes de ejecutar, y QuickOSM escribe directamente GeoPackage (el valor por defecto), GeoJSON, Shapefile o KML.

El menú contextual de layer de QGIS con Make Permanent, junto al diálogo Save Scratch Layer ajustado a GeoPackage con el nombre de layer buildings.
Make Permanent abre el diálogo Save Scratch Layer, GeoPackage por defecto. QuickOSM también añade 'Reload the query in a new file' al mismo menú.

No esperaba lo escuetas que son aquí las etiquetas. 4,453 de los 4,560 edificios de Kisumu (98%) solo llevan building=yes. Estilizar "por tipo de edificio" te da un color y 107 excepciones. Las etiquetas son tan detalladas como las hicieron los mapeadores locales, así que revisa los recuentos de valores antes de prometer un mapa por tipo.

Úsalo cuando: el área sea un municipio o más pequeña y conozcas la clave que quieres.

Omítelo cuando: el área sea una región o un país, o la consulta necesite varias etiquetas combinadas de formas que el formulario Quick query no ofrece.

Método 2: Una frase a un agente AI en QGIS

Nosotros construimos una de estas herramientas, AI Agent, un panel de chat dentro de QGIS que ejecuta los pasos en el proyecto que tengas abierto. Esta sección trata de nuestra propia herramienta.

Le viene bien al lector que no conoce las etiquetas, o que quiere toda la cadena hecha de una vez: obtener, recortar, estilizar y guardar. En un proyecto nuevo, con zoom en la misma vista de Kisumu, escribí:

Carga los edificios y las carreteras principales del centro de Kisumu, Kenia, desde OpenStreetMap, colorea los edificios por área de huella y guarda las dos layers en un GeoPackage.

Tardó 3 minutos 41 segundos y 39 acciones. Geocodificó Kisumu, consultó OpenStreetMap buscando edificios y carreteras etiquetadas de motorway a tertiary en la vista de 6.2 km², recortó ambas a esa vista y calculó un campo area_m2 en la zona UTM 36S para que las áreas estén en metros cuadrados reales. Después aplicó un estilo graduado de cinco clases y escribió ambas layers en Kisumu central OSM.gpkg junto al proyecto, preguntando una vez antes de escribir el archivo.

QGIS con los edificios del centro de Kisumu coloreados de amarillo a rojo oscuro por área de huella y las carreteras principales en azul, el panel Layers mostrando cinco clases de área y el panel de AI Agent listando el GeoPackage guardado de 1.5 MB.
El resultado junto al panel: 4,572 edificios en cinco clases de área, hasta 17,026 m², 128 segmentos de carretera principal y el GeoPackage de 1.5 MB que guardó.

Las layers son layers normales de QGIS dentro de un GeoPackage, así que siguen en el resto de tu proyecto como las de QuickOSM. Para una etiqueta en una vista, los 5 segundos de QuickOSM ganan. El agente tarda minutos porque además recorta, añade el campo de área, estiliza y guarda.

Prueba AI Agent gratis en QGIS

Un segundo mensaje muestra algo que ninguno de los otros métodos hace de una vez. Le pedí que cargara los edificios de Overture Maps de la misma vista y contara los que OpenStreetMap no tiene. En 2 minutos 41 segundos cargó 7,318 edificios de Overture y los emparejó por ID: 4,572 vienen de OpenStreetMap, 2,367 de Google Open Buildings y 379 de las huellas de machine learning de Microsoft.

Eso son 2,746 edificios, el 38% del total, que una descarga pura de OSM del centro de Kisumu deja fuera.

QGIS con los edificios de Overture del centro de Kisumu coloreados por fuente, amarillo para OpenStreetMap, morado para Google Open Buildings y turquesa para Microsoft ML Buildings, y la respuesta de AI Agent contando 2,746 edificios que no están en OpenStreetMap.
Overture sobre la misma vista, coloreado por fuente. El morado (Google) y el turquesa (Microsoft) son los edificios que OpenStreetMap aún no tiene.

Úsalo cuando: el área sea un municipio o la vista que tienes abierta, y quieras los datos estilizados, recortados o comparados, no solo cargados.

Omítelo cuando: necesites una región o un país. Funciona a la escala de un municipio, las peticiones sobre áreas grandes agotan el tiempo de espera más a menudo, y una extracción de Geofabrik es la ruta más rápida ahí.

Método 3: Una extracción de Geofabrik, para una región o un país

Geofabrik publica extracciones gratuitas de OpenStreetMap por continente, país y, para algunos países, por región. No se consulta nada: descargas un archivo que ya contiene todos los objetos.

Elige la región

Ve a tu país. La página de Kenia el 23 de septiembre de 2026 ofrecía kenya-latest.osm.pbf a 334 MB, kenya-latest-free.shp.zip a 939 MB y kenya-latest-free.gpkg.zip a 965 MB. El .pbf se descargó en 57 segundos aquí.

Arrastra el .pbf a QGIS

QGIS abre un diálogo "Select Items to Add" con cinco layers: points, lines, multilinestrings, multipolygons y other_relations. Los edificios, el uso del suelo y la mayoría de las áreas están en multipolygons.

Filtra lo que necesitas

Haz clic derecho en la layer, Filter…, y escribe "building" IS NOT NULL. Las claves comunes como building, amenity y landuse tienen su propia columna. Todo lo demás está en other_tags.

Recorta tu área y guárdala

Un país entero es lento de dibujar. Recorta tu área una vez, con el comando de abajo, y trabaja desde ese archivo.
El diálogo Select Items to Add de QGIS para kenya-latest.osm.pbf, que lista lines, multilinestrings, multipolygons, other_relations y points, con multipolygons seleccionado.
Las cinco layers dentro de un .pbf de Geofabrik. Elige multipolygons para los edificios.

No trabajes con el archivo del país tal cual. QGIS lee el .osm.pbf de principio a fin cada vez que dibuja o cuenta, sea cual sea el zoom. Dibujar la vista de Kisumu directamente desde el archivo de Kenia tardó 19 minutos en mi portátil la primera vez, con otro trabajo leyendo el mismo archivo, y contar los edificios de esa vista en una segunda pasada tardó 2 minutos 42 segundos. Recorta una vez con ogr2ogr, la herramienta GDAL que viene con 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"

Eso tardó 6 minutos 28 segundos y dejó un GeoPackage de 1.3 MB con 4,576 edificios, que QGIS maneja como cualquier layer pequeña. Los cuatro números después de -spat son oeste, sur, este y norte en grados.

Los zips de shapefile y GeoPackage son más fáciles de abrir, con una layer por tema, pero la descripción del formato enumera lo que deja fuera la versión gratuita: entre otras cosas, la altura de los edificios y el número de plantas. El .pbf conserva todas las etiquetas.

Úsalo cuando: el área sea una región o un país, o vayas a consultar la misma área muchas veces.

Omítelo cuando: necesites una etiqueta en un solo barrio. Descargar 334 MB para 6 km² es el camino lento.

Método 4: Overpass Turbo, para una consulta que quieres ver primero

Overpass Turbo es una página web donde escribes una consulta Overpass, la ejecutas en la vista actual del mapa y ves el resultado antes de descargar nada. Es el lugar para construir una consulta que el formulario de QuickOSM no puede expresar.

Las tres líneas de abajo piden todos los edificios de la vista actual del mapa:

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

Escribe la consulta

Pégalo en el editor de la izquierda, o construye una con el botón Wizard.

Ejecútala en tu vista

Haz zoom en el mapa a tu área y haz clic en Run. En una vista con zoom 17 del centro de Kisumu dibujó 417 edificios.

Exporta como GeoJSON

Export, luego GeoJSON, download. El mismo diálogo ofrece GPX, KML y datos OSM en bruto. Arrastra el archivo .geojson a QGIS.
Overpass Turbo con una consulta de edificios de tres líneas a la izquierda y el centro de Kisumu a la derecha con los contornos de los edificios resaltados en azul. La línea de estado dice 417 ways loaded.
La consulta a la izquierda, el resultado a la derecha. El contador de abajo a la derecha dice lo que volvió: 417 ways, 417 polígonos.

Aquí también es de donde vienen los tiempos de espera, porque QuickOSM y Overpass Turbo hablan con los mismos servidores. El ajuste [timeout:] tiene por defecto 180 segundos y [maxsize:] 512 MB de memoria del servidor, según la documentación de Overpass QL. Una consulta que supere cualquiera de los dos se corta. QuickOSM envía 25 segundos por defecto. Cuando le pedí todos los edificios de Kenia, la respuesta tras unos 32 segundos fue:

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

El servidor público también raciona las peticiones. Consultándolo directamente en un bucle rápido para elegir un municipio para este post, mi quinta petición en unos 20 segundos devolvió 429 Too Many Requests y la sexta 504 Gateway Timeout. El consejo de la wiki sobre un 429 es pausar 30 segundos antes de enviar la siguiente. Subir [timeout:] ayuda a una consulta que casi es lo bastante rápida. Para un país solo te hace esperar más antes de la misma respuesta.

Úsalo cuando: estés escribiendo una consulta personalizada y quieras comprobar el resultado en un mapa antes de cargarlo.

Omítelo cuando: el área sea grande, o vayas a repetir la descarga a menudo. Usa el Método 3.

Acredita a OpenStreetMap cuando publiques

Los datos de OpenStreetMap están bajo la Open Database License. La página de copyright pide dos cosas allí donde los uses: acreditar a OpenStreetMap y dejar claro que los datos están bajo la ODbL, cosa que hace un enlace a openstreetmap.org/copyright. Las directrices de atribución aceptan "© OpenStreetMap contributors" y lo quieren junto al mapa o donde un lector esperaría encontrar los créditos.

Una imagen de mapa o un PDF es una obra producida, y el crédito basta. Una layer que compartes como datos, por ejemplo un GeoPackage de edificios que corregiste, permanece bajo la ODbL. La misma página dice: "Si alteras nuestros datos o creas a partir de ellos, solo puedes distribuir el resultado bajo la misma licencia." En una composición de impresión de QGIS, un elemento de texto con el crédito en la esquina del mapa cubre el primer caso.

Qué recordar

  • Elige el método por área: QuickOSM para un municipio o la vista actual (5 segundos para 4,560 edificios en Kisumu), un agente AI cuando quieras que quede recortado, estilizado y guardado en un solo mensaje, un .pbf de Geofabrik para una región o un país, Overpass Turbo para probar una consulta personalizada.
  • El mapa base de OpenStreetMap en QGIS es una imagen dibujada a partir de los datos, y "Access blocked" es un mensaje sobre esas imágenes, no sobre los datos.
  • Los resultados de QuickOSM son layers temporales hasta que uses Make Permanent… o definas un directorio en Advanced.
  • Las consultas de Overpass fallan en áreas grandes: el tiempo de espera por defecto de QuickOSM es de 25 segundos, el servidor raciona las peticiones con un 429, y un país pertenece a una extracción de Geofabrik.
  • La cobertura de OpenStreetMap es desigual: en el centro de Kisumu, Overpass devolvió 4,572 edificios mientras que Overture, que añade huellas de Google y Microsoft, contenía 7,318.

Preguntas que hace la gente

¿Cómo obtengo los edificios o las carreteras de OSM de mi municipio?

Haz zoom al municipio en QGIS, abre Vector > QuickOSM > QuickOSM…, escribe building (o highway para carreteras) como clave, establece Canvas Extent y ejecuta la consulta. Para las carreteras, añade un valor como primary, o déjalo vacío para obtener todas las clases de vía, incluidos los senderos. Guarda el resultado con Make Permanent….

QuickOSM, Geofabrik o Overpass: ¿cuál?

QuickOSM para un municipio o menos, cuando conoces la etiqueta. Geofabrik para una región o un país, o cuando vayas a reutilizar el área. Overpass Turbo cuando quieras escribir y probar una consulta primero en un mapa. QuickOSM y Overpass Turbo usan los mismos servidores de Overpass, así que comparten los mismos límites de tamaño.

¿Por qué mi consulta de Overpass agota el tiempo de espera o dice access blocked?

Un tiempo de espera agotado significa que la consulta superó su [timeout:] (25 segundos en QuickOSM, 180 por defecto en Overpass) o su límite de memoria, así que reduce el área o cambia a una extracción de Geofabrik. Un 429 Too Many Requests significa que enviaste demasiadas en poco tiempo. Espera 30 segundos. "Access blocked" aparece impreso en los tiles del mapa base, no en los datos de Overpass, y viene de las reglas de Referer y User-Agent del servidor de tiles.

¿Cómo guardo la layer temporal que crea QuickOSM?

Haz clic derecho en la layer del panel Layers, Make Permanent…, elige GeoPackage y una ruta de archivo. Para saltarte el paso la próxima vez, define un Directory en la sección Advanced de QuickOSM antes de ejecutar la consulta, y escribirá el archivo directamente.

¿Qué exige la licencia ODbL cuando publico un mapa?

Acreditar a OpenStreetMap, por ejemplo "© OpenStreetMap contributors", junto al mapa, y dejar claro que los datos están bajo la ODbL, normalmente con un enlace a openstreetmap.org/copyright. Si compartes los datos en sí, modificados o no, tienen que permanecer bajo la ODbL.

¿Está completa la cobertura de edificios de OSM?

No en todas partes. Un estudio de 2023 en Nature Communications estimó la completitud media de los edificios de OSM en un 24% por núcleo urbano en todo el mundo, con un 71% en Europa y Asia Central y un 9% en Asia Meridional. En el centro de Kisumu, el 38% de los edificios que contiene Overture no están en OSM.

Compáralo con otras fuentes antes de fiarte de los recuentos, o detecta los que faltan a partir de imágenes, como en detectar huellas de edificios en QGIS. Qué es una huella de edificio cubre la diferencia entre los conjuntos de datos.

Una vez que los datos están dentro, la guía de AI Agent muestra qué más puede hacer un solo mensaje con ellos. Si tu siguiente layer son imágenes en vez de vectores, descargar Sentinel-2 en QGIS y georreferenciar un mapa escaneado son los dos tutoriales complementarios, y añadir un mapa base cubre la layer de imagen de la que parte este post.

Prueba AI Agent gratis en QGIS