QR-sisältö
QR-koodit voivat sisältää koordinaatteja, objektien nimiä, muistiinpanoja, projektin osia tai ryhmätietoja; ryhmä-QR on siksi luottamuksellinen.
QR-tietomuoto
QR-tuonti ja QR-tietomuoto
ArxSilex MapToolsin QR-koodit ovat versioitu vaihtomuoto kompakteille sovellustiedoille.
Päivitetty: 28. toukokuuta 2026
Yhteenveto
Yleiskuva käyttöön ja kehitykseen
Tämä osio tiivistää, mitä QR-koodit sisältävät, miten niitä voidaan luoda teknisesti ja miksi tuonti tapahtuu paikallisesti.
Tekninen yhteensopivuus
Omat työkalut voivat luoda QR-koodeja, jos ne noudattavat versiota, kokorajoja, koodausta ja validointisääntöjä.
Paikallinen tuonti
Linkki ei ole lataus palvelimelle. Palvelin ei käsittele payloadia; sovellus lukee datan paikallisesti QR-linkistä.
URL-rakenne
QR-linkki
QR-koodit käyttävät vahvistettua HTTPS-sovelluslinkkiä. Datalohko on fragmenttimerkin jälkeen.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
#-merkin jälkeistä osaa ei yleensä lähetetä web-palvelimelle. Sama linkki toimii siksi sovelluslinkkinä ja paluuna tähän selitykseen.
Tietosuoja
Jaa luottamuksellisesti
QR-koodit voivat sisältää koordinaatteja, objektien nimiä, muistiinpanoja, projektin osia tai ryhmätietoja.
Ei automaattista siirtoa
QR-data käsitellään paikallisesti. Tämä sivusto ei pura eikä tallenna payloadia.
Geodata
Sijainnit ja projektiobjektit voivat olla henkilötietoja. Jaa QR-koodeja vain sopiville vastaanottajille.
Ryhmät
Ryhmä-QR sisältää ryhmäavaimen. Koodin skannaaja voi liittyä ryhmään tai tuoda ryhmätietoja.
Tekninen määritys
Tekninen määritys
Tällä hetkellä dokumentoitu versio on 1. Uudemmat versiot voidaan hylätä vanhemmissa sovellusversioissa.
| Kohta | Arvo | Huomautus |
|---|---|---|
| Nykyinen HTTPS-sovelluslinkki | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Polku ilman lopun kauttaviivaa; näin Android-sovelluslinkki on rekisteröity. |
| Dokumentaation URL | https://www.arxsilex.de/app/maptools/qr/index.html | Tämä web-dokumentaatio tarjotaan QR-kansion index.html-tiedostona. |
| Vanha scheme | asmaptools://qr?v=1&d=<payload> | Yhteensopivuusmuoto vanhoille tai ulkoisille skannereille. |
| Payload-koodaus | Base64URL, UTF-8 JSON | URL-turvallinen Base64 ilman paddingia; sisältö on UTF-8 JSON. |
| Skeemaversio | v: 1 | Alle 1 olevat versiot ovat virheellisiä; uudemmat versiot voidaan hylätä. |
| Payload-raja | 2,200 bytes | Varovainen raja luotettavaan QR-luontiin ja purkuun. |
| Saapuvan URI:n raja | 64 KiB | Kova yläraja saapuville deep linkeille. |
| QR-renderöinti | ZXing QR, error correction M, 512 px | Sovellus renderöi 512 px QR-bittikarttoja ja voi lisätä pienen sovelluslogon. |
Schema
QR-tuonti ja QR-tietomuoto
Objekti-QR käyttää lyhyitä avaimia, jotta koodi pysyy pienenä. Avaimet ovat teknisiä tunnisteita.
| Avain | Merkitys | Kentät |
|---|---|---|
| v | Skeemaversio | integer |
| m | Merkit | i, n, inf, la, lo, ic, cl |
| c | Ympyrät | i, n, la, lo, r, cl, sc, fc |
| d | Etäisyydet | i, n, la, lo, ea, eo, cl |
| b | Suunnat | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Alueet | i, n, pts, cl, sc, fc |
| r | Reitit | i, n, pts, cl |
Ryhmät
Tyypitetyt ryhmä-payloadit
Ryhmä-QR käyttää tyypitettyjä JSON-payloadeja. Ryhmäavain on luottamuksellinen.
type: group
Sisältää nimen, group_id:n, group_keyn, alkuperän, värin, kuvauksen ja valinnaiset pikaviestit.
type: objects
Pakkaa objektidatan objects-kenttään.
type: group_with_objects
Yhdistää ryhmäprofiilin ja valinnaiset objektit. Sovellus voi tuoda ryhmän, objektit tai molemmat.
Validointi
Validointi ja rajat
Sovellus tarkistaa QR-datan ennen tuontia ja hylkää virheellisen geometrian tai liian suuren datan.
Koordinaatit
Leveysaste -90...90, pituusaste -180...180. Viedyt koordinaatit pyöristetään 5 desimaaliin.
Geometria
ID:n on oltava suurempi kuin 0. Reitit tarvitsevat vähintään 2 ja alueet vähintään 3 eri pistettä.
Suunnat
Suunta 0...360 astetta, korjaus -180...180 astetta, pituus ja väli enintään 1 000 km.
JSON
Esimerkit
Esimerkit ennen Base64URL-koodausta. Todellisessa QR-linkissä koodattu JSON on kohdassa #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
}