QR বিষয়বস্তু
QR কোডে coordinates, object names, notes, project parts বা group information থাকতে পারে; তাই group QR গোপনীয়।
QR ডেটা ফরম্যাট
ArxSilex MapTools-এর QR কোড ছোট অ্যাপ ডেটার জন্য সংস্করণযুক্ত বিনিময় ফরম্যাট।
সর্বশেষ আপডেট: 28 মে 2026
সারাংশ
এই অংশে QR কোডে কী থাকে, প্রযুক্তিগতভাবে কীভাবে তৈরি করা যায় এবং import কেন স্থানীয়ভাবে হয় তা সংক্ষেপে বলা হয়েছে।
QR কোডে coordinates, object names, notes, project parts বা group information থাকতে পারে; তাই group QR গোপনীয়।
নিজস্ব tools versioning, size limits, encoding এবং validation rules মানলে QR কোড তৈরি করতে পারে।
লিংকটি upload নয়। সার্ভার payload process করে না; অ্যাপ QR link থেকে স্থানীয়ভাবে ডেটা পড়ে।
URL গঠন
QR কোড যাচাইকৃত HTTPS app link ব্যবহার করে। ডেটা ব্লক fragment চিহ্নের পরে থাকে।
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
#-এর পরের অংশ সাধারণত ওয়েব সার্ভারে পাঠানো হয় না। তাই একই লিংক app link এবং এই ব্যাখ্যার fallback হিসেবে কাজ করে।
গোপনীয়তা
QR কোডে স্থানাঙ্ক, অবজেক্ট নাম, নোট, প্রকল্প অংশ বা গ্রুপ তথ্য থাকতে পারে।
QR ডেটা স্থানীয়ভাবে প্রক্রিয়াকৃত হয়। এই ওয়েবসাইট payload decode বা store করে না।
লোকেশন এবং প্রকল্প অবজেক্ট ব্যক্তিগত ডেটা হতে পারে। QR কোড শুধু উপযুক্ত প্রাপকের সঙ্গে শেয়ার করুন।
গ্রুপ QR কোডে গ্রুপ key থাকে। কোড স্ক্যান করলে কেউ গ্রুপে যোগ দিতে বা গ্রুপ ডেটা আমদানি করতে পারে।
প্রযুক্তিগত স্পেসিফিকেশন
বর্তমানে সংস্করণ 1 নথিভুক্ত। নতুন সংস্করণ পুরোনো অ্যাপে প্রত্যাখ্যাত হতে পারে।
| আইটেম | মান | নোট |
|---|---|---|
| বর্তমান HTTPS app link | https://www.arxsilex.de/app/maptools/qr#d=<payload> | শেষ slash ছাড়া path; Android app link এভাবেই নিবন্ধিত. |
| ডকুমেন্টেশন URL | https://www.arxsilex.de/app/maptools/qr/index.html | এই ওয়েব ডকুমেন্ট QR ফোল্ডারের index.html হিসেবে পরিবেশিত হয়. |
| পুরোনো scheme | asmaptools://qr?v=1&d=<payload> | পুরোনো বা বাহ্যিক scanner-এর জন্য compatibility format. |
| Payload encoding | Base64URL, UTF-8 JSON | Padding ছাড়া URL-safe Base64; content UTF-8 JSON. |
| স্কিমা সংস্করণ | v: 1 | 1-এর নিচের সংস্করণ অবৈধ; নতুন সংস্করণ প্রত্যাখ্যাত হতে পারে. |
| Payload সীমা | 2,200 bytes | বিশ্বস্ত QR তৈরি ও decode-এর জন্য সংরক্ষিত সীমা. |
| আগত URI সীমা | 64 KiB | আগত deep link-এর কঠোর ঊর্ধ্বসীমা. |
| QR rendering | ZXing QR, error correction M, 512 px | অ্যাপ 512 px QR bitmap তৈরি করে এবং ছোট app logo যোগ করতে পারে. |
Schema
অবজেক্ট QR কোড ছোট key ব্যবহার করে যাতে QR কোড ছোট থাকে। Key-গুলো প্রযুক্তিগত identifier থাকে।
| 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 |
গ্রুপ
গ্রুপ QR কোড typed JSON payload ব্যবহার করে। গ্রুপ key গোপনীয়।
নাম, group_id, group_key, origin, রং, বিবরণ এবং ঐচ্ছিক quick messages থাকে।
অবজেক্ট ডেটা objects field-এ রাখে।
গ্রুপ প্রোফাইল এবং ঐচ্ছিক অবজেক্ট মিলিয়ে দেয়। অ্যাপ গ্রুপ, অবজেক্ট বা দুটোই আমদানি করতে পারে।
যাচাই
অ্যাপ আমদানির আগে QR ডেটা পরীক্ষা করে এবং অবৈধ geometry বা অতিরিক্ত বড় ডেটা প্রত্যাখ্যান করে।
Latitude -90 থেকে 90, longitude -180 থেকে 180। Exported coordinates 5 decimals-এ round হয়।
ID 0-এর বেশি হতে হবে। Routes-এ অন্তত 2 এবং areas-এ অন্তত 3 ভিন্ন point দরকার।
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
}