QR-innehåll
QR-koder kan innehålla koordinater, objektnamn, anteckningar, projektdelar eller gruppinformation; grupp-QR är därför konfidentiella.
QR-dataformat
QR-import och QR-dataformat
QR-koder i ArxSilex MapTools är ett versionshanterat utbytesformat för kompakta appdata.
Senast uppdaterad: 28 maj 2026
Sammanfattning
Översikt för användning och utveckling
Det här avsnittet sammanfattar vad QR-koder innehåller, hur de kan skapas tekniskt och varför import sker lokalt.
Teknisk kompatibilitet
Egna verktyg kan skapa QR-koder om de följer version, storleksgränser, kodning och valideringsregler.
Lokal import
Länken är ingen uppladdning. Servern behandlar inte payload; appen läser data lokalt från QR-länken.
URL-struktur
QR-länken
QR-koder använder en verifierad HTTPS app-länk. Datablocket finns efter fragmenttecknet.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
Delen efter # skickas normalt inte till webbservern. Därför fungerar samma länk som app-länk och fallback till denna förklaring.
Integritet
Dela konfidentiellt
QR-koder kan innehålla koordinater, objektnamn, anteckningar, projektdelar eller gruppinformation.
Ingen automatisk överföring
QR-data behandlas lokalt. Denna webbplats avkodar eller lagrar inte payload.
Geodata
Platser och projektobjekt kan vara personuppgifter. Dela QR-koder endast med lämpliga mottagare.
Grupper
Grupp-QR innehåller gruppnyckeln. Den som skannar koden kan gå med i gruppen eller importera gruppdata.
Teknisk specifikation
Teknisk specifikation
För närvarande är version 1 dokumenterad. Nyare versioner kan avvisas av äldre appversioner.
| Post | Värde | Notering |
|---|---|---|
| Aktuell HTTPS app-länk | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Sökväg utan avslutande snedstreck; så är Android app-länken registrerad. |
| Dokumentations-URL | https://www.arxsilex.de/app/maptools/qr/index.html | Denna webbdokumentation serveras som index.html i QR-mappen. |
| Äldre scheme | asmaptools://qr?v=1&d=<payload> | Kompatibilitetsformat för äldre eller externa skannrar. |
| Payload-kodning | Base64URL, UTF-8 JSON | URL-säker Base64 utan padding; innehållet är UTF-8 JSON. |
| Schemaversion | v: 1 | Versioner under 1 är ogiltiga; nyare versioner kan avvisas. |
| Payload-gräns | 2,200 bytes | Konservativ gräns för tillförlitlig QR-generering och avkodning. |
| Inkommande URI-gräns | 64 KiB | Hård övre gräns för inkommande deep links. |
| QR-rendering | ZXing QR, error correction M, 512 px | Appen renderar 512 px QR-bitmaps och kan lägga till en liten applogotyp. |
Schema
QR-import och QR-dataformat
Objekt-QR använder korta nycklar för att hålla koden liten. Nycklarna är tekniska identifierare.
| Nyckel | Betydelse | Fält |
|---|---|---|
| v | Schemaversion | integer |
| m | Markörer | i, n, inf, la, lo, ic, cl |
| c | Cirklar | i, n, la, lo, r, cl, sc, fc |
| d | Avstånd | i, n, la, lo, ea, eo, cl |
| b | Bäringar/riktningar | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Områden | i, n, pts, cl, sc, fc |
| r | Rutter | i, n, pts, cl |
Grupper
Typade grupp-payloads
Grupp-QR använder typade JSON-payloads. Gruppnyckeln är konfidentiell.
type: group
Innehåller namn, group_id, group_key, ursprung, färg, beskrivning och valfria snabbmeddelanden.
type: objects
Packar objektdata i ett objects-fält.
type: group_with_objects
Kombinerar grupprofil och valfria objekt. Appen kan importera gruppen, objekten eller båda.
Validering
Validering och gränser
Appen kontrollerar QR-data före import och avvisar ogiltig geometri eller för stora data.
Koordinater
Latitud -90 till 90, longitud -180 till 180. Exporterade koordinater avrundas till 5 decimaler.
Geometri
ID:n måste vara större än 0. Rutter kräver minst 2, områden minst 3 olika punkter.
Bäringar
Bäring 0 till 360 grader, korrigering -180 till 180 grader, längd och intervall högst 1 000 km.
JSON
Exempel
Exempel före Base64URL-kodning. I den riktiga QR-länken ligger kodad JSON i #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
}