Вбудуйте карту

Востаннє оновлено 9 листопада 2026

Публічне API повертає шестикутники, які малює карта, для останнього оновлення або збереженого дня, без сирих позицій літаків. Повна схема — в OpenAPI 3.1.

Вбудовування карти

Жива карта вільна для вбудовування. Підходить для новинних сайтів, дослідницьких проєктів, блогів і навчальних сторінок, яким потрібна жива карта, на яку можна посилатися, без її створення.

Вставте це туди, де вона має з'явитися:

<iframe src="https://gpsinterference.com/embed" width="640" height="400"
        style="border:0;width:100%;max-width:960px" loading="lazy"
        title="Жива карта перешкод GPS"></iframe>
<p>Жива карта: <a href="https://gpsinterference.com/uk/">Перешкоди GPS</a></p>

Скористайтеся конструктором нижче й скопіюйте код або додайте параметри вручну.

Район Стиль карти Мова Висота px Висота польоту Дата Підписи Утримувати читачів у цьому районі

<iframe src="https://gpsinterference.com/embed" width="640" height="400"
        style="border:0;width:100%;max-width:960px" loading="lazy"
        title="Жива карта перешкод GPS"></iframe>
<p>Жива карта: <a href="https://gpsinterference.com/uk/">Перешкоди GPS</a></p>

Параметри

Додайте будь-які з них до https://gpsinterference.com/embed, поєднуючи через &:

Параметр	Значення	Що робить
`region`	`baltic-sea`, `eastern-europe`, `black-sea`, `eastern-mediterranean`, `middle-east`, `east-asia`, `south-southeast-asia`, `western-europe`, `balkans`, `oceania`, `africa`, `americas`, `finland`, `estonia`, `latvia`, `lithuania`, `kaliningrad`, `poland`, `norway`, `romania`, `turkey`, `cyprus`, `israel`, `lebanon`, `south-korea`, `north-korea`, `japan`, `china`, `taiwan`, `philippines`, `vietnam`, `south-africa`, `morocco`, `algeria`, `kenya`, `senegal`, `tunisia`, `botswana`, `india`, `pakistan`, `myanmar`, `thailand`, `cambodia`, `malaysia`, `singapore`, `indonesia`, `sweden`, `denmark`, `germany`, `iceland`, `united-kingdom`, `ukraine`, `belarus`, `moldova`, `bulgaria`, `georgia`, `armenia`, `azerbaijan`, `greece`, `egypt`, `iran`, `iraq`, `syria`, `jordan`, `saudi-arabia`, `united-arab-emirates`, `qatar`, `austria`, `russia`, `persian-gulf`, `united-states`, `canada`, `mexico`, `cuba`, `venezuela`, `colombia`, `brazil`, `argentina`, `chile`, `france`, `spain`, `portugal`, `italy`, `ireland`, `netherlands`, `belgium`, `switzerland`, `serbia`, `croatia`, `bosnia-and-herzegovina`, `albania`, `slovenia`, `north-macedonia`, `australia`, `new-zealand`, `hungary`, `czechia`, `slovakia`, `paraguay`, `uruguay`, `peru`, `oman`, `nepal`, `bangladesh`, `bolivia`, `cameroon`	Відкривається на цьому регіоні, підлаштованому під розмір рамки.
`bbox`	south,west,north,east	Відкривається на будь-якому районі, у градусах, наприклад `bbox=30,-120,40,-105`.
`lat`, `lon`, `zoom`	числа	Відкривається на центрі та масштабі замість району.
`lock`	`1`	Утримує читачів у районі: вони можуть у ньому переміщувати й масштабувати, але не віддалятися від нього.
`style`	`satellite` (типово), `globe`, `dark`, `light`, `streets`	Карта, на якій лежать шестикутники: темна, чиста світла карта для білих сторінок, вулиці або супутник із кордонами та назвами місць. Карти від MapTiler.
`lang`	`auto`, `en`, `no`, `uk`, `pl`, `tr`, `es`, `fr`, `de`, `ar`, `zh`, `he`, `ru`, `ja`	Мова тексту карти: `auto` бере мову браузера читача, або вкажіть один код. Без параметра — англійська. Сторінки регіонів використовують свою мову.
`names`	`on`, `off` (типово)	Назви місць на карті.
`alt`	`all` (типово), `low`, `mid`, `high`, `cruise`	Показує лише літаки одного діапазону висот: нижче 5 000 футів, 5 000–15 000 футів, 15 000–30 000 футів або понад 30 000 футів (барометричні). Дні, збережені до запису висот, показують усі літаки.
`date`	YYYY-MM-DD	Показує збережений день замість останньої карти, для історії про цей день.

Останнє вікно

GET https://api.gpsinterference.com/v1/interference/latest

GET https://api.gpsinterference.com/interference.json повертає той самий документ, що використовує карта. Він містить одну добу польотів UTC, history_date, і перебудовується раз на добу близько 05:00 UTC.

Одна доба UTC

GET https://api.gpsinterference.com/v1/interference/YYYY-MM-DD

Карта такою, якою вона була під час останнього оновлення тієї доби UTC (а не підрахунок лише польотів цієї дати). Вона має ті самі поля, що й останнє зведення, плюс archive_date і complete. complete хибне, поки доба ще сьогоднішня й може бути замінена; завершена доба не змінюється ніколи. Дата без збереженої карти повертає 404 і {"error":"no archive"}.

GET https://api.gpsinterference.com/v1/interference/days перелічує кожен збережений день: date, updated і hexes (кількість), без полігонів.

Денний ряд

GET https://api.gpsinterference.com/v1/interference/series/SLUG — денний ряд одного регіону, країни або світу: один рядок на збережений день, від найстарішого, з кількістю шестикутників і літаків та pct, часткою охоплених ділянок (червоні та жовті шестикутники серед усіх). Slug — адреса сторінки, як у /region/baltic-sea, або world. Кожна сторінка регіону показує це в розділі З часом.

Увесь набір даних

Щоб отримати набір даних цілком, наприклад усі збережені доби одразу, напишіть на contact@libregps.com, а не запитуйте його добу за добою.

Поля шестикутника

Поле	Значення
`h`	Ідентифікатор комірки, `column_row` на сітці шестикутників Web Mercator.
`g`	Різні літаки в комірці, чий NACp залишався вище 7.
`b`	Різні літаки, які повідомили NACp 7 або нижче принаймні раз у комірці.
`p`	Частка уражених у відсотках з одним знаком після коми: `100 × b ÷ (g + b)`. Колір береться з цього.
`c`	`g` менше 3%, `y` від 3% до 10%, `r` понад 10%, `p` понад 50% щонайменше при 12 уражених літаках, з округленого `p`.
`poly`	Кільце пар `[latitude, longitude]` у градусах.

Комірки — це пласкі шестикутники на сітці Web Mercator з радіусом 0,34° довготи (близько 38 км від центру до кута на екваторі, 22 км на 54° пн. ш.). Комірки з менш ніж 3 літаками пропускаються.

bands (зведення з 26 жовтня 2026) ділить ті самі підрахунки за барометричною висотою: edges_ft — [5000, 15000, 30000], а hexes містить чотири списки: нижче 5 000 футів, 5 000–15 000 футів, 15 000–30 000 футів і понад 30 000 футів. Кожен запис — { h, g, b }, з полігоном і часткою, узятими із шестикутника з тим самим h в основному списку (p = 100 × b ÷ (g + b), ті самі пороги для c). Діапазон пропускає комірки з менш ніж 3 літаками в цьому діапазоні. Літак, що змінює діапазон у комірці, враховується в кожному, тож чотири діапазони не складаються до основних підрахунків; літаки на землі або без висоти є лише в основних підрахунках.

Поля верхнього рівня: history_date — доба UTC, у яку відбулися польоти; updated — коли зведення було записано (UTC); grid — mercator-r0.34; window_minutes — 1440, одна доба; sources — adsb.lol-globe-history плюс випуск adsb.lol, з якого створено, наприклад adsb.lol-prod-0. У зведень, збережених до 26 жовтня 2026, може бракувати history_date, і вони містять polled_points, grid_points та failed_points зі старого збору наживо.

Кешування, CORS і обмеження

Останнє зведення, збережена сьогоднішня доба та індекс дат надсилаються з cache-control: public, max-age=60, а завершена доба — з max-age=86400.

CORS у браузері дозволено лише для https://gpsinterference.com і https://www.gpsinterference.com, тож інші сайти не можуть читати JSON у браузерах своїх відвідувачів (curl і серверні запити це не стосується). Фіксованого ліміту запитів немає, але дуже часті запити можуть обмежувати. Дані змінюються раз на добу, тож орієнтуйтеся на заголовки кешу, а не опитуйте постійно.

Зазначення джерела

Дані про літаки — з історії globe на adsb.lol, поширюваної за Відкритою ліцензією на бази даних (ODbL). Цитуйте https://gpsinterference.com. Низька заявлена точність — це не підтверджене глушіння й не вказує на джерело. Тайли основи карти окремі й не входять до цього API.

Кожна JSON-відповідь починається з поля attribution, і кожна відповідь має заголовок X-Attribution. Якщо ви використовуєте ці цифри будь-де, зокрема у відповіді ШІ-асистента, назвіть GPSInterference.com і дайте посилання на https://gpsinterference.com. Досить Source: GPSInterference.com (https://gpsinterference.com/).

Денні записи

Кожен збережений день має власну сторінку із заголовком, який показувала карта, таблицею регіонів, де кожен шестикутник рахується один раз, серією для світу та цитуванням: усі збережені дні, останній — 8 листопада 2026 р..

Цитування даних

Цитуйте збережену добу, яку ви використали. Найновіша карта змінюється щодня; збережена доба — ні.

APA

GPSInterference.com. (2026). GPS interference hexagon data [Data set]. https://gpsinterference.com/docs

Один збережений день:

GPSInterference.com. (2026). GPS interference hexagon data, 25 October 2026 [Data set]. https://api.gpsinterference.com/v1/interference/2026-10-25

BibTeX

@dataset{gpsinterference_2026,
  author       = {{GPSInterference.com}},
  title        = {GPS Interference Hexagon Data},
  year         = {2026},
  publisher    = {GPSInterference.com},
  url          = {https://gpsinterference.com/docs},
  note         = {Built from ADS-B flight tracks from adsb.lol globe history, available under the Open Database License (ODbL). Low reported accuracy (NACp 7 or lower) is not confirmed jamming. For one UTC day, use https://api.gpsinterference.com/v1/interference/YYYY-MM-DD}
}

Приклади

curl -sS "https://api.gpsinterference.com/v1/interference/latest"
curl -sS "https://api.gpsinterference.com/v1/interference/2026-10-25"

У JavaScript, на цьому сайті чи на сервері:

const res = await fetch("https://api.gpsinterference.com/v1/interference/latest");
if (!res.ok) throw new Error(String(res.status));
const data = await res.json();
// data.hexes[i] is { h, g, b, p, c, poly }

Методологія пояснює, як робляться підрахунки.