QR içeriği
QR kodları koordinatlar, nesne adları, notlar, proje parçaları veya grup bilgileri içerebilir; bu nedenle grup QR kodları gizlidir.
QR veri biçimi
QR içe aktarma ve QR veri biçimi
ArxSilex MapTools QR kodları, kompakt uygulama verileri için sürümlü bir değişim biçimidir.
Son güncelleme: 28 Mayıs 2026
Özet
Kullanım ve geliştirme için genel bakış
Bu bölüm QR kodlarının ne içerdiğini, teknik olarak nasıl üretilebileceğini ve içe aktarmanın neden yerel olduğunu özetler.
Teknik uyumluluk
Özel araçlar sürüm, boyut sınırları, kodlama ve doğrulama kurallarına uyarsa QR kodları oluşturabilir.
Yerel içe aktarma
Bağlantı bir yükleme değildir. Sunucu payload'u işlemez; uygulama verileri QR bağlantısından yerel olarak okur.
URL yapısı
QR bağlantısı
QR kodları doğrulanmış bir HTTPS uygulama bağlantısı kullanır. Veri bloğu fragment işaretinden sonra yer alır.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
# sonrasındaki bölüm normalde web sunucusuna gönderilmez. Bu nedenle aynı bağlantı hem app link hem de bu açıklamaya geri dönüş olarak çalışır.
Gizlilik
Gizli paylaşım
QR kodları koordinatlar, nesne adları, notlar, proje parçaları veya grup bilgileri içerebilir.
Otomatik aktarım yok
QR verileri yerel olarak işlenir. Bu web sitesi payload'u çözmez veya saklamaz.
Coğrafi veriler
Konumlar ve proje nesneleri kişisel veri olabilir. QR kodlarını yalnızca uygun alıcılarla paylaşın.
Gruplar
Grup QR kodları grup anahtarını içerir. Kodu tarayan kişi gruba katılabilir veya grup verilerini içe aktarabilir.
Teknik belirtim
Teknik belirtim
Şu anda sürüm 1 belgelenmiştir. Daha yeni sürümler eski uygulama sürümleri tarafından reddedilebilir.
| Öğe | Değer | Not |
|---|---|---|
| Geçerli HTTPS app link | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Sonda slash olmayan yol; Android app link bu şekilde kayıtlıdır. |
| Dokümantasyon URL'si | https://www.arxsilex.de/app/maptools/qr/index.html | Bu web dokümantasyonu QR klasöründe index.html olarak sunulur. |
| Eski scheme | asmaptools://qr?v=1&d=<payload> | Eski veya harici tarayıcılar için uyumluluk biçimi. |
| Payload kodlama | Base64URL, UTF-8 JSON | Padding olmadan URL güvenli Base64; içerik UTF-8 JSON'dur. |
| Şema sürümü | v: 1 | 1'in altındaki sürümler geçersizdir; yeni sürümler reddedilebilir. |
| Payload sınırı | 2,200 bytes | Güvenilir QR üretimi ve çözümü için koruyucu sınır. |
| Gelen URI üst sınırı | 64 KiB | Gelen deep link'ler için kesin üst sınır. |
| QR oluşturma | ZXing QR, error correction M, 512 px | Uygulama 512 px QR bitmap'leri oluşturur ve küçük bir uygulama logosu ekleyebilir. |
Schema
QR içe aktarma ve QR veri biçimi
Nesne QR kodları, kodu küçük tutmak için kısa anahtarlar kullanır. Anahtarlar teknik tanımlayıcı olarak kalır.
| Anahtar | Anlam | Alanlar |
|---|---|---|
| v | Şema sürümü | integer |
| m | İşaretçiler | i, n, inf, la, lo, ic, cl |
| c | Çemberler | i, n, la, lo, r, cl, sc, fc |
| d | Mesafeler | i, n, la, lo, ea, eo, cl |
| b | Kerterizler/yönler | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Alanlar | i, n, pts, cl, sc, fc |
| r | Rotalar | i, n, pts, cl |
Gruplar
Tipli grup payload'ları
Grup QR kodları tipli JSON payload'ları kullanır. Grup anahtarı gizlidir.
type: group
Ad, group_id, group_key, başlangıç noktası, renk, açıklama ve isteğe bağlı kısa mesajları içerir.
type: objects
Nesne verilerini objects alanında paketler.
type: group_with_objects
Grup profili ve isteğe bağlı nesneleri birleştirir. Uygulama grubu, nesneleri veya ikisini de içe aktarabilir.
Doğrulama
Doğrulama ve sınırlar
Uygulama içe aktarmadan önce QR verilerini kontrol eder ve geçersiz geometriyi veya çok büyük verileri reddeder.
Koordinatlar
Enlem -90 ile 90, boylam -180 ile 180. Dışa aktarılan koordinatlar 5 ondalığa yuvarlanır.
Geometri
ID'ler 0'dan büyük olmalıdır. Rotalar en az 2, alanlar en az 3 farklı nokta gerektirir.
Kerterizler
Kerteriz 0-360 derece, düzeltme -180 ile 180 derece, uzunluk ve aralık en fazla 1.000 km.
JSON
Örnekler
Base64URL kodlamasından önceki örnekler. Gerçek QR bağlantısında kodlanmış JSON #d=... içinde bulunur.
{
"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
}