محتوى QR
قد تحتوي رموز QR على إحداثيات أو أسماء كائنات أو ملاحظات أو أجزاء مشروع أو معلومات مجموعة؛ لذلك تكون رموز المجموعات سرية.
تنسيق بيانات QR
استيراد QR وتنسيق بيانات QR
رموز QR في ArxSilex MapTools هي تنسيق تبادل بإصدارات لبيانات التطبيق الصغيرة.
آخر تحديث: 28 مايو 2026
ملخص
نظرة عامة للاستخدام والتطوير
يلخص هذا القسم ما تحتويه رموز QR وكيف يمكن إنشاؤها تقنيًا ولماذا يتم الاستيراد محليًا.
توافق تقني
يمكن للأدوات الخاصة إنشاء رموز QR إذا التزمت بالإصدار وحدود الحجم والترميز وقواعد التحقق.
استيراد محلي
الرابط ليس رفعًا. الخادم لا يعالج payload؛ التطبيق يقرأ البيانات محليًا من رابط QR.
بنية الرابط
رابط QR
تستخدم رموز QR رابط تطبيق HTTPS موثقًا. توجد كتلة البيانات بعد علامة المقطع.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
الجزء بعد # لا يُرسل عادة إلى خادم الويب. لذلك يعمل الرابط نفسه كرابط تطبيق وكصفحة شرح احتياطية.
الخصوصية
مشاركة بسرية
قد تحتوي رموز QR على إحداثيات أو أسماء كائنات أو ملاحظات أو أجزاء مشروع أو معلومات مجموعة.
لا نقل تلقائي
تُعالج بيانات QR محليًا. هذا الموقع لا يفك ترميز payload ولا يخزنه.
بيانات جغرافية
قد تكون المواقع وكائنات المشروع بيانات شخصية. شارك رموز QR فقط مع المستلمين المناسبين.
المجموعات
تحتوي رموز QR للمجموعات على مفتاح المجموعة. من يمسح الرمز يمكنه الانضمام إلى المجموعة أو استيراد بياناتها.
المواصفة التقنية
المواصفة التقنية
الإصدار الموثق حاليًا هو 1. قد ترفض إصدارات التطبيق القديمة الإصدارات الأحدث.
| العنصر | القيمة | ملاحظة |
|---|---|---|
| رابط تطبيق HTTPS الحالي | https://www.arxsilex.de/app/maptools/qr#d=<payload> | مسار دون شرطة مائلة أخيرة؛ هكذا سُجل رابط تطبيق Android. |
| رابط الوثائق | https://www.arxsilex.de/app/maptools/qr/index.html | تُقدم هذه الوثائق كملف index.html في مجلد QR. |
| Scheme القديم | asmaptools://qr?v=1&d=<payload> | تنسيق توافق للماسحات القديمة أو الخارجية. |
| ترميز payload | Base64URL, UTF-8 JSON | Base64 آمن للرابط دون padding؛ المحتوى JSON بترميز UTF-8. |
| إصدار المخطط | v: 1 | الإصدارات الأقل من 1 غير صالحة؛ قد تُرفض الإصدارات الأحدث. |
| حد payload | 2,200 bytes | حد محافظ لإنشاء وفك QR بشكل موثوق. |
| حد URI الوارد | 64 KiB | حد أعلى صارم للروابط العميقة الواردة. |
| عرض QR | ZXing QR, error correction M, 512 px | يعرض التطبيق صور QR بحجم 512 px وقد يضيف شعارًا صغيرًا. |
Schema
استيراد QR وتنسيق بيانات QR
تستخدم رموز QR للكائنات مفاتيح قصيرة لإبقاء الرمز صغيرًا. تبقى المفاتيح معرفات تقنية.
| المفتاح | المعنى | الحقول |
|---|---|---|
| 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 |
المجموعات
Payloads مجموعات ذات نوع
تستخدم رموز QR للمجموعات JSON ذا نوع. مفتاح المجموعة سري.
type: group
يتضمن الاسم و group_id و group_key والأصل واللون والوصف ورسائل سريعة اختيارية.
type: objects
يلف بيانات الكائنات في حقل objects.
type: group_with_objects
يجمع ملف المجموعة وكائنات اختيارية. يمكن للتطبيق استيراد المجموعة أو الكائنات أو كليهما.
التحقق
التحقق والحدود
يتحقق التطبيق من بيانات QR قبل الاستيراد ويرفض الهندسة غير الصالحة أو البيانات الكبيرة جدًا.
الإحداثيات
خط العرض من -90 إلى 90 وخط الطول من -180 إلى 180. تُقرب الإحداثيات المصدرة إلى 5 منازل.
الهندسة
يجب أن تكون المعرفات أكبر من 0. تحتاج المسارات إلى نقطتين مختلفتين على الأقل والمناطق إلى 3.
الاتجاهات
الاتجاه 0 إلى 360 درجة، التصحيح -180 إلى 180 درجة، الطول والفاصل حتى 1,000 كم.
JSON
أمثلة
أمثلة قبل ترميز Base64URL. في رابط QR الحقيقي يوجد 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
}