محتويات QR
يمكن أن تحتوي رموز QR على إحداثيات أو أسماء كائنات أو ملاحظات أو أجزاء المشروع أو معلومات المجموعة؛ وبالتالي فإن رموز QR للمجموعة سرية.
تنسيق بيانات QR
استيراد QR وتنسيق بيانات QR
رموز QR في ArxSilex MapTools هي تنسيق تبادل مُصدر لبيانات التطبيق المضغوطة. تشرح هذه الصفحة الاستخدام والخصوصية والتفاصيل الفنية.
آخر تحديث: 28 مايو 2026
ملخص
نظرة عامة على الاستخدام والتطوير
يلخص هذا القسم ما تحتويه رموز QR، وكيف يمكن إنشاؤها تقنيًا، ولماذا يحدث الاستيراد محليًا.
التوافق الفني
يمكن للأدوات المخصصة إنشاء رموز QR إذا كانت تتبع قواعد الإصدار وحدود الحجم والتشفير والتحقق من الصحة.
استيراد محلي
الرابط ليس تحميل. لا يقوم الخادم بمعالجة الحمولة؛ يقرأ التطبيق البيانات محليًا من رابط QR.
هيكل URL
رابط QR
تستخدم رموز QR رابط تطبيق HTTPS الذي تم التحقق منه. يتم وضع كتلة البيانات بعد علامة الجزء.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
عادةً لا يتم إرسال الجزء بعد # إلى خادم الويب. ومن ثم يمكن أن يعمل الرابط نفسه كرابط تطبيق وكبديل لهذا الشرح.
خصوصية
شارك بسرية
يمكن أن تحتوي رموز QR على إحداثيات أو أسماء كائنات أو ملاحظات أو أجزاء المشروع أو معلومات المجموعة.
لا يوجد نقل تلقائي
تتم معالجة بيانات QR محليًا. لا يقوم هذا الموقع بفك تشفير الحمولة أو تخزينها.
البيانات الجغرافية
يمكن أن تكون المواقع وكائنات المشروع بيانات شخصية. مشاركة رموز QR مع المستلمين المناسبين فقط.
المجموعات
تحتوي رموز QR للمجموعة على مفتاح المجموعة. يمكن لأي شخص يقوم بمسح الرمز الانضمام إلى المجموعة أو استيراد بيانات المجموعة.
المواصفات الفنية
حالة التنسيق
تم توثيق الإصدار 1 حاليًا. يمكن رفض الإصدارات الأحدث من خلال إصدارات التطبيق الأقدم.
| غرض | قيمة | ملحوظات |
|---|---|---|
| رابط تطبيق HTTPS الحالي | https://www.arxsilex.de/app/maptools/qr#d=<payload> | المسار بدون شرطة مائلة زائدة؛ هذه هي الطريقة التي يتم بها تسجيل رابط التطبيق Android. |
| عنوان URL للوثائق | https://www.arxsilex.de/app/maptools/qr/ | يتم تقديم وثائق الويب هذه كـ Index.html في مجلد QR. |
| مخطط تراث | asmaptools://qr?v=1&d=<payload> | تنسيق التوافق للماسحات الضوئية القديمة أو الخارجية. |
| ترميز الحمولة | Base64URL، UTF-8 JSON | Base64 آمن لعنوان URL بدون حشوة؛ المحتوى هو UTF-8 JSON. |
| نسخة المخطط | الخامس: 1 | الإصدارات أدناه 1 غير صالحة؛ يمكن رفض الإصدارات الأحدث. |
| حد الحمولة | 2200 بايت | غطاء محافظ لتوليد QR وفك التشفير بشكل موثوق. |
| الحد الأقصى لمعرف الموارد المنتظم (URI) الوارد | 64 كيلو بايت | الحد الأعلى الثابت للروابط العميقة الواردة. |
| تقديم QR | ZXing QR، تصحيح الخطأ M، 512 بكسل | يعرض التطبيق صورًا نقطية QR بحجم 512 بكسل وقد يضع تراكبًا صغيرًا لشعار التطبيق. |
مخطط
مخطط كائن مضغوط
تستخدم رموز QR الخاصة بالكائنات مفاتيح قصيرة لإبقاء رمز QR صغيرًا. تظل المفاتيح نفسها معرفات فنية.
| مفتاح | معنى | الحقول |
|---|---|---|
| ضد | نسخة المخطط | عدد صحيح |
| م | علامات | أنا، ن، الوقود النووي المشع، لا، لو، جيم، CL |
| ج | الدوائر | أنا، ن، لا، لو، ص، CL، الشوري، FC |
| د | المسافات | أنا، ن، لا، لو، EA، EO، CL |
| ب | السمت / الاتجاهات | i، n، la، lo، bg، ln، iv، bc، cl |
| أ | المناطق | أنا، ن، نقاط، CL، الشوري، FC |
| ص | الطرق | ط، ن، نقاط، CL |
المجموعات
حمولات المجموعة المكتوبة
تستخدم رموز QR للمجموعة حمولات JSON المكتوبة. مفتاح المجموعة سري.
النوع: مجموعة
يحتوي على الاسم ومعرف المجموعة ومفتاح المجموعة والأصل واللون والوصف والرسائل السريعة الاختيارية.
النوع: كائنات
يلتف بيانات الكائن في حقل الكائنات.
النوع: group_with_objects
يجمع بين ملف تعريف المجموعة والكائنات الاختيارية. يمكن للتطبيق استيراد المجموعة أو الكائنات أو كليهما.
تصديق
التحقق من الصحة والحدود
يتحقق التطبيق من بيانات QR قبل الاستيراد ويرفض الأشكال الهندسية غير الصالحة أو البيانات كبيرة الحجم.
الإحداثيات
خط العرض -90 إلى 90، خط الطول -180 إلى 180. يتم تقريب الإحداثيات المصدرة إلى 5 أرقام عشرية.
الهندسة
يجب أن تكون المعرفات أكبر من 0. تحتاج المسارات إلى 2 على الأقل، و3 نقاط مميزة على الأقل.
زوايا السمت
السمت 0 إلى 360 درجة، التصحيح -180 إلى 180 درجة، الطول والفاصل الزمني على الأكثر 1000 كم.
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
}