Contenuti QR
I QR possono contenere coordinate, nomi oggetto, note, parti di progetto o informazioni di gruppo; i QR di gruppo sono quindi riservati.
Formato dati QR
Importazione QR e formato dati QR
I codici QR di ArxSilex MapTools sono un formato di scambio versionato per dati compatti dell'app. Questa pagina spiega uso, privacy e dettagli tecnici.
Ultimo aggiornamento: 28 maggio 2026
Riepilogo
Panoramica per uso e sviluppo
Questa sezione riassume cosa contengono i codici QR, come possono essere generati tecnicamente e perché l'importazione avviene localmente.
Compatibilità tecnica
Strumenti propri possono generare QR se rispettano versione, limiti di dimensione, codifica e regole di validazione.
Importazione locale
Il link non è un upload. Il server non elabora il payload; l'app legge i dati localmente dal link QR.
Struttura URL
Il link QR
I codici QR usano un app link HTTPS verificato. Il blocco dati è dopo il segno di frammento.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
La parte dopo # normalmente non viene inviata al server web. Lo stesso link può quindi funzionare come app link e fallback a questa spiegazione.
Privacy
Condividere in modo riservato
I QR possono contenere coordinate, nomi oggetti, note, parti di progetto o informazioni di gruppo.
Nessun trasferimento automatico
I dati QR sono elaborati localmente. Questo sito non decodifica né conserva il payload.
Geodati
Posizioni e oggetti di progetto possono essere dati personali. Condividi QR solo con destinatari adatti.
Gruppi
I QR di gruppo contengono la chiave del gruppo. Chi scansiona il codice può unirsi al gruppo o importare dati del gruppo.
Specifica tecnica
Stato del formato
Attualmente è documentata la versione 1. Versioni più nuove possono essere rifiutate da app più vecchie.
| Voce | Valore | Nota |
|---|---|---|
| Current HTTPS app link | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Percorso senza slash finale; così è registrato l'app link Android. |
| Documentation URL | https://www.arxsilex.de/app/maptools/qr/index.html | Questa documentazione web è servita come index.html nella cartella QR. |
| Legacy scheme | asmaptools://qr?v=1&d=<payload> | Formato compatibile con lettori vecchi o esterni. |
| Payload encoding | Base64URL, UTF-8 JSON | Base64 sicuro per URL senza padding; il contenuto è JSON UTF-8. |
| Schema version | v: 1 | Versioni sotto 1 non sono valide; versioni nuove possono essere rifiutate. |
| Payload limit | 2,200 bytes | Limite prudente per generare e decodificare QR in modo affidabile. |
| Incoming URI cap | 64 KiB | Limite massimo per deep link in ingresso. |
| QR rendering | ZXing QR, error correction M, 512 px | The app renders 512 px QR bitmaps and may place a small app logo overlay. |
Schema
Schema compatto degli oggetti
I QR oggetto usano chiavi brevi per restare piccoli. Le chiavi sono identificatori tecnici.
| Chiave | Significato | Campi |
|---|---|---|
| v | Versione schema | integer |
| m | Marker | i, n, inf, la, lo, ic, cl |
| c | Cerchi | i, n, la, lo, r, cl, sc, fc |
| d | Distanze | i, n, la, lo, ea, eo, cl |
| b | Rilevamenti/direzioni | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Aree | i, n, pts, cl, sc, fc |
| r | Rotte | i, n, pts, cl |
Groups
Payload di gruppo tipizzati
I QR di gruppo usano JSON tipizzato. La chiave del gruppo è riservata.
type: group
Contiene nome, group_id, group_key, origine, colore, descrizione e messaggi rapidi opzionali.
type: objects
Racchiude dati oggetto in un campo objects.
type: group_with_objects
Combina profilo gruppo e oggetti opzionali. L'app può importare gruppo, oggetti o entrambi.
Validation
Validazione e limiti
L'app controlla i dati QR prima dell'importazione e rifiuta geometria non valida o dati troppo grandi.
Coordinate
Latitudine -90 a 90, longitudine -180 a 180. Le coordinate esportate sono arrotondate a 5 decimali.
Geometria
Gli ID devono essere maggiori di 0. Le rotte richiedono almeno 2 punti distinti e le aree almeno 3.
Rilevamenti
Rilevamento da 0 a 360 gradi, correzione da -180 a 180 gradi, lunghezza e intervallo massimo 1.000 km.
JSON
Esempi
Esempi prima della codifica Base64URL. Nel link QR reale, il JSON codificato è in #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
}