Zawartość QR
Kody QR mogą zawierać współrzędne, nazwy obiektów, notatki, części projektu lub informacje grupowe; dlatego kody grupowe są poufne.
Format danych QR
Import QR i format danych QR
Kody QR w ArxSilex MapTools są wersjonowanym formatem wymiany kompaktowych danych aplikacji.
Aktualizacja: 28 maja 2026
Podsumowanie
Przegląd dla użycia i rozwoju
Ta sekcja podsumowuje, co zawierają kody QR, jak można je technicznie generować i dlaczego import odbywa się lokalnie.
Zgodność techniczna
Własne narzędzia mogą generować QR, jeśli przestrzegają wersji, limitów rozmiaru, kodowania i reguł walidacji.
Import lokalny
Link nie jest przesyłaniem danych. Serwer nie przetwarza payloadu; aplikacja odczytuje dane lokalnie z linku QR.
Struktura URL
Link QR
Kody QR używają zweryfikowanego linku aplikacji HTTPS. Blok danych znajduje się po znaku fragmentu.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
Część po # zwykle nie jest wysyłana do serwera WWW. Ten sam link może więc działać jako app link i jako strona wyjaśniająca.
Prywatność
Udostępniaj poufnie
Kody QR mogą zawierać współrzędne, nazwy obiektów, notatki, części projektu lub informacje grupowe.
Brak automatycznego transferu
Dane QR są przetwarzane lokalnie. Ta strona nie dekoduje ani nie zapisuje payloadu.
Geodane
Lokalizacje i obiekty projektu mogą być danymi osobowymi. Udostępniaj QR tylko właściwym odbiorcom.
Grupy
Kody QR grup zawierają klucz grupy. Osoba skanująca kod może dołączyć do grupy lub zaimportować dane grupy.
Specyfikacja techniczna
Specyfikacja techniczna
Obecnie udokumentowana jest wersja 1. Nowsze wersje mogą zostać odrzucone przez starsze wersje aplikacji.
| Element | Wartość | Uwaga |
|---|---|---|
| Aktualny link aplikacji HTTPS | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Ścieżka bez końcowego ukośnika; tak zarejestrowany jest Android app link. |
| URL dokumentacji | https://www.arxsilex.de/app/maptools/qr/index.html | Ta dokumentacja WWW jest dostępna jako index.html w folderze QR. |
| Starszy schemat | asmaptools://qr?v=1&d=<payload> | Format zgodności dla starszych lub zewnętrznych skanerów. |
| Kodowanie payloadu | Base64URL, UTF-8 JSON | Base64 bezpieczne dla URL bez paddingu; zawartość to JSON UTF-8. |
| Wersja schematu | v: 1 | Wersje poniżej 1 są nieprawidłowe; nowsze mogą zostać odrzucone. |
| Limit payloadu | 2,200 bytes | Ostrożny limit dla niezawodnego tworzenia i odczytu QR. |
| Limit przychodzącego URI | 64 KiB | Twardy limit dla przychodzących deep linków. |
| Renderowanie QR | ZXing QR, error correction M, 512 px | Aplikacja renderuje bitmapy QR 512 px i może dodać małe logo aplikacji. |
Schema
Import QR i format danych QR
Kody QR obiektów używają krótkich kluczy, aby kod pozostał mały. Klucze pozostają identyfikatorami technicznymi.
| Klucz | Znaczenie | Pola |
|---|---|---|
| v | Wersja schematu | integer |
| m | Markery | i, n, inf, la, lo, ic, cl |
| c | Okręgi | i, n, la, lo, r, cl, sc, fc |
| d | Odległości | i, n, la, lo, ea, eo, cl |
| b | Namiary/kierunki | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Obszary | i, n, pts, cl, sc, fc |
| r | Trasy | i, n, pts, cl |
Grupy
Typowane payloady grupowe
Kody QR grup używają typowanych payloadów JSON. Klucz grupy jest poufny.
type: group
Zawiera nazwę, group_id, group_key, punkt początkowy, kolor, opis i opcjonalne szybkie wiadomości.
type: objects
Opakowuje dane obiektów w polu objects.
type: group_with_objects
Łączy profil grupy i opcjonalne obiekty. Aplikacja może importować grupę, obiekty lub oba elementy.
Walidacja
Walidacja i limity
Aplikacja sprawdza dane QR przed importem i odrzuca błędną geometrię lub zbyt duże dane.
Współrzędne
Szerokość -90 do 90, długość -180 do 180. Eksportowane współrzędne są zaokrąglane do 5 miejsc.
Geometria
ID muszą być większe niż 0. Trasy wymagają co najmniej 2, a obszary 3 różnych punktów.
Namiary
Namiar 0 do 360 stopni, korekta -180 do 180 stopni, długość i interwał maksymalnie 1 000 km.
JSON
Przykłady
Przykłady przed kodowaniem Base64URL. W prawdziwym linku QR zakodowany JSON znajduje się w #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
}