Вміст QR
QR-коди можуть містити координати, назви об'єктів, нотатки, частини проєкту або групову інформацію; тому групові QR є конфіденційними.
Формат даних QR
QR-імпорт і формат даних QR
QR-коди в ArxSilex MapTools є версійним форматом обміну компактними даними застосунку.
Оновлено: 28 травня 2026
Підсумок
Огляд для використання і розробки
Цей розділ підсумовує, що містять QR-коди, як їх можна технічно створювати і чому імпорт виконується локально.
Технічна сумісність
Власні інструменти можуть створювати QR-коди, якщо дотримуються версії, лімітів розміру, кодування і правил валідації.
Локальний імпорт
Посилання не є завантаженням. Сервер не обробляє payload; застосунок локально читає дані з QR-посилання.
Структура URL
QR-посилання
QR-коди використовують перевірене HTTPS app link. Блок даних розміщено після символу фрагмента.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
Частина після # зазвичай не надсилається вебсерверу. Тому те саме посилання працює як app link і як fallback на це пояснення.
Приватність
Поширюйте конфіденційно
QR-коди можуть містити координати, назви об'єктів, нотатки, частини проєкту або групову інформацію.
Без автоматичної передачі
QR-дані обробляються локально. Цей сайт не декодує і не зберігає payload.
Геодані
Місця та об'єкти проєкту можуть бути персональними даними. Діліться QR-кодами лише з відповідними отримувачами.
Групи
Групові QR-коди містять ключ групи. Той, хто сканує код, може приєднатися до групи або імпортувати її дані.
Технічна специфікація
Технічна специфікація
Наразі задокументовано версію 1. Новіші версії можуть відхилятися старішими версіями застосунку.
| Елемент | Значення | Примітка |
|---|---|---|
| Поточний HTTPS app link | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Шлях без кінцевого слеша; так зареєстровано Android app link. |
| URL документації | https://www.arxsilex.de/app/maptools/qr/index.html | Ця вебдокументація подається як index.html у папці QR. |
| Застаріла scheme | asmaptools://qr?v=1&d=<payload> | Формат сумісності для старих або зовнішніх сканерів. |
| Кодування payload | Base64URL, UTF-8 JSON | URL-safe Base64 без padding; вміст є UTF-8 JSON. |
| Версія схеми | v: 1 | Версії нижче 1 недійсні; новіші можуть бути відхилені. |
| Ліміт payload | 2,200 bytes | Консервативна межа для надійного створення і декодування QR. |
| Ліміт вхідного URI | 64 KiB | Жорстка верхня межа для вхідних deep link. |
| Відтворення QR | ZXing QR, error correction M, 512 px | Застосунок створює QR-бітмапи 512 px і може додати невеликий логотип. |
Schema
QR-імпорт і формат даних QR
Об'єктні QR-коди використовують короткі ключі, щоб код залишався малим. Ключі є технічними ідентифікаторами.
| Ключ | Значення | Поля |
|---|---|---|
| v | Версія схеми | integer |
| m | Маркери | i, n, inf, la, lo, ic, cl |
| c | Кола | i, n, la, lo, r, cl, sc, fc |
| d | Відстані | i, n, la, lo, ea, eo, cl |
| b | Азимути/напрямки | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Області | i, n, pts, cl, sc, fc |
| r | Маршрути | i, n, pts, cl |
Групи
Типізовані групові payload
Групові QR-коди використовують типізовані JSON payload. Ключ групи є конфіденційним.
type: group
Містить name, group_id, group_key, початкову точку, колір, опис і необов'язкові швидкі повідомлення.
type: objects
Пакує дані об'єктів у поле objects.
type: group_with_objects
Поєднує профіль групи й необов'язкові об'єкти. Застосунок може імпортувати групу, об'єкти або обидва.
Валідація
Валідація і ліміти
Застосунок перевіряє QR-дані перед імпортом і відхиляє недійсну геометрію або надто великі дані.
Координати
Широта -90 до 90, довгота -180 до 180. Експортовані координати округлюються до 5 знаків.
Геометрія
ID мають бути більші за 0. Маршрути потребують мінімум 2, області мінімум 3 різні точки.
Азимути
Азимут 0-360 градусів, корекція -180 до 180 градусів, довжина й інтервал до 1 000 км.
JSON
Приклади
Приклади до кодування Base64URL. У реальному QR-посиланні закодований JSON міститься в #d=...
{
"v": 1,
"m": [
{"i":1,"n":"Start","la":48.13715,"lo":11.57612,"ic":"PIN"}
]
}{
"v": 1,
"type": "group",
"name": "Team Alpha",
"group_id": 123456,
"group_key": "shared-secret",
"originLat": 48.13715,
"originLon": 11.57612
}