Isi QR
Kode QR dapat berisi koordinat, nama objek, catatan, bagian proyek, atau informasi grup; karena itu QR grup bersifat rahasia.
Format data QR
Impor QR dan format data QR
Kode QR di ArxSilex MapTools adalah format pertukaran berversi untuk data aplikasi yang ringkas.
Terakhir diperbarui: 28 Mei 2026
Ringkasan
Ikhtisar untuk penggunaan dan pengembangan
Bagian ini merangkum isi kode QR, cara membuatnya secara teknis, dan mengapa impor dilakukan secara lokal.
Kompatibilitas teknis
Alat sendiri dapat membuat QR jika mengikuti versi, batas ukuran, encoding, dan aturan validasi.
Impor lokal
Tautan bukan unggahan. Server tidak memproses payload; aplikasi membaca data secara lokal dari tautan QR.
Struktur URL
Tautan QR
Kode QR memakai app link HTTPS terverifikasi. Blok data ditempatkan setelah tanda fragmen.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
Bagian setelah # biasanya tidak dikirim ke server web. Tautan yang sama dapat menjadi app link dan fallback ke penjelasan ini.
Privasi
Bagikan secara rahasia
Kode QR dapat berisi koordinat, nama objek, catatan, bagian proyek, atau informasi grup.
Tidak ada transfer otomatis
Data QR diproses secara lokal. Situs ini tidak mendekode atau menyimpan payload.
Geodata
Lokasi dan objek proyek dapat menjadi data pribadi. Bagikan QR hanya kepada penerima yang sesuai.
Grup
QR grup berisi kunci grup. Siapa pun yang memindai dapat bergabung ke grup atau mengimpor data grup.
Spesifikasi teknis
Spesifikasi teknis
Saat ini versi 1 didokumentasikan. Versi yang lebih baru dapat ditolak oleh aplikasi lama.
| Item | Nilai | Catatan |
|---|---|---|
| App link HTTPS saat ini | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Path tanpa slash akhir; begitulah app link Android didaftarkan. |
| URL dokumentasi | https://www.arxsilex.de/app/maptools/qr/index.html | Dokumentasi web ini disajikan sebagai index.html di folder QR. |
| Scheme lama | asmaptools://qr?v=1&d=<payload> | Format kompatibilitas untuk pemindai lama atau eksternal. |
| Encoding payload | Base64URL, UTF-8 JSON | Base64 aman-URL tanpa padding; isi berupa JSON UTF-8. |
| Versi skema | v: 1 | Versi di bawah 1 tidak valid; versi baru dapat ditolak. |
| Batas payload | 2,200 bytes | Batas konservatif untuk pembuatan dan decoding QR yang andal. |
| Batas URI masuk | 64 KiB | Batas atas keras untuk deep link masuk. |
| Rendering QR | ZXing QR, error correction M, 512 px | Aplikasi merender bitmap QR 512 px dan dapat menambahkan logo aplikasi kecil. |
Schema
Impor QR dan format data QR
QR objek memakai kunci pendek agar kode tetap kecil. Kunci tetap menjadi identifier teknis.
| Kunci | Makna | Field |
|---|---|---|
| v | Versi skema | integer |
| m | Marker | i, n, inf, la, lo, ic, cl |
| c | Lingkaran | i, n, la, lo, r, cl, sc, fc |
| d | Jarak | i, n, la, lo, ea, eo, cl |
| b | Bearing/arah | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Area | i, n, pts, cl, sc, fc |
| r | Rute | i, n, pts, cl |
Grup
Payload grup bertipe
QR grup memakai payload JSON bertipe. Kunci grup bersifat rahasia.
type: group
Berisi nama, group_id, group_key, asal, warna, deskripsi, dan pesan cepat opsional.
type: objects
Membungkus data objek dalam field objects.
type: group_with_objects
Menggabungkan profil grup dan objek opsional. Aplikasi dapat mengimpor grup, objek, atau keduanya.
Validasi
Validasi dan batas
Aplikasi memeriksa data QR sebelum impor dan menolak geometri tidak valid atau data terlalu besar.
Koordinat
Latitude -90 sampai 90, longitude -180 sampai 180. Koordinat ekspor dibulatkan ke 5 desimal.
Geometri
ID harus lebih besar dari 0. Rute butuh minimal 2, area minimal 3 titik berbeda.
Bearing
Bearing 0 sampai 360 derajat, koreksi -180 sampai 180 derajat, panjang dan interval maksimal 1.000 km.
JSON
Contoh
Contoh sebelum encoding Base64URL. Pada tautan QR asli, JSON yang dikodekan berada di #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
}