{"canonical_url":"https://engineer.company/uk/glossary/mapbox/","content_markdown":"# Mapbox\n\n## Що це таке\n\nMapbox — це компанія і платформа для розробників, яку вона продає: вона надає\nскладники інтерактивної карти як сервіси, тобто базові дані, стилі, код, що\nмалює карту, і API навколо нього. У коді назва часто з'являється як Mapbox GL,\nза бібліотекою малювання. Посібник компанії для початку роботи називає її\nгеолокаційною платформою, що дає розробникам будівельні блоки для карт, навігації та\nпошуку.\n\nКартографічні дані зберігаються в наборах плиток (tilesets), зазвичай нарізаних\nна векторні плитки, щоб клієнт завантажував лише ту ділянку й той рівень\nмасштабу, які видно на екрані. Mapbox підтримує глобальні базові набори даних, а\nвласні дані команди потрапляють у набір плиток через Mapbox Tiling Service (MTS)\nабо Uploads API. Вигляд визначає стиль. Це документ JSON, написаний за Mapbox\nStyle Specification, який називає свої джерела й перелічує шари; кожен шар\nвибирає об'єкти з одного джерела й описує, як їх малювати. Стилі адресуються\nURL-адресою, наприклад `mapbox://styles/mapbox/streets-v12`, і створюються в\nконсолі облікового запису за допомогою Mapbox Studio, інструмента дизайну.\n\nMapbox GL JS малює результат у браузері, а Maps SDK для iOS і Android роблять це\nв мобільних застосунках. Посібник GL JS, на момент написання у версії 3.33.0,\nкаже, що бібліотека відтворює карти у 2D і 3D за допомогою OpenGL, поєднуючи\nвекторні плитки з правилами стилю в браузері, а не на сервері; саме тому карта\nможе змінити стиль або дані, поки нею хтось користується. Static Images API\nповертає зображення карти, а Static Tiles API віддає растрові плитки, створені\nзі стилів Studio, для бібліотек на кшталт Leaflet. Кожна карта створюється з\nтокеном доступу, і токен прив'язує її до облікового запису Mapbox.\n\nСам формат плиток, специфікація Mapbox Vector Tile, відкрито опублікований на\nGitHub і кодує кожну плитку як повідомлення [Protocol Buffers](https://protobuf.dev/).\n\n## Чому це важливо\n\nВебкарті потрібні код, який її малює, і дані, які малювати, від одного\nпостачальника або від кількох. Mapbox — це відповідь з одним постачальником:\nдані, стилі, відтворення й хостинг під одним обліковим записом і в одному\nрахунку, тож вибір Mapbox — це вибір того, яку частину картографічного стека\nорендувати.\n\nПереваги реальні. Підтримувати базові дані в актуальному стані — чужа робота.\nВигляд карти живе в документі стилю з власним інструментом дизайну, окремо від\nкоду застосунку. Оскільки малювання відбувається в браузері, один набір плиток\nможна показати в кількох стилях, шар можна відфільтрувати або перефарбувати за\nодним клацанням, а та сама карта може показати рельєф у 3D. Для продукту, чий\nголовний екран — це карта, постачальник бере на себе дуже багато роботи.\n\nВитрати приходять з тим самим обліковим записом. GL JS тарифікується за\nзавантаженнями карти, і посібник з цін рахує одне щоразу, коли на сторінці\nініціалізується об'єкт `Map`. Панорамування, масштабування, перемикання шарів і\nзміна стилю всередині цієї карти нічого не додають, а одне завантаження карти\nтриває щонайбільше 12 годин. Токен, на який записується карта, лежить у браузері\nкожного відвідувача. А починаючи з версії 2.0.0, випущеної в грудні 2020 року,\nсам рендерер підпадає під комерційні умови: журнал змін цього випуску каже, що\nGL JS більше не поширюється за 3-Clause BSD license і що оновлення означає згоду\nз умовами обслуговування Mapbox.\n\nТож питання перенесення варто ставити на початку. Формат плиток відкритий.\nMapLibre GL JS почалася як форк mapbox-gl-js з відкритим кодом, зроблений до\nзміни ліцензії. Її гілка 1.x задумувалася як пряма заміна відкритої версії\nMapbox 1.x, а її README каже, що відтоді вона дуже змінилася. Піти з Mapbox\nможна, але це переїзд, і зважити його дешевше до того, як продукт збудують\nнавколо стилів і наборів плиток одного постачальника.\n\n## Як це виглядає на практиці\n\nMapbox відповідав за малювання карти, а завдання полягало в тому, щоб подавати\nйому правильні дані на правильних рівнях масштабування, а не все одразу. Так\nодним рядком підсумовує роль Mapbox сторінка про те, як на посаді «Керівниця\nкоманди розробки GIS‑програмного забезпечення» з 2022 до 2024 року довелося\n[керувати повностековою розробкою GIS-карти, яка розросталася фрагментарно](/uk/portfolio/directed-full-stack-gis-map-development/):\nпросторові дані в PostgreSQL, ReactJS спереду, NodeJS позаду й Mapbox поверх\nусього. Результатом став єдиний інтегрований картографічний застосунок, який\nстав ключовою частиною платформи й приймав нові шари без поломок.\n\nНа тій самій посаді, з 2015 до 2022 року, робота стосувалася\n[процесу проєктування інтерфейсів проєктів](/uk/portfolio/contributed-to-user-interface-design-processes/),\nз фронтендами на React, Angular і Vue поверх карт Mapbox і Leaflet. Думка\nсторінки в тому, що карта — це найпростіша частина: люди губляться в елементах\nкерування, фільтрації та послідовності дій навколо неї, у деталях на кшталт переходу між\nповерхами на карті приміщення.\n\nНа посаді «Інженерка даних» з 2022 до 2024 року завданням було\n[усунути понад 1 000 проблем у географічних даних і часових рядах](/uk/portfolio/resolved-1000-issues-in-geographical-data/)\nза допомогою GDAL, QGIS, ArcGIS, PostGIS і Bash. Очищені дані потім лягли в\nінтерактивні візуалізації на Mapbox, що підвищило доступність даних для кінцевих\nкористувачів. Сторінка пов'язує роботу загалом зі скороченням часу виконання\nпросторових запитів на 35%.\n\n## Де виникають проблеми\n\nБільшість проблем з Mapbox починається, коли карта стикається зі справжнім\nтрафіком, справжніми даними або великим оновленням.\n\n**Рахунок росте разом із переглядами сторінок, а не з використанням карти.**\nЗавантаження карти рахується під час ініціалізації, тож вартість залежить від\nтого, як часто сторінка створює карту. Односторінковий застосунок, який створює\n`Map` заново на кожній зміні маршруту, платить щоразу, і так само платить карта\nвнизу довгої сторінки, до якої більшість відвідувачів так і не доходить.\nПосібник Mapbox про керування витратами на вебкарти радить створювати карту лише\nтоді, коли її контейнер прокручується в поле зору, ховати її за кнопкою «Завантажити карту»\nі використовувати Static Images API там, де панорамувати чи масштабувати нікому\nне треба. Для односторінкового випадку досить одного екземпляра карти, який живе\nміж маршрутами.\n\n**Токен, скопійований зі сторінки, використовують деінде.** Посібник про токени\nпрямо каже, що будь-який токен на публічній вебсторінці або у вихідному коді\nвидно кожному, хто його шукає. Токени із секретними областями доступу (scopes),\nтипу `sk`, мають жити на сервері. Публічний токен `pk` на сторінці має бути\nстворений саме для цього застосунку, з обмеженнями за URL, а не бути типовим\nпублічним токеном облікового запису, до якого такі обмеження додати не можна.\nПосібник називає обмеження за URL заходом, що діє в міру можливостей (best effort) і\nспирається на заголовок referer, який надсилає браузер. Після витоку токен\nротують: створюють новий, замінюють його в коді, розгортають застосунок і лише\nпотім видаляють старий.\n\n**Карта сповільнюється, коли набір даних росте.** Клієнт перетворює джерело\nGeoJSON на векторні плитки на льоту, тож великий файл означає, що нарізанням\nплиток займається браузер кожного відвідувача. Посібник про великі джерела\nGeoJSON перелічує засоби: завантажувати файл за URL, а не з об'єкта JavaScript,\nзнизити `maxzoom` джерела нижче типового 18 (для більшості точкових даних\nпідходить 12), підняти `minzoom` шару вище 0, кластеризувати щільні точки й\nприбрати невикористані властивості та знаки після шостого десяткового. Останній\nкрок зменшує приклад із посібника з 19,3 MB до 3,3 MB. Понад 500 000 точок\nпосібник радить розділити джерело або нарізати плитки на сервері через MTS чи\nUploads API.\n\n```js\nmap.addSource(\"sites\", {\n    type: \"geojson\",\n    data: \"/data/sites.geojson\", // URL, а не об’єкт у пам’яті\n    maxzoom: 12, // типове значення — 18\n    cluster: true, // групувати щільні точки на малому масштабі\n});\nmap.addLayer({\n    id: \"sites\",\n    type: \"circle\",\n    source: \"sites\",\n    minzoom: 6, // приховано нижче рівня масштабу 6\n});\n```\n\n**Велике оновлення змінює ліцензію і рахунок.** Перехід GL JS з 1.x на 2.0.0\nперевів бібліотеку з ліцензії BSD на умови обслуговування Mapbox і змінив\nправило тарифікації. У 1.x завантаження карти потребувало ініціалізації плюс\nзапиту на плитку, розміщену в Mapbox; з 2.0.0 рахується сама ініціалізація, тож\nкарта, яка малювала лише власні плитки, починає генерувати завантаження карти.\nЖурнал змін просить переглянути документацію з цін перед оновленням, а MapLibre\nGL JS — шлях для проєкту, який хоче лишитися на умовах відкритого коду.\n\n## Що почитати далі\n\n- [Getting Started](https://docs.mapbox.com/help/getting-started/) — огляд\n  продуктів компанії для карт, пошуку й навігації.\n- [Mapbox GL JS pricing](https://docs.mapbox.com/mapbox-gl-js/guides/pricing/) —\n  що вважається завантаженням карти, сеанс у 12 годин і старіші правила.\n- [Token management](https://docs.mapbox.com/accounts/guides/tokens/) — публічні\n  й секретні токени, області доступу, обмеження за URL і ротація.\n- [Working with large GeoJSON sources in Mapbox GL JS](https://docs.mapbox.com/help/troubleshooting/working-with-large-geojson-data/)\n  — межі масштабу, кластеризація, очищення і нарізання плиток на сервері.\n- [Mapbox Vector Tile specification](https://github.com/mapbox/vector-tile-spec)\n  — відкритий формат, на якому стоять плитки.\n- [MapLibre GL JS](https://github.com/maplibre/maplibre-gl-js) — рендерер із\n  відкритим кодом, який почався як форк mapbox-gl-js.\n\n\u003chttps://engineer.company/uk/glossary/mapbox/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що Mapbox збирає в одному акаунті, від плиток і стилів Studio до GL JS, як рахуються завантаження карти, і пастки з токеном, ліцензією й обсягом даних.","formats":{"gemtext":"https://engineer.company/uk/glossary/mapbox/index.gmi","gopher":"https://engineer.company/uk/glossary/mapbox/gophermap","html":"https://engineer.company/uk/glossary/mapbox/","json":"https://engineer.company/uk/glossary/mapbox/index.json","markdown":"https://engineer.company/uk/glossary/mapbox/index.md","pdf":"https://engineer.company/uk/glossary/mapbox/index.pdf"},"kind":"page","language":"uk","title":"Що таке Mapbox?","url":"https://engineer.company/uk/glossary/mapbox/","version":1}