QR-innhold
QR-koder kan inneholde koordinater, objektnavn, notater, prosjektdeler eller gruppeinformasjon; gruppe-QR er derfor konfidensielle.
QR-dataformat
QR-import og QR-dataformat
QR-koder i ArxSilex MapTools er et versjonert utvekslingsformat for kompakte appdata.
Sist oppdatert: 28. mai 2026
Sammendrag
Oversikt for bruk og utvikling
Dette avsnittet oppsummerer hva QR-koder inneholder, hvordan de teknisk kan lages, og hvorfor import skjer lokalt.
Teknisk kompatibilitet
Egne verktøy kan lage QR-koder hvis de følger versjon, størrelsesgrenser, koding og valideringsregler.
Lokal import
Lenken er ingen opplasting. Serveren behandler ikke payload; appen leser data lokalt fra QR-lenken.
URL-struktur
QR-lenken
QR-koder bruker en verifisert HTTPS app-lenke. Datablokken står etter fragmenttegnet.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
Delen etter # sendes normalt ikke til webserveren. Derfor kan samme lenke fungere som app-lenke og fallback til denne forklaringen.
Personvern
Del konfidensielt
QR-koder kan inneholde koordinater, objektnavn, notater, prosjektdeler eller gruppeinformasjon.
Ingen automatisk overføring
QR-data behandles lokalt. Dette nettstedet dekoder eller lagrer ikke payload.
Geodata
Plasseringer og prosjektobjekter kan være persondata. Del QR-koder bare med passende mottakere.
Grupper
Gruppe-QR inneholder gruppenøkkelen. Den som skanner koden kan bli med i gruppen eller importere gruppedata.
Teknisk spesifikasjon
Teknisk spesifikasjon
For øyeblikket er versjon 1 dokumentert. Nyere versjoner kan avvises av eldre appversjoner.
| Element | Verdi | Merknad |
|---|---|---|
| Gjeldende HTTPS app-lenke | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Sti uten avsluttende skråstrek; slik er Android app-lenken registrert. |
| Dokumentasjons-URL | https://www.arxsilex.de/app/maptools/qr/index.html | Denne webdokumentasjonen serveres som index.html i QR-mappen. |
| Eldre scheme | asmaptools://qr?v=1&d=<payload> | Kompatibilitetsformat for eldre eller eksterne skannere. |
| Payload-koding | Base64URL, UTF-8 JSON | URL-sikker Base64 uten padding; innholdet er UTF-8 JSON. |
| Skjemaversjon | v: 1 | Versjoner under 1 er ugyldige; nyere versjoner kan avvises. |
| Payload-grense | 2,200 bytes | Konservativ grense for pålitelig QR-generering og dekoding. |
| Inngående URI-grense | 64 KiB | Hard øvre grense for inngående deep links. |
| QR-rendering | ZXing QR, error correction M, 512 px | Appen renderer 512 px QR-bitmaps og kan legge på en liten applogo. |
Schema
QR-import og QR-dataformat
Objekt-QR bruker korte nøkler for å holde koden liten. Nøklene er tekniske identifikatorer.
| Nøkkel | Betydning | Felt |
|---|---|---|
| v | Skjemaversjon | integer |
| m | Markører | i, n, inf, la, lo, ic, cl |
| c | Sirkler | i, n, la, lo, r, cl, sc, fc |
| d | Avstander | i, n, la, lo, ea, eo, cl |
| b | Peilinger/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 bruker typede JSON-payloads. Gruppenøkkelen er konfidensiell.
type: group
Inneholder navn, group_id, group_key, opprinnelse, farge, beskrivelse og valgfrie hurtigmeldinger.
type: objects
Pakker objektdata i et objects-felt.
type: group_with_objects
Kombinerer gruppeprofil og valgfrie objekter. Appen kan importere gruppen, objektene eller begge deler.
Validering
Validering og grenser
Appen kontrollerer QR-data før import og avviser ugyldig geometri eller for store data.
Koordinater
Breddegrad -90 til 90, lengdegrad -180 til 180. Eksporterte koordinater avrundes til 5 desimaler.
Geometri
ID-er må være større enn 0. Ruter trenger minst 2, områder minst 3 ulike punkter.
Peilinger
Peiling 0 til 360 grader, korreksjon -180 til 180 grader, lengde og intervall maks 1 000 km.
JSON
Eksempler
Eksempler før Base64URL-koding. I den ekte QR-lenken 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
}