תוכן QR
קודי QR יכולים להכיל קואורדינטות, שמות אובייקטים, הערות, חלקי פרויקט או מידע קבוצה; לכן קודי QR של קבוצה חסויים.
פורמט נתוני QR
ייבוא QR ופורמט נתוני QR
קודי QR ב-ArxSilex MapTools הם פורמט חילוף עם גרסאות עבור נתוני אפליקציה קומפקטיים.
עודכן לאחרונה: 28 במאי 2026
סיכום
סקירה לשימוש ולפיתוח
סעיף זה מסכם מה קודי QR מכילים, כיצד ניתן ליצור אותם טכנית ומדוע הייבוא מתבצע מקומית.
תאימות טכנית
כלים עצמאיים יכולים ליצור QR אם הם עומדים בגרסה, מגבלות גודל, קידוד וכללי אימות.
ייבוא מקומי
הקישור אינו העלאה. השרת אינו מעבד payload; האפליקציה קוראת את הנתונים מקומית מקישור ה-QR.
מבנה URL
קישור QR
קודי QR משתמשים בקישור אפליקציה HTTPS מאומת. בלוק הנתונים נמצא אחרי סימן fragment.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
החלק אחרי # בדרך כלל אינו נשלח לשרת web. לכן אותו קישור פועל כ-app link וכגיבוי לעמוד הסבר זה.
פרטיות
שיתוף חסוי
קודי QR יכולים להכיל קואורדינטות, שמות אובייקטים, הערות, חלקי פרויקט או מידע קבוצה.
אין העברה אוטומטית
נתוני QR מעובדים מקומית. אתר זה אינו מפענח או שומר את ה-payload.
נתוני מיקום
מיקומים ואובייקטי פרויקט יכולים להיות מידע אישי. שתפו QR רק עם נמענים מתאימים.
קבוצות
קודי QR של קבוצה מכילים את מפתח הקבוצה. מי שסורק יכול להצטרף לקבוצה או לייבא את נתוניה.
מפרט טכני
מפרט טכני
כרגע מתועדת גרסה 1. גרסאות חדשות יותר עלולות להידחות בגרסאות אפליקציה ישנות.
| פריט | ערך | הערה |
|---|---|---|
| קישור אפליקציה HTTPS נוכחי | https://www.arxsilex.de/app/maptools/qr#d=<payload> | נתיב ללא לוכסן סופי; כך רשום קישור האפליקציה של Android. |
| URL תיעוד | https://www.arxsilex.de/app/maptools/qr/index.html | תיעוד web זה מוגש כ-index.html בתיקיית QR. |
| Scheme ישן | asmaptools://qr?v=1&d=<payload> | פורמט תאימות לסורקים ישנים או חיצוניים. |
| קידוד payload | Base64URL, UTF-8 JSON | Base64 בטוח ל-URL ללא padding; התוכן הוא JSON ב-UTF-8. |
| גרסת סכימה | v: 1 | גרסאות מתחת ל-1 אינן תקפות; גרסאות חדשות עלולות להידחות. |
| מגבלת payload | 2,200 bytes | מגבלה שמרנית ליצירה ופענוח QR אמינים. |
| מגבלת URI נכנס | 64 KiB | גבול קשיח ל-deep links נכנסים. |
| רינדור 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
כולל name, group_id, group_key, מקור, צבע, תיאור והודעות קצרות אופציונליות.
type: objects
עוטף נתוני אובייקטים בשדה objects.
type: group_with_objects
משלב פרופיל קבוצה ואובייקטים אופציונליים. האפליקציה יכולה לייבא קבוצה, אובייקטים או שניהם.
אימות
אימות ומגבלות
האפליקציה בודקת נתוני QR לפני ייבוא ודוחה גיאומטריה לא תקינה או נתונים גדולים מדי.
קואורדינטות
קו רוחב -90 עד 90, קו אורך -180 עד 180. קואורדינטות מיוצאות מעוגלות ל-5 ספרות.
גיאומטריה
מזהים חייבים להיות גדולים מ-0. מסלולים צריכים לפחות 2 נקודות ואזורים לפחות 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
}