{"canonical_url":"https://engineer.company/es/glossary/gdal/","content_markdown":"# GDAL\n\n## Qué es\n\nGDAL, siglas de Geospatial Data Abstraction Library y también escrito GDAL/OGR, es software de código abierto que abre datos cartográficos en un formato y los escribe en otro, reproyectándolos durante la conversión si se le pide. Su propia documentación lo llama biblioteca de traducción.\n\nLos datos espaciales tienen dos formas. Los datos ráster son una cuadrícula de celdas: una imagen de satélite, una fotografía aérea, un modelo de elevación. Los vectoriales son puntos, líneas y polígonos con atributos asociados: direcciones, carreteras, límites de parcelas. GDAL ofrece al programa que lo llama un modelo abstracto para cada forma, con un controlador por formato detrás. GeoTIFF, JPEG 2000 y NetCDF tienen controladores ráster; Shapefile, GeoJSON, GeoPackage, KML y las tablas PostgreSQL tienen controladores vectoriales. Hay muchos más de ambos tipos. Un programa escrito para GDAL los lee todos mediante las mismas llamadas.\n\nLa mitad vectorial se conoció durante años como OGR; ambas mitades mantuvieron estructuras de controladores separadas hasta que GDAL 2.0 las unió. Por eso los programas vectoriales aún llevan el antiguo prefijo: `ogrinfo` describe un conjunto de datos vectoriales y `ogr2ogr` lo convierte. Frank Warmerdam empezó a trabajar en la biblioteca a finales de 1998. Se publica con una licencia de tipo MIT y es un proyecto de Open Source Geospatial Foundation, OSGeo.\n\nHay tres formas de usarla. La primera es la línea de comandos: `gdalinfo`, `gdal_translate` y `gdalwarp` para ráster; `ogrinfo` y `ogr2ogr` para vectores. Desde la versión 3.11 también hay un único comando `gdal` con subcomandos como `gdal raster` y `gdal vector`, que el proyecto aún marca como provisional. La segunda es desde código, mediante interfaces para Python y otros lenguajes. La tercera es dentro de otro software: QGIS, por ejemplo, lee sus formatos vectoriales con los controladores GDAL y ofrece sus programas en la caja de herramientas de Procesos. Una conversión típica cabe en una línea; esta convierte un shapefile en un GeoPackage y lo reproyecta a la zona UTM utilizada en toda Dinamarca:\n\n```sh\nogr2ogr -f GPKG -t_srs EPSG:25832 parcels.gpkg parcels.shp\n```\n\nEn el momento de redactar este texto, la versión actual es 3.13.3. Pocas herramientas compiten en esta capa. ArcGIS incluye sus propias herramientas de conversión y hay pequeños lectores específicos para formatos individuales, pero un equipo que deba aceptar lo que envíe cualquier cliente suele acabar con GDAL en su pila, a menudo a través de una biblioteca que depende de él.\n\n## Por qué importa\n\nTodo sistema geoespacial tiene una frontera por la que entran datos externos: shapefiles municipales, GeoTIFF de un topógrafo, una exportación GeoJSON de un socio o un KML dibujado en un navegador. GDAL influye en quién se sitúa en esa frontera: una persona que pulsa opciones en una herramienta de escritorio o un script que hace lo mismo cada vez. GDAL abarata escribir ese script.\n\nUna conversión expresada como comando `ogr2ogr` o `gdalwarp` se puede leer en una revisión, guardar en control de versiones y ejecutar de nuevo con la siguiente entrega. Una conversión manual se hace una vez, por quien recuerda los pasos. Para datos que llegan por lotes mes tras mes, esa diferencia decide si se mantiene la calidad.\n\nLa licencia también importa. No hay tarifa por usuario ni aprobación del proveedor; la misma herramienta se ejecuta en un portátil, un servidor de compilación y un contenedor.\n\nLa tercera razón es el acceso al almacenamiento. Los sistemas de archivos virtuales de GDAL permiten que un controlador lea los datos donde están. Con el prefijo `/vsicurl/`, lee un archivo por HTTP solicitando intervalos de bytes: así, la mayoría de los controladores consume un conjunto remoto por partes sin descargarlo entero. `/vsis3/` hace lo mismo en Amazon S3. Si se combina con un Cloud Optimized GeoTIFF, dividido en teselas, con sus propias vistas de resolución reducida y organizado para mantener bajo el número de solicitudes, un ráster de muchos gigabytes puede permanecer en almacenamiento de objetos y leerse ventana a ventana.\n\nTambién hay costes reales. GDAL es una gran biblioteca nativa con muchas dependencias opcionales; los controladores de cada compilación dependen de cómo se compiló. Dos máquinas que «tienen GDAL» pueden abrir formatos distintos. Además, traduce fielmente: también conserva fielmente todos los límites del formato de destino.\n\n## Cómo se aplica en la práctica\n\nGDAL aparece en dos proyectos de este sitio con dos funciones distintas.\n\nDe 2015 a 2022, en el puesto de responsable del equipo de desarrollo de software GIS, se entregaron [más de treinta proyectos GIS, todos con soporte en producción tras su entrega](/es/portfolio/led-30-gis-projects-from-build-to-support/). Debajo estaba PostgreSQL con PostGIS para los datos espaciales; GDAL/OGR los movía entre formatos: shapefiles, GeoJSON, GeoTIFF, KML y teselas vectoriales. QGIS y JOSM se ocupaban del trabajo con los datos, y los mapas se construían con Mapbox GL y Leaflet. Se usaban ambas mitades de la biblioteca: GeoTIFF es ráster y el resto de esa lista, vectorial. Los proyectos abarcaban cartografía digital 2D y 3D, procesamiento LiDAR, georrectificación, vectorización, cartografía de interiores y navegación.\n\nDe 2022 a 2024, en un puesto de ingeniería de datos en un proyecto de análisis geoespacial a gran escala, GDAL fue una de las herramientas para detectar y corregir errores. [Se diagnosticaron y corrigieron errores espaciales con GDAL, QGIS y ArcGIS](/es/portfolio/resolved-1000-issues-in-geographical-data/). Las tareas de limpieza recurrentes se automatizaron con scripts Bash. PostGIS aportaba consultas e índices espaciales; los procedimientos en PL/pgSQL y Transact-SQL transformaban los datos en PostgreSQL y SQL Server, y el resultado limpio alimentaba visualizaciones interactivas con Mapbox. Con GDAL entre las herramientas, la limpieza resolvió más de 1.000 incidencias y fue una de las razones por las que el tiempo de ejecución de las consultas espaciales bajó un 35 %.\n\n## Dónde surgen los problemas\n\nGDAL hace exactamente lo que se le indica. La mayoría de los problemas empieza al indicarle algo ligeramente distinto de lo que se pretendía.\n\n**Los puntos acaban en el continente equivocado.** Desde GDAL 3.0, la biblioteca respeta el orden de ejes fijado por la autoridad que define un sistema de coordenadas. Para EPSG:4326, el conocido sistema de latitud y longitud, va primero la latitud. El código escrito para GDAL 2 pasa primero la longitud, igual que GeoJSON. Al mezclarlos se intercambia cada par: un punto de Copenhague reaparece en el mar Arábigo. Decida un orden en el límite del programa y declárelo. Para código que quiera primero la longitud, el ajuste documentado es `SetAxisMappingStrategy(OAMS_TRADITIONAL_GIS_ORDER)` en la referencia espacial.\n\n**Los nombres de columnas salen recortados y las fechas pierden la hora.** Un shapefile limita los nombres de atributos a 10 caracteres. GDAL acorta los más largos al escribir; si dos nombres acortados coinciden, los reduce a 8 caracteres y añade un número correlativo: `abcdefghijkl` pasa a `abcdefgh_1`. El formato guarda fechas sin hora. GDAL recomienda que los archivos `.shp` y `.dbf` no superen los 2 GB para mantener la interoperabilidad con otro software. El texto danés o cirílico puede volverse ilegible si se identifica mal su codificación cuando falta el archivo `.cpg` que indica la página de códigos. Escriba GeoPackage cuando lo admita el destinatario; si exige shapefile, cambie deliberadamente los nombres de las columnas antes de convertir.\n\n**Se descarga un ráster remoto entero.** Ante una dirección `https://` sin prefijo, GDAL elige su pseudocontrolador HTTP, que descarga el archivo entero en memoria antes de que lo lea cualquier controlador. Sirve para un archivo pequeño, pero no para una ortofoto de todo un país. Añada `/vsicurl/` delante de la dirección para que el controlador obtenga solo los intervalos de bytes necesarios y guarde los ráster grandes como Cloud Optimized GeoTIFF para que sean pocos esos intervalos. Después, no toque el archivo: editar un COG sin crear un archivo nuevo rompe su organización y, desde GDAL 3.8, se rechaza abrirlo para actualizarlo salvo que se permita expresamente romperla.\n\n**Los números de un CSV llegan como texto.** El controlador CSV lee todos los campos como cadenas salvo indicación contraria: una columna de poblaciones se ordena alfabéticamente y una suma posterior produce un error de tipo. Fije la opción de apertura `AUTODETECT_TYPE=YES` o entregue junto al CSV un archivo `.csvt` que indique el tipo de cada columna.\n\n**Una actualización rompe la importación en Python.** El paquete `gdal` de PyPI se compila contra el GDAL ya instalado en la máquina; ambas versiones tienen que coincidir. Las instrucciones de instalación del proyecto fijan la versión del paquete en función de la versión instalada:\n\n```sh\npip install gdal[numpy]==\"$(gdal-config --version).*\"\n```\n\n## Lecturas adicionales\n\n- [Documentación de GDAL](https://gdal.org/en/stable/)\n  — La descripción del propio proyecto de la biblioteca de traducción, sus controladores y su licencia.\n- [Programas](https://gdal.org/en/stable/programs/index.html)\n  — Todas las herramientas de línea de comandos, de `gdalinfo` y `ogr2ogr` al comando `gdal` más reciente.\n- [Sistemas de archivos virtuales de GDAL](https://gdal.org/en/stable/user/virtual_file_systems.html)\n  — `/vsicurl/`, `/vsis3/` y los demás prefijos para leer los datos donde están.\n- [Tutorial de sistemas de referencia de coordenadas y transformación de coordenadas de OGR](https://gdal.org/en/stable/tutorials/osr_api_tut.html)\n  — Con la sección sobre orden de ejes y los cambios de GDAL 3.0.\n- [COG: generador de Cloud Optimized GeoTIFF](https://gdal.org/en/stable/drivers/raster/cog.html)\n  — La organización del archivo, sus vistas de resolución reducida y por qué editar el archivo sin crear otro deshace esa organización.\n\n\u003chttps://engineer.company/es/glossary/gdal/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Qué hace GDAL en una pila geoespacial, cuándo convienen ogr2ogr y gdalwarp y qué errores de orden de ejes y formato deforman los datos convertidos.","formats":{"gemtext":"https://engineer.company/es/glossary/gdal/index.gmi","gopher":"https://engineer.company/es/glossary/gdal/gophermap","html":"https://engineer.company/es/glossary/gdal/","json":"https://engineer.company/es/glossary/gdal/index.json","markdown":"https://engineer.company/es/glossary/gdal/index.md","pdf":"https://engineer.company/es/glossary/gdal/index.pdf"},"kind":"page","language":"es","title":"¿Qué es GDAL?","url":"https://engineer.company/es/glossary/gdal/","version":1}