Вбудуйте карту
Востаннє оновлено
Публічне API повертає шестикутники, які малює карта, для останнього оновлення або збереженого дня, без сирих позицій літаків. Повна схема — в OpenAPI 3.1.
Джерело: GPSInterference.com, https://gpsinterference.com/uk/docs. Вільне використання за умови зазначення цього джерела й посилання.
Вбудовування карти
Жива карта вільна для вбудовування. Підходить для новинних сайтів, дослідницьких проєктів, блогів і навчальних сторінок, яким потрібна жива карта, на яку можна посилатися, без її створення.
Скористайтеся конструктором нижче й скопіюйте код або додайте параметри вручну.
Параметри
Додайте будь-які з них до 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, strait-of-hormuz, gulf-of-finland, india-pakistan-border, taiwan-strait, south-china-sea, 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, osm, osm-dark | Карта, на якій лежать шестикутники: темна, чиста світла карта для білих сторінок, вулиці або супутник із кордонами та назвами місць. Карти від MapTiler. osm — це OpenStreetMap від OpenFreeMap: стиль для ефіру й друку, вільний для публікації із зазначенням джерела. osm-dark — та сама мапа в темних кольорах, з тим самим зазначенням джерела. |
lang | auto, en, no, uk, pl, tr, es, fr, de, ar, zh, he, ru, ja, fi | Мова тексту карти: 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. Кожна сторінка регіону показує це в розділі З часом.
Деякі графіки регіонів позначають події з джерелами нумерованими значками: до трьох у поданнях за 30 і 90 днів, п'ять за останній рік і два довгострокові зсуви за всі дні, а також подію в найвищій точці графіка. Ряд містить їх як events, кожну з датою, категорією, назвою, джерелом і views, що її позначають. Позначка означає, що подія сталася приблизно тоді ж, коли зміна, а не що вона її викликала.
Увесь набір даних
Щоб завантажити багато діб одразу, наприклад місяць, рік або всі збережені доби, скористайтеся сторінкою завантаження, а не запитуйте їх добу за добою.
Поля шестикутника
| Поле | Значення |
|---|---|
h | Ідентифікатор комірки, column_row на сітці шестикутників Web Mercator. |
g | Різні літаки в комірці, чий NACp залишався вище 7. |
b | Різні літаки, які повідомили NACp 7 або нижче принаймні раз у комірці. |
p | Частка уражених у відсотках з одним знаком після коми: 100 × b ÷ (g + b). Колір береться з цього. |
c | g менше 3%, y від 3% до 10% і r понад 10%, обидва щонайменше при 2 уражених літаках (1 уражений літак — завжди g), 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 і серверні запити це не стосується). Запити з інших сайтів і скриптів обмежено 120 на хвилину з однієї адреси; понад це API відповідає кодом 429 із заголовком Retry-After. Дані змінюються раз на добу, тож орієнтуйтеся на заголовки кешу, а не опитуйте постійно.
Зазначення джерела
Дані про літаки — з історії globe на adsb.lol, поширюваної за Відкритою ліцензією на бази даних (ODbL). Цитуйте https://gpsinterference.com. Низька заявлена точність — це не підтверджене глушіння й не вказує на джерело. Тайли основи карти окремі й не входять до цього API.
Кожна JSON-відповідь починається з поля attribution, і кожна відповідь має заголовок X-Attribution. Якщо ви використовуєте ці цифри будь-де, зокрема у відповіді ШІ-асистента, назвіть GPSInterference.com і дайте посилання на https://gpsinterference.com. Досить Source: GPSInterference.com (https://gpsinterference.com/).
Денні записи
Кожен збережений день має власну сторінку із заголовком, який показувала карта, таблицею регіонів, де кожен шестикутник рахується один раз, серією для світу та цитуванням: усі збережені дні, останній — 14 листопада 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-25BibTeX
@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 }Методологія пояснює, як робляться підрахунки.
