QR-inhoud
QR-codes kunnen coördinaten, objectnamen, notities, projectdelen of groepsinformatie bevatten; groeps-QR-codes zijn daarom vertrouwelijk.
QR-gegevensformaat
QR-import en QR-gegevensformaat
QR-codes in ArxSilex MapTools zijn een geversioneerd uitwisselingsformaat voor compacte appgegevens.
Bijgewerkt: 28 mei 2026
Samenvatting
Overzicht voor gebruik en ontwikkeling
Dit gedeelte vat samen wat QR-codes bevatten, hoe ze technisch kunnen worden gemaakt en waarom import lokaal gebeurt.
Technische compatibiliteit
Eigen tools kunnen QR-codes maken als ze versie, groottebeperkingen, codering en validatieregels respecteren.
Lokale import
De link is geen upload. De server verwerkt de payload niet; de app leest de gegevens lokaal uit de QR-link.
URL-structuur
De QR-link
QR-codes gebruiken een geverifieerde HTTPS-app-link. Het datablok staat na het fragmentteken.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
Het deel na # wordt normaal niet naar de webserver gestuurd. Dezelfde link werkt daardoor als app-link en als terugval naar deze uitleg.
Privacy
Vertrouwelijk delen
QR-codes kunnen coördinaten, objectnamen, notities, projectdelen of groepsinformatie bevatten.
Geen automatische overdracht
QR-gegevens worden lokaal verwerkt. Deze website decodeert of bewaart de payload niet.
Geodata
Locaties en projectobjecten kunnen persoonsgegevens zijn. Deel QR-codes alleen met passende ontvangers.
Groepen
Groeps-QR-codes bevatten de groepssleutel. Wie de code scant, kan toetreden tot de groep of groepsgegevens importeren.
Technische specificatie
Technische specificatie
Momenteel is versie 1 gedocumenteerd. Nieuwere versies kunnen door oudere appversies worden geweigerd.
| Item | Waarde | Opmerking |
|---|---|---|
| Huidige HTTPS-app-link | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Pad zonder slash aan het einde; zo is de Android-app-link geregistreerd. |
| Documentatie-URL | https://www.arxsilex.de/app/maptools/qr/index.html | Deze webdocumentatie staat als index.html in de QR-map. |
| Verouderd schema | asmaptools://qr?v=1&d=<payload> | Compatibiliteitsformaat voor oudere of externe scanners. |
| Payload-codering | Base64URL, UTF-8 JSON | URL-veilige Base64 zonder padding; de inhoud is UTF-8-JSON. |
| Schemaversie | v: 1 | Versies onder 1 zijn ongeldig; nieuwere versies kunnen worden geweigerd. |
| Payloadlimiet | 2,200 bytes | Conservatieve grens voor betrouwbare QR-generatie en decodering. |
| Limiet voor inkomende URI | 64 KiB | Harde bovengrens voor inkomende deep links. |
| QR-weergave | ZXing QR, error correction M, 512 px | De app rendert 512 px QR-bitmaps en kan een klein app-logo plaatsen. |
Schema
QR-import en QR-gegevensformaat
Object-QR-codes gebruiken korte sleutels om de QR-code klein te houden. De sleutels blijven technische identifiers.
| Sleutel | Betekenis | Velden |
|---|---|---|
| v | Schemaversie | integer |
| m | Markeringen | i, n, inf, la, lo, ic, cl |
| c | Cirkels | i, n, la, lo, r, cl, sc, fc |
| d | Afstanden | i, n, la, lo, ea, eo, cl |
| b | Peilingen/richtingen | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Gebieden | i, n, pts, cl, sc, fc |
| r | Routes | i, n, pts, cl |
Groepen
Getypeerde groepspayloads
Groeps-QR-codes gebruiken getypeerde JSON-payloads. De groepssleutel is vertrouwelijk.
type: group
Bevat naam, group_id, group_key, oorsprong, kleur, beschrijving en optionele korte berichten.
type: objects
Verpakt objectgegevens in een objects-veld.
type: group_with_objects
Combineert groepsprofiel en optionele objecten. De app kan groep, objecten of beide importeren.
Validatie
Validatie en limieten
De app controleert QR-gegevens vóór import en weigert ongeldige geometrie of te grote gegevens.
Coördinaten
Breedte -90 tot 90, lengte -180 tot 180. Geëxporteerde coördinaten worden op 5 decimalen afgerond.
Geometrie
ID's moeten groter zijn dan 0. Routes hebben minstens 2, gebieden minstens 3 verschillende punten nodig.
Peilingen
Peiling 0 tot 360 graden, correctie -180 tot 180 graden, lengte en interval maximaal 1.000 km.
JSON
Voorbeelden
Voorbeelden vóór Base64URL-codering. In de echte QR-link staat de gecodeerde JSON 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
}