Conținut QR
Codurile QR pot conține coordonate, nume de obiecte, note, părți de proiect sau informații de grup; QR-urile de grup sunt deci confidențiale.
Format de date QR
Import QR și format de date QR
Codurile QR din ArxSilex MapTools sunt un format de schimb versionat pentru date compacte ale aplicației.
Actualizat: 28 mai 2026
Rezumat
Prezentare pentru utilizare și dezvoltare
Această secțiune rezumă ce conțin codurile QR, cum pot fi generate tehnic și de ce importul se face local.
Compatibilitate tehnică
Instrumentele proprii pot genera QR dacă respectă versiunea, limitele de dimensiune, codarea și regulile de validare.
Import local
Linkul nu este un upload. Serverul nu procesează payload-ul; aplicația citește datele local din linkul QR.
Structura URL
Linkul QR
Codurile QR folosesc un app link HTTPS verificat. Blocul de date este după semnul de fragment.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
Partea de după # nu este trimisă de obicei serverului web. Același link poate funcționa ca app link și ca fallback la această explicație.
Confidențialitate
Partajare confidențială
Codurile QR pot conține coordonate, nume de obiecte, note, părți de proiect sau informații de grup.
Fără transfer automat
Datele QR sunt procesate local. Acest site nu decodează și nu stochează payload-ul.
Geodate
Locațiile și obiectele de proiect pot fi date personale. Partajați QR doar cu destinatari potriviți.
Grupuri
QR-urile de grup conțin cheia grupului. Cine scanează codul poate intra în grup sau importa date de grup.
Specificație tehnică
Specificație tehnică
În prezent este documentată versiunea 1. Versiunile mai noi pot fi refuzate de aplicații mai vechi.
| Element | Valoare | Notă |
|---|---|---|
| App link HTTPS curent | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Cale fără slash final; așa este înregistrat app link-ul Android. |
| URL documentație | https://www.arxsilex.de/app/maptools/qr/index.html | Această documentație web este servită ca index.html în folderul QR. |
| Scheme vechi | asmaptools://qr?v=1&d=<payload> | Format de compatibilitate pentru scanere vechi sau externe. |
| Codare payload | Base64URL, UTF-8 JSON | Base64 sigur pentru URL fără padding; conținutul este JSON UTF-8. |
| Versiune schemă | v: 1 | Versiunile sub 1 sunt invalide; versiunile noi pot fi refuzate. |
| Limită payload | 2,200 bytes | Limită conservatoare pentru generare și decodare QR fiabile. |
| Limită URI primit | 64 KiB | Limită superioară strictă pentru deep link-uri primite. |
| Randare QR | ZXing QR, error correction M, 512 px | Aplicația redă bitmap-uri QR de 512 px și poate adăuga un logo mic. |
Schema
Import QR și format de date QR
QR-urile de obiect folosesc chei scurte pentru a păstra codul mic. Cheile rămân identificatori tehnici.
| Cheie | Semnificație | Câmpuri |
|---|---|---|
| v | Versiune schemă | integer |
| m | Marcaje | i, n, inf, la, lo, ic, cl |
| c | Cercuri | i, n, la, lo, r, cl, sc, fc |
| d | Distanțe | i, n, la, lo, ea, eo, cl |
| b | Azimuturi/direcții | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Zone | i, n, pts, cl, sc, fc |
| r | Rute | i, n, pts, cl |
Grupuri
Payload-uri de grup tipate
QR-urile de grup folosesc payload-uri JSON tipate. Cheia grupului este confidențială.
type: group
Conține nume, group_id, group_key, origine, culoare, descriere și mesaje rapide opționale.
type: objects
Împachetează date de obiect în câmpul objects.
type: group_with_objects
Combină profilul grupului și obiecte opționale. Aplicația poate importa grupul, obiectele sau ambele.
Validare
Validare și limite
Aplicația verifică datele QR înainte de import și refuză geometria invalidă sau datele prea mari.
Coordonate
Latitudine -90 la 90, longitudine -180 la 180. Coordonatele exportate sunt rotunjite la 5 zecimale.
Geometrie
ID-urile trebuie să fie mai mari de 0. Rutele au nevoie de cel puțin 2, zonele de cel puțin 3 puncte distincte.
Azimuturi
Azimut 0-360 grade, corecție -180 la 180 grade, lungime și interval maximum 1.000 km.
JSON
Exemple
Exemple înainte de codarea Base64URL. În linkul QR real, JSON-ul codat este în #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
}