{"canonical_url":"https://engineer.company/uk/glossary/gdal/","content_markdown":"# GDAL\n\n## Що це таке\n\nGDAL (Geospatial Data Abstraction Library; часто пишуть GDAL/OGR) — це програмне\nзабезпечення з відкритим кодом, яке відкриває геодані, збережені в одному\nформаті, і записує їх в іншому, а за потреби ще й перепроєктовує дорогою. Власна\nдокументація проєкту називає його «translator library», тобто\nбібліотекою-перекладачем.\n\nГеодані бувають двох видів. Растрові — це сітка комірок: супутниковий знімок,\nаерофото, цифрова модель рельєфу. Векторні — точки, лінії й полігони з\nатрибутами: адреси, дороги, межі земельних ділянок. GDAL дає програмі, яка його\nвикликає, одну абстрактну модель для кожного виду, а під моделлю стоїть окремий\nдрайвер для кожного формату. GeoTIFF, JPEG 2000 і NetCDF належать до растрової\nчастини, Shapefile, GeoJSON, GeoPackage, KML і таблиці PostgreSQL — до\nвекторної, і форматів обох видів значно більше. Програма, написана поверх GDAL,\nчитає їх усі тими самими викликами.\n\nВекторна частина багато років називалася OGR, і дві половини мали окремі\nструктури драйверів, доки GDAL 2.0 їх не об'єднав. Тому векторні утиліти досі\nносять старий префікс: `ogrinfo` описує векторний набір даних, а `ogr2ogr` його\nконвертує. Роботу над бібліотекою почав Френк Вармердам наприкінці 1998 року.\nВона поширюється під ліцензією в стилі MIT і є проєктом Open Source Geospatial\nFoundation (OSGeo).\n\nКористуються нею трьома способами. З командного рядка: `gdalinfo`,\n`gdal_translate` і `gdalwarp` для растрів, `ogrinfo` і `ogr2ogr` для векторів. З\nверсії 3.11 є ще й єдина команда `gdal` з підкомандами на кшталт `gdal raster` і\n`gdal vector`, яку проєкт досі позначає як попередню. З коду — через прив'язки\nдо Python та інших мов. І всередині іншого програмного забезпечення: QGIS,\nнаприклад, читає векторні формати через драйвери GDAL і виставляє утиліти GDAL у\nсвоєму наборі інструментів Processing. Типова конвертація вміщується в один\nрядок; тут shapefile стає GeoPackage і водночас перепроєктовується в зону UTM\n36N, у якій лежить Київ:\n\n```sh\nogr2ogr -f GPKG -t_srs EPSG:32636 dilianky.gpkg dilianky.shp\n```\n\nНа момент написання поточний випуск — 3.13.3. Конкурентів на цьому рівні\nнебагато. ArcGIS має власні інструменти конвертації, а для окремих форматів\nіснують невеликі самостійні читачі, але команда, якій треба приймати те, що\nнадсилає замовник, зазвичай так чи інакше отримує GDAL у своєму стеку, часто\nтому, що на ньому побудована вже обрана бібліотека.\n\n## Чому це важливо\n\nКожна система геоданих має межу, де дані ззовні потрапляють усередину: shapefile\nвід міської ради, GeoTIFF від геодезиста, експорт GeoJSON від партнера, файл\nKML, який хтось накреслив у браузері. Рішення тут — хто стоїть на цій межі. Це\nможе бути людина, яка проклацує настільну програму, або скрипт, що щоразу робить\nте саме. GDAL робить такий скрипт дешевим.\n\nКонвертацію, записану як команда `ogr2ogr` чи `gdalwarp`, можна прочитати під\nчас рев'ю, тримати в системі контролю версій і запустити знову, коли прийде\nнаступна поставка. Конвертацію вручну роблять один раз, і робить її той, хто\nпам'ятає кроки. Для даних, що надходять частинами місяць за місяцем, саме ця\nрізниця визначає, чи втримається якість.\n\nЛіцензія теж має значення. Платити не треба ні за користувача, ні за машину,\nпогодження постачальника не потрібне, і той самий інструмент працює на ноутбуці,\nна сервері збірки й у контейнері.\n\nТретя причина — доступ до сховища. Віртуальні файлові системи GDAL дозволяють\nдрайверу читати дані там, де вони лежать. З префіксом `/vsicurl/` файл читається\nчерез HTTP запитами окремих діапазонів байтів, тож більшість драйверів може\nчитати віддалений набір даних частинами, не завантажуючи його повністю, а\n`/vsis3/` робить те саме з Amazon S3. У парі з Cloud Optimized GeoTIFF — файлом,\nрозбитим на плитки, з власними оглядовими рівнями й компонуванням, що тримає\nкількість запитів низькою, — растр на багато гігабайтів може лежати в об'єктному\nсховищі й читатися по одному фрагменту.\n\nВитрати теж реальні. GDAL — велика нативна бібліотека з багатьма необов'язковими\nзалежностями, і набір драйверів у конкретній інсталяції залежить від того, як її\nзібрано. Дві машини, на кожній з яких «є GDAL», можуть відкривати різні формати.\nА ще він перекладає сумлінно, і це означає, що так само сумлінно він переносить\nусі обмеження формату, у який його просять писати.\n\n## Як це виглядає на практиці\n\nGDAL трапляється у двох проєктах на цьому сайті, і в кожному в іншій ролі.\n\nЗ 2015 до 2022 року роль керівниці команди розробки GIS-програмного забезпечення\nохоплювала\n[понад тридцять GIS-проєктів від розробки й розгортання до підтримки](/uk/portfolio/led-30-gis-projects-from-build-to-support/).\nВ основі лежав PostgreSQL із PostGIS для просторових даних, а GDAL/OGR переносив\nїх між форматами: shapefile, GeoJSON, GeoTIFF, KML і векторні плитки. QGIS і\nJOSM служили для самої роботи з даними, а вебкарти над ними будувалися на Mapbox\nGL і Leaflet. Цим переліком форматів обслуговували весь діапазон робіт: цифрову\nкартографію у 2D і 3D, обробку LiDAR, георектифікацію, векторизацію, карти\nприміщень і навігацію в них. Кожен проєкт після запуску підтримувався в\nпродакшні.\n\nЗ 2022 до 2024 року, на посаді інженерки даних у масштабному проєкті\nгеопросторової аналітики, GDAL був одним з інструментів пошуку й виправлення\nпомилок.\n[Просторові помилки діагностувалися й виправлялися за допомогою GDAL, QGIS та ArcGIS](/uk/portfolio/resolved-1000-issues-in-geographical-data/),\nа оскільки ті самі завдання з очищення поверталися знову й знову, їх\nавтоматизували скриптами на Bash. PostGIS відповідав за просторові запити й\nіндексацію, процедури на PL/pgSQL і Transact-SQL перетворювали дані в PostgreSQL\nі SQL Server, а очищені дані потрапляли в інтерактивні візуалізації на Mapbox.\nБуло усунено понад 1 000 проблем, і ця робота сприяла скороченню часу виконання\nпросторових запитів на 35%.\n\n## Де виникають проблеми\n\nGDAL робить саме те, що йому сказали. Більшість проблем з'являється тоді, коли\nсказали трохи не те, що мали на увазі.\n\n**Точки опиняються не на тому континенті.** Починаючи з GDAL 3.0 бібліотека\nдотримується порядку осей, який визначив орган, що веде систему координат, і для\nEPSG:4326, звичної системи широти й довготи, першою йде широта. Код, написаний\nпід GDAL 2, передає першою довготу, і GeoJSON теж. Якщо змішати ці два підходи,\nкожна пара міняється місцями, і точка в Києві з'являється на південному заході\nІрану. Оберіть один порядок на межі програми й задокументуйте його. У коді,\nякому потрібна довгота першою, задокументований перемикач —\n`SetAxisMappingStrategy(OAMS_TRADITIONAL_GIS_ORDER)` на об'єкті просторової\nприв'язки.\n\n**Назви колонок обрізаються, а дати втрачають час.** Shapefile обмежує назви\nатрибутів 10 символами. GDAL скорочує довші назви під час запису, а коли дві\nскорочені назви збігаються, урізає їх до 8 символів і додає порядковий номер,\nтож `abcdefghijkl` перетворюється на `abcdefgh_1`. Формат зберігає дати без\nчасу. Для сумісності з іншим програмним забезпеченням GDAL рекомендує, щоб\nрозмір файлів `.shp` і `.dbf` не перевищував 2 ГБ. Кирилиця може стати\nнечитабельною, якщо кодування визначено неправильно за відсутності файла\n`.cpg`, що вказує кодування. Пишіть GeoPackage, де одержувач це\nдозволяє. Де shapefile обов'язковий, перейменуйте колонки свідомо ще до\nконвертації.\n\n**Віддалений растр завантажується цілком.** Якщо дати GDAL звичайну адресу\n`https://` без префікса, він обере свій HTTP-псевдодрайвер, який завантажує весь\nфайл у пам'ять, перш ніж його прочитає справжній драйвер. Для маленького файлу\nце годиться, для ортофотоплану всієї країни — ні. Додайте перед адресою\n`/vsicurl/`, щоб драйвер брав лише потрібні діапазони байтів, і зберігайте\nвеликі растри як Cloud Optimized GeoTIFF, щоб цих діапазонів було мало. А потім\nне чіпайте файл: редагування COG на місці ламає його компонування, і з GDAL 3.8\nспроба відкрити його для оновлення відхиляється, якщо явно не дозволити таке\nпорушення.\n\n**Числа з CSV приходять як текст.** Драйвер CSV читає кожне поле як текст, якщо\nне сказати інакше, тож колонка з чисельністю населення сортується за абеткою, а\nсума десь далі в ланцюжку завершується помилкою типу. Увімкніть параметр\nвідкриття `AUTODETECT_TYPE=YES` або покладіть поруч із CSV файл `.csvt` з типом\nкожної колонки.\n\n**Оновлення ламає імпорт у Python.** Пакет `gdal` на PyPI збирається під уже\nвстановлений на машині GDAL, тож версії мають збігатися. Інструкція проєкту зі\nвстановлення прив'язує одну до одної:\n\n```sh\npip install gdal[numpy]==\"$(gdal-config --version).*\"\n```\n\n## Що почитати далі\n\n- [GDAL documentation](https://gdal.org/en/stable/) — власний опис\n  бібліотеки-перекладача, її драйверів і ліцензії.\n- [Programs](https://gdal.org/en/stable/programs/index.html) — усі утиліти\n  командного рядка, від `gdalinfo` і `ogr2ogr` до нової команди `gdal`.\n- [GDAL Virtual File Systems](https://gdal.org/en/stable/user/virtual_file_systems.html)\n  — `/vsicurl/`, `/vsis3/` та інші префікси для читання даних там, де вони\n  лежать.\n- [OGR Coordinate Reference Systems and Coordinate Transformation tutorial](https://gdal.org/en/stable/tutorials/osr_api_tut.html)\n  — з розділом про порядок осей і те, що змінилося в GDAL 3.0.\n- [COG – Cloud Optimized GeoTIFF generator](https://gdal.org/en/stable/drivers/raster/cog.html)\n  — компонування файлу, оглядові рівні й чому редагування на місці їх ламає.\n\n\u003chttps://engineer.company/uk/glossary/gdal/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що робить GDAL у геопросторовому стеку, коли варто братися за ogr2ogr і gdalwarp, і пастки порядку осей та форматів, що псують конвертовані дані.","formats":{"gemtext":"https://engineer.company/uk/glossary/gdal/index.gmi","gopher":"https://engineer.company/uk/glossary/gdal/gophermap","html":"https://engineer.company/uk/glossary/gdal/","json":"https://engineer.company/uk/glossary/gdal/index.json","markdown":"https://engineer.company/uk/glossary/gdal/index.md","pdf":"https://engineer.company/uk/glossary/gdal/index.pdf"},"kind":"page","language":"uk","title":"Що таке GDAL?","url":"https://engineer.company/uk/glossary/gdal/","version":1}