Obsah QR
QR kódy mohou obsahovat souřadnice, názvy objektů, poznámky, části projektu nebo informace o skupině; skupinové QR jsou proto důvěrné.
Datový formát QR
Import QR a datový formát QR
QR kódy v ArxSilex MapTools jsou verzovaný výměnný formát pro kompaktní data aplikace.
Aktualizováno: 28. května 2026
Souhrn
Přehled pro použití a vývoj
Tato část shrnuje, co QR kódy obsahují, jak je lze technicky vytvářet a proč import probíhá lokálně.
Technická kompatibilita
Vlastní nástroje mohou vytvářet QR kódy, pokud dodržují verzi, limity velikosti, kódování a validační pravidla.
Lokální import
Odkaz není upload. Server payload nezpracovává; aplikace čte data lokálně z QR odkazu.
Struktura URL
QR odkaz
QR kódy používají ověřený HTTPS app link. Datový blok je za znakem fragmentu.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
Část za # se obvykle neposílá webovému serveru. Stejný odkaz proto funguje jako app link i jako náhradní vysvětlení.
Soukromí
Sdílet důvěrně
QR kódy mohou obsahovat souřadnice, názvy objektů, poznámky, části projektu nebo informace o skupině.
Žádný automatický přenos
QR data se zpracovávají lokálně. Tento web payload nedekóduje ani neukládá.
Geodata
Polohy a projektové objekty mohou být osobními údaji. Sdílejte QR kódy jen s vhodnými příjemci.
Skupiny
Skupinové QR kódy obsahují skupinový klíč. Kdo kód naskenuje, může se připojit ke skupině nebo importovat její data.
Technická specifikace
Technická specifikace
Aktuálně je dokumentována verze 1. Novější verze mohou starší aplikace odmítnout.
| Položka | Hodnota | Poznámka |
|---|---|---|
| Aktuální HTTPS app link | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Cesta bez koncového lomítka; tak je registrován Android app link. |
| URL dokumentace | https://www.arxsilex.de/app/maptools/qr/index.html | Tato webová dokumentace je poskytována jako index.html ve složce QR. |
| Starší schéma | asmaptools://qr?v=1&d=<payload> | Kompatibilní formát pro starší nebo externí skenery. |
| Kódování payloadu | Base64URL, UTF-8 JSON | URL-safe Base64 bez paddingu; obsahem je UTF-8 JSON. |
| Verze schématu | v: 1 | Verze menší než 1 jsou neplatné; novější verze mohou být odmítnuty. |
| Limit payloadu | 2,200 bytes | Konzervativní limit pro spolehlivé vytvoření a dekódování QR. |
| Limit příchozího URI | 64 KiB | Pevná horní hranice pro příchozí deep linky. |
| Vykreslení QR | ZXing QR, error correction M, 512 px | Aplikace vykresluje 512 px QR bitmapy a může přidat malé logo aplikace. |
Schema
Import QR a datový formát QR
Objektové QR kódy používají krátké klíče, aby QR kód zůstal malý. Klíče zůstávají technickými identifikátory.
| Klíč | Význam | Pole |
|---|---|---|
| v | Verze schématu | integer |
| m | Značky | i, n, inf, la, lo, ic, cl |
| c | Kruhy | i, n, la, lo, r, cl, sc, fc |
| d | Vzdálenosti | i, n, la, lo, ea, eo, cl |
| b | Azimuty/směry | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Oblasti | i, n, pts, cl, sc, fc |
| r | Trasy | i, n, pts, cl |
Skupiny
Typované skupinové payloady
Skupinové QR kódy používají typované JSON payloady. Skupinový klíč je důvěrný.
type: group
Obsahuje název, group_id, group_key, původ, barvu, popis a volitelné rychlé zprávy.
type: objects
Balí objektová data do pole objects.
type: group_with_objects
Kombinuje profil skupiny a volitelné objekty. Aplikace může importovat skupinu, objekty nebo obojí.
Validace
Validace a limity
Aplikace kontroluje QR data před importem a odmítá neplatnou geometrii nebo příliš velká data.
Souřadnice
Šířka -90 až 90, délka -180 až 180. Exportované souřadnice se zaokrouhlují na 5 desetinných míst.
Geometrie
ID musí být větší než 0. Trasy potřebují alespoň 2 a oblasti alespoň 3 různé body.
Azimuty
Azimut 0 až 360 stupňů, korekce -180 až 180 stupňů, délka a interval nejvýše 1 000 km.
JSON
Příklady
Příklady před kódováním Base64URL. Ve skutečném QR odkazu je zakódovaný JSON v #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
}