{"canonical_url":"https://engineer.company/uk/glossary/geojson/","content_markdown":"# GeoJSON\n\n## Що це таке\n\nGeoJSON — відкритий формат для обміну об'єктами карти, тобто точками, лініями й\nплощами разом із відомостями про них, у вигляді одного звичайного документа\nJSON. Його стандартизовано в IETF як RFC 7946 у серпні 2016 року на заміну\nспецифікації спільноти, вперше опублікованої 2008 року. Текст GeoJSON\nпередається з типом медіа application/geo+json і зазвичай зберігається з\nрозширенням .geojson, хоча звичайне .json теж зареєстроване.\n\nУ форматі є три види об'єктів, і кожен указує свій вид у полі «type».\n\n- **Geometry** — це форма. Типів сім: Point, MultiPoint, LineString,\n  MultiLineString, Polygon, MultiPolygon і GeometryCollection. Це фігури моделі\n  Simple Features від Open Geospatial Consortium (OGC), ті самі, що їх кодування\n  WKT і WKB передають у текстовому та двійковому вигляді.\n- **Feature** — це одна річ на карті: геометрія, об'єкт «properties» з її\n  атрибутами й необов'язковий «id». Геометрія може бути null, якщо місце об'єкта\n  невідоме.\n- **FeatureCollection** містить список об'єктів у полі «features». Саме його\n  містять більшість файлів і відповідей API.\n\nОдин об'єкт для розумного лічильника виглядає так:\n\n```json\n{\n    \"type\": \"Feature\",\n    \"id\": \"meter-0417\",\n    \"geometry\": {\n        \"type\": \"Point\",\n        \"coordinates\": [12.5683, 55.6761]\n    },\n    \"properties\": {\n        \"name\": \"Meter 417\",\n        \"installed\": \"2023-04-12\"\n    }\n}\n```\n\nКожна позиція — це масив чисел: спершу довгота, потім широта, а далі\nнеобов'язкова висота в метрах. Специфікація вимагає саме такого порядку для\nперших двох, тож точка вище лежить у центрі Копенгагена, на 12,57 градуса\nсхідної довготи й 55,68 градуса північної широти. Усі координати використовують\nодну систему відліку — довготу й широту на WGS 84 у десяткових градусах, яку OGC\nпозначає як CRS84. Версія 2008 року дозволяла файлу вказати іншу систему в полі\n«crs». У RFC 7946 це поле прибрано, бо змішані системи відліку спричиняли\nпроблеми сумісності, а іншу систему допущено лише там, де всі сторони\nзаздалегідь про неї домовилися.\n\nПолігони мають власні правила. Кожне кільце замкнене, має щонайменше чотири\nпозиції, і остання повторює першу. Перше кільце — зовнішня межа, а наступні\nкільця, якщо вони є, — це отвори. RFC 7946 додає правило правої руки: зовнішні\nкільця йдуть проти годинникової стрілки, а отвори — за нею. Проте версія 2008\nроку про напрямок обходу нічого не казала, тому парсерам належить приймати\nполігони, що це правило порушують.\n\n## Чому це важливо\n\nУсе, що читає JSON, прочитає й GeoJSON. Браузер розбирає його без плагіна,\nбібліотека вебкарт малює його напряму, а документна база даних зберігає як є.\nRFC 7946 називає бібліотеки вебкарт на JavaScript, документні бази даних на\nоснові JSON і веб-API місцями, де формат широко використовують. Таке поширення\nробить його звичним вибором, коли картографічні дані виходять із настільної GIS\nна вебсторінку чи в API.\n\nНа ньому будуються й стандарти. OGC API – Features, стандарт OGC для надання\nгеографічних об'єктів через HTTP, рекомендує GeoJSON усюди, де дані можна в\nньому подати. Сервер, що пропонує GeoJSON, повертає FeatureCollection для списку\nоб'єктів і окремий Feature для одного, обидва як application/geo+json, а його\nтипова система відліку — ті самі довгота й широта на WGS 84, які фіксує GeoJSON.\n\nТі самі проєктні рішення задають і межі формату.\n\n- **Одна система відліку.** Дані в національній сітці координат треба\n  перетворити на довготу й широту перед записом і перетворити назад у кожного\n  споживача, який рахує в метрах.\n- **Лише прості фігури.** Типи геометрії охоплюють точки, лінії з прямих\n  відрізків і полігони. Криві, тривимірні тіла на кшталт 3D-моделей міст і\n  координати поза WGS 84 лишаються за межами формату, і OGC API – Features\n  наводить саме ці випадки як приклади даних, яких GeoJSON передати не може.\n- **Розмір.** Кожну координату записано десятковими цифрами, а FeatureCollection\n  — це одне значення JSON, яке звичайний парсер JSON читає до останнього байта,\n  перш ніж віддати хоч один об'єкт. RFC 8142 визначає GeoJSON Text Sequences з\n  типом медіа application/geo+json-seq, де кожен запис містить один текст\n  GeoJSON, тож як завгодно великі набори даних можна читати поступово.\n- **Без спільних меж.** Два сусідні полігони зберігають свою спільну межу кожен\n  повністю, тож межу записано двічі, і правка однієї копії може відкрити щілину\n  чи перекриття.\n\nRFC 7946 прямо каже й про те, що формат лишає іншим. Власного захисту\nконфіденційності чи цілісності GeoJSON не дає, тож дані під час передавання\nпокладаються на TLS. Розділ про безпеку попереджає, що публікація розташування\nвразливих людей, тварин, середовищ існування чи об'єктів може наразити їх на\nстеження або шкоду, і що розмиття позицій в анонімізованому наборі даних навряд\nчи зупинить цілеспрямовану атаку.\n\n## Як це виглядає на практиці\n\nУ\n[понад тридцяти GIS-проєктах, які було побудовано, розгорнуто й підтримувано в продакшні](/uk/portfolio/led-30-gis-projects-from-build-to-support/),\nGeoJSON був одним із форматів, між якими GDAL/OGR переносив дані, поряд із\nshapefiles, GeoTIFF, KML і векторними тайлами. Під усім цим просторові дані\nзберігав PostgreSQL із PostGIS, фронтендом були вебкарти на Mapbox GL і Leaflet,\nа безпосередньо з даними працювали в QGIS і JOSM.\n\nСистему відліку треба визначити раніше за все це. Під час\n[міграції з MSSQL на PostgreSQL із розширенням PostGIS](/uk/portfolio/improved-gis-map-performance-10x-on-postgresql/)\nпонад 50 мільйонів просторових записів пройшли через ETL-пайплайни, кроки\nтрансформації яких привели їх до стандарту SRID EPSG:4326. Цей код позначає той\nсамий датум WGS 84 у градусах, який фіксує GeoJSON, а в посібнику PostGIS\nзазначено, що вивід функції ST_AsGeoJSON відповідає RFC 7946 для геометрії в\nEPSG:4326 без жодного перетворення.\n\n## Де виникають проблеми\n\n**Точки опиняються в чужому морі.** Шар данських адрес з'являється посеред\nАравійського моря, а кожна перевірка діапазону все одно проходить, бо обидва\nчисла — коректні градуси. Широту й довготу переставили місцями на вході.\nEPSG:4326 формально ставить широту перед довготою, багато джерел даних цього\nдотримуються, а GeoJSON очікує довготу першою. Кожну позицію слід будувати з\nіменованих полів, а не з порядку стовпців, і тримати тестовий об'єкт за відомою\nадресою, щоб перестановку ловив тест, а не перегляд карти.\n\n**Координати приходять у метрах.** Шар зникає з карти або клієнт його відхиляє,\nа у файлі стоять координати в сотнях тисяч там, де мають бути градуси. Геометрію\nзберігали в проєктованій національній системі координат і експортували як є.\nСпершу її треба перетворити на довготу й широту за допомогою `ST_Transform(geom,\n4326)` у PostGIS. Без перетворення ST_AsGeoJSON типово додає поле «crs», те\nсаме, яке в RFC 7946 прибрано.\n\n**Полігони малюються навиворіт в одному клієнті.** Зона обслуговування заливає\nвсю карту, крім власної фігури, тоді як інші інструменти малюють той самий файл\nправильно. Цей клієнт розрізняє внутрішнє й зовнішнє за напрямком кожного\nкільця, а кільця йдуть у протилежний бік, що версія 2008 року дозволяла.\nПосібник PostGIS зазначає, що деякі клієнти вимагають правила правої руки, тож\nйого варто застосувати перед експортом через `ST_ForcePolygonCCW(geom)` і\nперевірити результат у кожному клієнті, який його споживає.\n\n**Файли несуть більше цифр, ніж потрібно карті.** Шар детальних полігонів\nзавантажується на телефоні кілька секунд, а координати мають дев'ять і більше\nзнаків після коми. ST_AsGeoJSON типово записує до дев'яти знаків, а RFC 7946\nзазначає, що перехід від шести до п'ятнадцяти знаків може майже подвоїти розмір\nтексту, тоді як шість знаків уже дають точність близько 10 см. Варто передати\nменше значення `maxdecimaldigits` і спершу зменшити точність через\n`ST_ReducePrecision`, бо посібник PostGIS попереджає, що обрізання цифр лише під\nчас виводу може зробити геометрію невалідною.\n\n**Внутрішні стовпці потрапляють у properties.** Публічний endpoint повертає\nімена власників, суми витрат чи нотатки, що мали лишитися в базі даних.\nОтримавши цілий рядок, ST_AsGeoJSON кладе в «properties» кожен стовпець, крім\nгеометрії. Слід вибрати в підзапиті лише стовпці, призначені для публікації, і,\nу PostGIS 3.5 чи новішому, назвати ключовий стовпець, щоб він став «id» об'єкта:\n\n```sql\nSELECT json_build_object(\n  'type', 'FeatureCollection',\n  'features', json_agg(ST_AsGeoJSON(m.*, id_column =\u003e 'id')::json)\n)\nFROM (SELECT id, name, geom FROM meters) AS m;\n```\n\n## Що почитати далі\n\n- [RFC 7946: The GeoJSON Format](https://www.rfc-editor.org/rfc/rfc7946) —\n  стандарт IETF із типами об'єктів, порядком координат, правилом обходу,\n  порадами щодо точності й міркуваннями безпеки.\n- [RFC 8142: GeoJSON Text Sequences](https://www.rfc-editor.org/rfc/rfc8142) —\n  супутній формат, що ділить великий набір даних на окремі тексти GeoJSON, по\n  одному на запис.\n- [ST_AsGeoJSON](https://postgis.net/docs/ST_AsGeoJSON.html) — сторінка\n  посібника PostGIS про експорт геометрії та цілих рядків у GeoJSON, з\n  параметрами точності й опціями.\n- [EPSG:4326 WGS 84](https://epsg.org/crs_4326/WGS-84.html) — запис реєстру, у\n  якому порядок осей ставить широту першою, протилежно до GeoJSON.\n- [OGC API – Features – Part 1: Core](https://docs.ogc.org/is/17-069r4/17-069r4.html)\n  — стандарт OGC, що рекомендує GeoJSON для надання об'єктів через HTTP.\n\n\u003chttps://engineer.company/uk/glossary/geojson/\u003e\n","date_modified":"2026-10-20T21:59:50Z","description":"Як GeoJSON зберігає об'єкти карти для браузерів і веб-API, чому довгота в координатах іде першою, і помилки, що зсувають точки чи роздувають файли.","formats":{"gemtext":"https://engineer.company/uk/glossary/geojson/index.gmi","gopher":"https://engineer.company/uk/glossary/geojson/gophermap","html":"https://engineer.company/uk/glossary/geojson/","json":"https://engineer.company/uk/glossary/geojson/index.json","markdown":"https://engineer.company/uk/glossary/geojson/index.md","pdf":"https://engineer.company/uk/glossary/geojson/index.pdf"},"kind":"page","language":"uk","title":"Що таке GeoJSON?","url":"https://engineer.company/uk/glossary/geojson/","version":1}