{"canonical_url":"https://engineer.company/uk/glossary/postgis/","content_markdown":"# PostGIS\n\n## Що це таке\n\nPostGIS — розширення з відкритим кодом для сервера баз даних PostgreSQL, яке дає\nзмогу зберігати в стовпці форму, наприклад адресу доставки, річку чи межу\nземельної ділянки, і звичайним SQL питати, як ці форми розташовані одна щодо\nодної. Воно починалося як дослідницький проєкт у Refractions Research,\nконсалтинговій компанії з ГІС і баз даних, а сьогодні розвивається й\nвипускається як окремий проєкт з відкритим кодом.\n\nРозширення встановлюють у кожну базу окремо однією командою, `CREATE EXTENSION\npostgis;`, і разом із ним з'являються три речі.\n\n- **Просторові типи.** `geometry` описує форми на пласкій площині в тій системі\n  координат, у якій дані зібрали. `geography` описує їх на вигнутій поверхні\n  Землі й вимірює в метрах.\n- **Просторові функції.** Велика родина функцій, назви яких починаються з `ST_`:\n  `ST_Intersects` і `ST_Contains` для взаємного розташування, `ST_Area` і\n  `ST_Length` для вимірювань, `ST_Transform` для переходу між системами\n  координат, `ST_AsGeoJSON` для передачі результату вебкарті.\n- **Просторові індекси.** PostGIS будує R-дерево поверх механізму GiST у\n  PostgreSQL, а для окремих видів даних підтримує ще SP-GiST та індекси\n  діапазонів блоків.\n\nФорми відповідають моделі Simple Features від Open Geospatial Consortium, яку\nтакож ухвалено як ISO 19125: точки, лінії й полігони, їхні складені варіанти та\nколекції змішаних типів. Кожне значення несе SRID — число, яке вказує на рядок у\nтаблиці `spatial_ref_sys` і пояснює, що означають координати. SRID 4326 — це\nдовгота й широта в градусах на датумі WGS 84, у якому рахує GPS. Проєкційна\nсистема натомість вимірює в метрах на схід і на північ від фіксованого початку\nкоординат і точна лише в межах регіону, для якого її створили.\n\nРастрові дані, топологія та частина 3D-операцій винесені в окремі розширення,\n`postgis_raster`, `postgis_topology` і `postgis_sfcgal`, тож база несе лише ті\nчастини, якими справді користується.\n\n## Чому це важливо\n\nPostGIS змушує вирішити, де житимуть дані про місця. Без нього координати\nзазвичай лежать у двох числових стовпцях, а справжня просторова робота\nвідбувається деінде: у коді застосунку, який перебирає рядки й рахує відстані, у\nнастільній ГІС, куди хтось щопонеділка робить експорт, або в окремому геосервісі\nз власною копією даних. Кожна з цих копій поступово розходиться з рештою. З\nPostGIS питання «які клієнти живуть у межах двох кілометрів від складу, де товар є в\nнаявності» стає одним запитом, що об'єднує залишки, дані клієнтів і форми в\nодній транзакції, під тими самими резервними копіями й тими самими правами, що й\nрешта бази.\n\nТак просторові дані отримують гарантії, які решта схеми вже має. Обмеження CHECK\nможе відхилити недійсний полігон ще під час вставки. Row-level security може\nобмежити регіональну команду ділянками її власного регіону. Імпорт, що зламався\nна півдорозі, відкочується, а не лишає по собі половину шару.\n\nДруге рішення — geometry чи geography, і посібник PostGIS говорить про це прямо.\nДані в межах міста чи країни зазвичай найкраще зберігати як `geometry` у\nпроєкції, підібраній саме для цієї території, бо тоді доступний увесь набір\nфункцій, а обчислення швидкі. Дані, що охоплюють континенти, або випадки, коли\nкористувачі хочуть відстань у метрах між будь-якими точками планети, простіше\nзробити правильно з `geography`: цей тип сам рахує на вигнутій поверхні, хоч і\nмає менше функцій.\n\nА іноді відповідь така: PostGIS — більше, ніж потрібно задачі. Застосунку, який\nлише зберігає широту й довготу кожного магазину та ставить шпильки на карті,\nцілком досить двох числових стовпців. PostGIS виправдовує своє місце, коли\nпитання стосуються відстані, вкладеності чи перетину або коли в даних\nз'являються лінії й полігони, а не лише окремі точки.\n\n## Як це виглядає на практиці\n\nКартографічний застосунок, що обслуговував просторові запити в реальному часі\nдля багатьох користувачів, працював із базою даних Microsoft SQL Server, а\nзатримки шкодили і карті, і сервісам за нею.\n[Розв'язанням став перехід на PostgreSQL із\nPostGIS](/uk/portfolio/improved-gis-map-performance-10x-on-postgresql/)\nзі схемою, спроєктованою для просторових даних, індексами GiST і SP-GiST на\nстовпцях geometry та geography й обмеженнями на просторові координати. Понад 50\nмільйонів просторових записів пройшли через ETL-конвеєри, які на вході\nперетворювали їх у EPSG:4326. Середній час відповіді, що становив 2,5 секунди на\nстарій базі даних, скоротився до менш ніж 250 мілісекунд, коли на запити почав\nвідповідати PostGIS, тобто продуктивність зросла у 10 разів, а навантаження на\nCPU бекенду знизилося на 65%. Це приклад міграції заради PostGIS.\n\nІнша робота почалася з даних, а не зі швидкості. Масштабний геопросторовий\nаналіз виявив понад 1 000 невідповідностей у географічних наборах даних і\nчасових рядах. Для пошуку й виправлення просторових помилок використовували\nGDAL, QGIS і ArcGIS, а\n[PostGIS виконував просторові запити й індексацію](/uk/portfolio/resolved-1000-issues-in-geographical-data/);\nпроцедури на PL/pgSQL перетворювали дані всередині PostgreSQL, а очищений\nрезультат показували в Mapbox. Час виконання просторових запитів скоротився\nна 35%.\n\n## Де виникають проблеми\n\n**Відстані повертаються крихітними дробами.** Запит питає, наскільки далеко одне\nвід одного два міста, і отримує `0.08`. Стовпець має тип `geometry` у SRID 4326,\nтож відповідь у градусах, а градус довготи стискається приблизно від 111\nкілометрів на екваторі до нуля на полюсах. Приведіть значення до `geography`,\nщоб отримати метри, або перенесіть дані через `ST_Transform` у проєкційну\nсистему, що підходить для території, і вже тоді вимірюйте.\n\n**Пошук у радіусі читає кожен рядок.** Таблиця має просторовий індекс, а план\nпоказує послідовне сканування. Звична причина — фільтр, записаний як\n`ST_Distance(a, b) \u003c 500`. У списку посібника з функціями, які самі\nвикористовують індекс, є `ST_DWithin`, а `ST_Distance` там немає. Обгортання\nіндексованого стовпця в приведення типу чи трансформацію дає той самий ефект, бо\nіндекс на `geom` нічого не знає про `geom::geography`.\n\n```sql\n-- стовпець geography, індексований як зберігається, відстань у метрах\nCREATE INDEX depots_geog_idx ON depots USING GIST (geog);\n\nSELECT id FROM depots\nWHERE ST_DWithin(geog, ST_MakePoint(12.57, 55.68)::geography, 500);\n```\n\nЯкщо дані мають лишитися в стовпці `geometry` з SRID 4326, додайте стовпець\n`geography`, як у прикладі, й проіндексуйте його або створіть індекс на тому\nсамому виразі, який використовує запит. Після великого завантаження запустіть\n`ANALYZE`, щоб планувальник знав, що індекс вартий уваги.\n\n**Точки опиняються в морі.** Кожна форма зберігає свій малюнок, але стоїть не\nтам, часто на іншому континенті. Таку картину дають дві помилки. `ST_SetSRID`\nлише змінює мітку геометрії й не чіпає чисел, тож якщо викликати його там, де\nмалося на увазі `ST_Transform`, метри отримають штамп градусів. Або десь раніше\nв ланцюжку переплутали довготу й широту: PostGIS, як і GeoJSON, чекає x перед y,\nтобто довготу перед широтою. Використовуйте `ST_SetSRID` лише для того, щоб\nоголосити, чим числа вже є, `ST_Transform` — щоб їх перерахувати, і перевіряйте\nкожен імпорт на одній точці, розташування якої відоме.\n\n**Обчислення площ і перетинів падають з помилкою.** Імпорт із shapefile\nпроходить, а згодом `ST_Intersection` падає з топологічним винятком. PostGIS\nнавмисно зберігає недійсну геометрію, щоб її можна було знайти й виправити, а\nполігон, межа якого перетинає сама себе, недійсний. Перевіряйте через\n`ST_IsValid`, виправляйте через `ST_MakeValid`, який зберігає всі вхідні\nвершини, і додайте обмеження CHECK, щоб погану форму відхиляли на вході, а не\nвиявляли у звіті.\n\n## Що почитати далі\n\n- [PostGIS Documentation](https://postgis.net/documentation/) — власний покажчик\n  проєкту до посібника, FAQ і навчальних матеріалів.\n- [Data Management](https://postgis.net/docs/using_postgis_dbmanagement.html) —\n  geometry і geography, SRID, правила дійсності та три типи індексів так, як їх\n  визначає сам посібник.\n- [Spatial Indexing](https://postgis.net/workshops/postgis-intro/indexing.html)\n  — розділ воркшопу про обмежувальні прямокутники й функції, які користуються\n  індексом без підказки.\n- [ST_DWithin](https://postgis.net/docs/ST_DWithin.html) — довідкова сторінка\n  перевірки відстані з одиницями для кожного типу.\n- [Simple Feature Access – Part 1](https://www.ogc.org/standards/sfa/) —\n  стандарт OGC, на якому стоять типи геометрії, що їх зберігає PostGIS.\n\n\u003chttps://engineer.company/uk/glossary/postgis/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що PostGIS додає до PostgreSQL, коли обирати geometry, а коли geography, і чотири помилки, через які картографічні запити гальмують або помиляються.","formats":{"gemtext":"https://engineer.company/uk/glossary/postgis/index.gmi","gopher":"https://engineer.company/uk/glossary/postgis/gophermap","html":"https://engineer.company/uk/glossary/postgis/","json":"https://engineer.company/uk/glossary/postgis/index.json","markdown":"https://engineer.company/uk/glossary/postgis/index.md","pdf":"https://engineer.company/uk/glossary/postgis/index.pdf"},"kind":"page","language":"uk","title":"Що таке PostGIS?","url":"https://engineer.company/uk/glossary/postgis/","version":1}