QR-dataformat

QR-import og QR-dataformat

QR-koder i ArxSilex MapTools er et versjonert utvekslingsformat for kompakte appdata. Denne siden forklarer bruk, personvern og tekniske detaljer.

Sist oppdatert: 28. mai 2026

Sammendrag

Oversikt for bruk og utvikling

Denne delen oppsummerer hva QR-koder inneholder, hvordan de kan genereres teknisk, og hvorfor import skjer lokalt.

QR-innhold

QR-koder kan inneholde koordinater, objektnavn, notater, prosjektdeler eller gruppeinformasjon; gruppe QR-koder er derfor konfidensielle.

Teknisk kompatibilitet

Egendefinerte verktøy kan generere QR-koder hvis de følger versjonering, størrelsesgrenser, koding og valideringsregler.

Lokal import

Linken er ikke en opplasting. Serveren behandler ikke nyttelasten; appen leser dataene lokalt fra QR-lenken.

URL-struktur

QR-lenken

QR-koder bruker en bekreftet HTTPS-applink. Datablokken plasseres etter fragmenttegnet.

https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>

Delen etter # sendes normalt ikke til webserveren. Den samme lenken kan derfor fungere som en applenke og som en reserve til denne forklaringen.

Privatliv

Del konfidensielt

QR-koder kan inneholde koordinater, objektnavn, notater, prosjektdeler eller gruppeinformasjon.

Ingen automatisk overføring

QR-data behandles lokalt. Denne nettsiden dekoder eller lagrer ikke nyttelasten.

Geodata

Lokasjoner og prosjektobjekter kan være personopplysninger. Del QR-koder kun med passende mottakere.

Grupper

Gruppe-QR-koder inneholder gruppenøkkelen. Alle som skanner koden kan bli med i gruppen eller importere gruppedata.

Teknisk spesifikasjon

Formatstatus

Versjon 1 er for øyeblikket dokumentert. Nyere versjoner kan avvises av eldre appversjoner.

PunktVerdiNotater
Gjeldende HTTPS-applinkhttps://www.arxsilex.de/app/maptools/qr#d=<payload>Sti uten skråstrek; dette er hvordan Android-applenken er registrert.
Dokumentasjons-URLhttps://www.arxsilex.de/app/maptools/qr/Denne nettdokumentasjonen serveres som index.html i QR-mappen.
Arveordningasmaptools://qr?v=1&d=<payload>Kompatibilitetsformat for eldre eller eksterne skannere.
NyttelastkodingBase64URL, UTF-8 JSONURL-sikker Base64 uten polstring; innholdet er UTF-8 JSON.
Skjemaversjonv: 1Versjoner under 1 er ugyldige; nyere versjoner kan avvises.
Nyttelastgrense2200 byteKonservativ hette for pålitelig QR-generering og dekoding.
Innkommende URI-tak64 KiBHard øvre grense for innkommende dyplenker.
QR-gjengivelseZXing QR, feilretting M, 512 pxAppen gjengir 512 px QR punktgrafikk og kan plassere et lite applogooverlegg.

Skjema

Kompakt objektskjema

Objekt QR-koder bruker korttaster for å holde QR-koden liten. Selve nøklene forblir tekniske identifikatorer.

NøkkelBetydningFelter
vSkjemaversjonheltall
mMarkøreri, n, inf, la, lo, ic, cl
cSirkleri, n, la, se, r, cl, sc, fc
dAvstanderi, n, la, se, ea, eo, cl
bAzimuter/retningeri, n, la, se, bg, ln, iv, bc, cl
enOmråderi, n, poeng, cl, fm, fc
rRuteri, n, poeng, cl

Grupper

Innskrevne gruppenyttelaster

Gruppe QR-koder bruker type JSON nyttelast. Gruppenøkkelen er konfidensiell.

type: gruppe

Inneholder navn, gruppe_id, gruppenøkkel, opprinnelse, farge, beskrivelse og valgfrie hurtigmeldinger.

type: objekter

Pakker objektdata i et objektfelt.

type: gruppe_med_objekter

Kombinerer gruppeprofil og valgfrie objekter. Appen kan importere gruppen, objektene eller begge deler.

Validering

Validering og grenser

Appen sjekker QR-data før import og avviser ugyldig geometri eller overdimensjonerte data.

Koordinater

Breddegrad -90 til 90, lengdegrad -180 til 180. Eksporterte koordinater er avrundet til 5 desimaler.

Geometri

IDer må være større enn 0. Ruter trenger minst 2, områder minst 3 forskjellige punkter.

Peilinger

Asimut 0 til 360 grader, korreksjon -180 til 180 grader, lengde og intervall maksimalt 1000 km.

JSON

Eksempler

Eksempler før Base64URL-koding. I den virkelige QR-lenken er kodet JSON plassert 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
}