QR-sisältö
QR-koodit voivat sisältää koordinaatteja, objektien nimiä, muistiinpanoja, projektiosia tai ryhmätietoja; Ryhmän QR-koodit ovat siksi luottamuksellisia.
QR-tietomuoto
QR-tuonti ja QR-tietomuoto
ArxSilex MapTools:n QR-koodit ovat versioitu vaihtomuoto kompaktille sovellusdatalle. Tämä sivu selittää käytön, yksityisyyden ja tekniset tiedot.
Viimeksi päivitetty: 28. toukokuuta 2026
Yhteenveto
Yleiskatsaus käyttöön ja kehittämiseen
Tässä osiossa on yhteenveto siitä, mitä QR-koodit sisältävät, kuinka ne voidaan luoda teknisesti ja miksi tuonti tapahtuu paikallisesti.
Tekninen yhteensopivuus
Mukautetut työkalut voivat luoda QR-koodeja, jos ne noudattavat versiointia, kokorajoituksia, koodaus- ja validointisääntöjä.
Paikallinen tuonti
Linkki ei ole lataus. Palvelin ei käsittele hyötykuormaa; sovellus lukee tiedot paikallisesti QR-linkistä.
URL-osoiterakenne
QR-linkki
QR-koodit käyttävät vahvistettua HTTPS-sovelluslinkkiä. Tietolohko sijoitetaan fragmenttimerkin jälkeen.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
# jälkeen olevaa osaa ei yleensä lähetetä verkkopalvelimelle. Sama linkki voi siksi toimia sovelluslinkkinä ja varaosana tähän selitykseen.
Yksityisyys
Jaa luottamuksellisesti
QR-koodit voivat sisältää koordinaatteja, objektien nimiä, muistiinpanoja, projektiosia tai ryhmätietoja.
Ei automaattista siirtoa
QR-tiedot käsitellään paikallisesti. Tämä sivusto ei pura tai tallenna hyötykuormaa.
Geodata
Sijainnit ja projektikohteet voivat olla henkilötietoja. Jaa QR-koodeja vain sopivien vastaanottajien kanssa.
ryhmät
Ryhmän QR-koodit sisältävät ryhmäavaimen. Kuka tahansa koodin skannaava voi liittyä ryhmään tai tuoda ryhmätietoja.
Tekniset tiedot
Muotoilun tila
Versio 1 on tällä hetkellä dokumentoitu. Vanhemmat sovellusversiot voivat hylätä uudemmat versiot.
| Tuote | Arvo | Huomautuksia |
|---|---|---|
| Nykyinen HTTPS-sovelluslinkki | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Polku ilman perässä olevaa kauttaviivaa; Näin Android-sovelluslinkki rekisteröidään. |
| Dokumentaation URL-osoite | https://www.arxsilex.de/app/maptools/qr/ | Tämä verkkodokumentaatio on QR-kansiossa indeks.html-muodossa. |
| Perintöjärjestelmä | asmaptools://qr?v=1&d=<payload> | Yhteensopiva muoto vanhemmille tai ulkoisille skannereille. |
| Hyötykuorman koodaus | Base64URL, UTF-8 JSON | URL-turvallinen Base64 ilman täyttöä; sisältö on UTF-8 JSON. |
| Kaavion versio | v: 1 | Versiot alle 1 ovat virheellisiä; uudemmat versiot voidaan hylätä. |
| Hyötykuorman raja | 2200 tavua | Konservatiivinen korkki luotettavaan QR-luetoon ja dekoodaukseen. |
| Saapuvan URI-katto | 64 KiB | Kova yläraja saapuville syvälinkeille. |
| QR renderöinti | ZXing QR, virheenkorjaus M, 512 px | Sovellus hahmontaa 512 px QR-bittikarttoja ja voi sijoittaa pienen sovelluksen logon. |
Kaavio
Kompakti objektiskeema
Objektin QR-koodit käyttävät lyhytnäppäimiä QR-koodin pitämiseksi pienenä. Avaimet itse jäävät teknisiksi tunnisteiksi.
| Avain | Merkitys | Kentät |
|---|---|---|
| v | Kaavion versio | kokonaisluku |
| m | Merkit | i, n, inf, la, lo, ic, cl |
| c | Piirit | i, n, la, lo, r, cl, sc, fc |
| d | Etäisyydet | i, n, la, lo, ea, eo, cl |
| b | Atsimuutit/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
Kirjoitettu ryhmähyötykuorma
Ryhmän QR-koodit käyttävät kirjoitettuja JSON-hyötykuormia. Ryhmäavain on luottamuksellinen.
tyyppi: ryhmä
Sisältää nimen, ryhmän_tunnuksen, ryhmän_avaimen, alkuperän, värin, kuvauksen ja valinnaiset pikaviestit.
tyyppi: esineet
Kääriä objektitiedot objektikenttään.
tyyppi: group_with_objects
Yhdistää ryhmäprofiilin ja valinnaiset objektit. Sovellus voi tuoda ryhmän, objektit tai molemmat.
Validointi
Validointi ja rajat
Sovellus tarkistaa QR-tiedot ennen tuontia ja hylkää virheellisen geometrian tai ylisuuret tiedot.
Koordinaatit
Leveysaste -90 - 90, pituusaste -180 - 180. Viedyt koordinaatit pyöristetään 5 desimaaliin.
Geometria
Tunnusten on oltava suurempia kuin 0. Reiteillä on oltava vähintään 2, alueilla vähintään 3 erillistä pistettä.
Suuntimat
Atsimuutti 0 - 360 astetta, korjaus -180 - 180 astetta, pituus ja väli enintään 1000 km.
JSON
Esimerkkejä
Esimerkkejä ennen Base64URL-koodausta. Oikeassa QR-linkissä koodattu JSON sijoitetaan #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
}