QR डेटा प्रारूप

QR आयात और QR डेटा प्रारूप

ArxSilex MapTools में QR कोड छोटे ऐप डेटा के लिए संस्करणयुक्त विनिमय प्रारूप हैं।

अंतिम अपडेट: 28 मई 2026

सारांश

उपयोग और विकास के लिए अवलोकन

यह अनुभाग बताता है कि QR कोड में क्या होता है, उन्हें तकनीकी रूप से कैसे बनाया जा सकता है और import स्थानीय रूप से क्यों होता है।

QR सामग्री

QR कोड में coordinates, object names, notes, project parts या group information हो सकती है; इसलिए group QR गोपनीय हैं।

तकनीकी अनुकूलता

अपने tools QR कोड बना सकते हैं, यदि वे versioning, size limits, encoding और validation rules का पालन करें।

स्थानीय import

लिंक upload नहीं है। सर्वर payload process नहीं करता; ऐप QR link से डेटा स्थानीय रूप से पढ़ता है।

URL संरचना

QR लिंक

QR कोड सत्यापित HTTPS ऐप लिंक का उपयोग करते हैं। डेटा ब्लॉक fragment चिन्ह के बाद होता है।

https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>

# के बाद वाला भाग सामान्यतः वेब सर्वर को नहीं भेजा जाता। इसलिए वही लिंक ऐप लिंक और इस व्याख्या के fallback दोनों रूप में काम करता है।

गोपनीयता

गोपनीय रूप से साझा करें

QR कोड में निर्देशांक, ऑब्जेक्ट नाम, नोट्स, प्रोजेक्ट भाग या समूह जानकारी हो सकती है।

स्वचालित स्थानांतरण नहीं

QR डेटा स्थानीय रूप से संसाधित होता है। यह वेबसाइट payload को decode या store नहीं करती।

जियोडेटा

स्थान और प्रोजेक्ट ऑब्जेक्ट व्यक्तिगत डेटा हो सकते हैं। QR कोड केवल उचित प्राप्तकर्ताओं से साझा करें।

समूह

समूह QR कोड में समूह कुंजी होती है। कोड स्कैन करने वाला व्यक्ति समूह में शामिल हो सकता है या समूह डेटा आयात कर सकता है।

तकनीकी विनिर्देश

तकनीकी विनिर्देश

फिलहाल संस्करण 1 दस्तावेजीकृत है। नए संस्करण पुराने ऐप संस्करणों द्वारा अस्वीकार किए जा सकते हैं।

आइटममाननोट
वर्तमान HTTPS ऐप लिंकhttps://www.arxsilex.de/app/maptools/qr#d=<payload>अंतिम slash के बिना path; Android app link इसी तरह पंजीकृत है.
दस्तावेज URLhttps://www.arxsilex.de/app/maptools/qr/index.htmlयह वेब दस्तावेज QR फ़ोल्डर में index.html के रूप में दिया जाता है.
पुराना schemeasmaptools://qr?v=1&d=<payload>पुराने या बाहरी scanner के लिए संगतता प्रारूप.
Payload encodingBase64URL, UTF-8 JSONPadding के बिना URL-safe Base64; सामग्री UTF-8 JSON है.
स्कीमा संस्करणv: 11 से कम संस्करण अमान्य हैं; नए संस्करण अस्वीकार हो सकते हैं.
Payload सीमा2,200 bytesविश्वसनीय QR निर्माण और decoding के लिए सुरक्षित सीमा.
आने वाले URI की सीमा64 KiBआने वाले deep links के लिए कठोर ऊपरी सीमा.
QR renderingZXing QR, error correction M, 512 pxऐप 512 px QR bitmaps बनाता है और छोटा ऐप logo जोड़ सकता है.

Schema

QR आयात और QR डेटा प्रारूप

ऑब्जेक्ट QR कोड छोटे keys का उपयोग करते हैं ताकि QR कोड छोटा रहे। Keys तकनीकी identifiers रहते हैं।

Keyअर्थFields
vस्कीमा संस्करणinteger
mमार्करi, n, inf, la, lo, ic, cl
cवृत्तi, n, la, lo, r, cl, sc, fc
dदूरीi, n, la, lo, ea, eo, cl
bबियरिंग/दिशाएँi, n, la, lo, bg, ln, iv, bc, cl
aक्षेत्रi, n, pts, cl, sc, fc
rमार्गi, n, pts, cl

समूह

Typed group payloads

समूह QR कोड typed JSON payloads का उपयोग करते हैं। समूह key गोपनीय है।

type: group

नाम, group_id, group_key, origin, रंग, विवरण और वैकल्पिक quick messages शामिल करता है।

type: objects

ऑब्जेक्ट डेटा को objects field में रखता है।

type: group_with_objects

समूह प्रोफ़ाइल और वैकल्पिक ऑब्जेक्ट जोड़ता है। ऐप समूह, ऑब्जेक्ट या दोनों आयात कर सकता है।

सत्यापन

सत्यापन और सीमाएँ

ऐप आयात से पहले QR डेटा की जाँच करता है और अमान्य geometry या बहुत बड़े डेटा को अस्वीकार करता है।

निर्देशांक

Latitude -90 से 90, longitude -180 से 180। Exported coordinates 5 decimals तक round होते हैं।

Geometry

ID 0 से बड़े होने चाहिए। Routes को कम से कम 2 और areas को कम से कम 3 अलग points चाहिए।

Bearings

Bearing 0 से 360 degrees, correction -180 से 180 degrees, length और interval अधिकतम 1,000 km।

JSON

उदाहरण

Base64URL encoding से पहले के उदाहरण। वास्तविक QR link में encoded JSON #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
}