QR-indhold
QR-koder kan indeholde koordinater, objektnavne, noter, projektdele eller gruppeoplysninger; gruppe-QR er derfor fortrolige.
QR-dataformat
QR-import og QR-dataformat
QR-koder i ArxSilex MapTools er et versioneret udvekslingsformat til kompakte appdata.
Senest opdateret: 28. maj 2026
Sammenfatning
Overblik for brug og udvikling
Dette afsnit opsummerer, hvad QR-koder indeholder, hvordan de teknisk kan oprettes, og hvorfor import sker lokalt.
Teknisk kompatibilitet
Egne værktøjer kan oprette QR-koder, hvis de følger version, størrelsesgrænser, kodning og valideringsregler.
Lokal import
Linket er ikke en upload. Serveren behandler ikke payload; appen læser data lokalt fra QR-linket.
URL-struktur
QR-linket
QR-koder bruger et verificeret HTTPS app-link. Datablokken står efter fragmenttegnet.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
Delen efter # sendes normalt ikke til webserveren. Derfor virker samme link som app-link og som fallback til denne forklaring.
Privatliv
Del fortroligt
QR-koder kan indeholde koordinater, objektnavne, noter, projektdele eller gruppeoplysninger.
Ingen automatisk overførsel
QR-data behandles lokalt. Dette websted dekoder eller gemmer ikke payload.
Geodata
Placeringer og projektobjekter kan være persondata. Del kun QR-koder med passende modtagere.
Grupper
Gruppe-QR indeholder gruppenøglen. Den, der scanner koden, kan deltage i gruppen eller importere gruppedata.
Teknisk specifikation
Teknisk specifikation
Aktuelt er version 1 dokumenteret. Nyere versioner kan afvises af ældre appversioner.
| Element | Værdi | Note |
|---|---|---|
| Aktuelt HTTPS app-link | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Sti uden afsluttende slash; sådan er Android app-link registreret. |
| Dokumentations-URL | https://www.arxsilex.de/app/maptools/qr/index.html | Denne webdokumentation serveres som index.html i QR-mappen. |
| Ældre scheme | asmaptools://qr?v=1&d=<payload> | Kompatibilitetsformat til ældre eller eksterne scannere. |
| Payload-kodning | Base64URL, UTF-8 JSON | URL-sikker Base64 uden padding; indholdet er UTF-8 JSON. |
| Skemaversion | v: 1 | Versioner under 1 er ugyldige; nyere versioner kan afvises. |
| Payload-grænse | 2,200 bytes | Konservativ grænse for pålidelig QR-generering og dekodning. |
| Indgående URI-grænse | 64 KiB | Fast øvre grænse for indgående deep links. |
| QR-rendering | ZXing QR, error correction M, 512 px | Appen renderer 512 px QR-bitmaps og kan lægge et lille app-logo på. |
Schema
QR-import og QR-dataformat
Objekt-QR bruger korte nøgler for at holde koden lille. Nøglerne er tekniske identifikatorer.
| Nøgle | Betydning | Felter |
|---|---|---|
| v | Skemaversion | integer |
| m | Markører | i, n, inf, la, lo, ic, cl |
| c | Cirkler | i, n, la, lo, r, cl, sc, fc |
| d | Afstande | i, n, la, lo, ea, eo, cl |
| b | Pejlinger/retninger | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Områder | i, n, pts, cl, sc, fc |
| r | Ruter | i, n, pts, cl |
Grupper
Typede gruppe-payloads
Gruppe-QR bruger typede JSON-payloads. Gruppenøglen er fortrolig.
type: group
Indeholder navn, group_id, group_key, oprindelse, farve, beskrivelse og valgfrie hurtigbeskeder.
type: objects
Pakker objektdata i et objects-felt.
type: group_with_objects
Kombinerer gruppeprofil og valgfrie objekter. Appen kan importere gruppen, objekterne eller begge dele.
Validering
Validering og grænser
Appen kontrollerer QR-data før import og afviser ugyldig geometri eller for store data.
Koordinater
Bredde -90 til 90, længde -180 til 180. Eksporterede koordinater afrundes til 5 decimaler.
Geometri
ID'er skal være større end 0. Ruter kræver mindst 2, områder mindst 3 forskellige punkter.
Pejlinger
Pejling 0 til 360 grader, korrektion -180 til 180 grader, længde og interval højst 1.000 km.
JSON
Eksempler
Eksempler før Base64URL-kodning. I det rigtige QR-link ligger kodet 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
}