תוכן QR
קודי QR יכולים להכיל קואורדינטות, שמות אובייקטים, הערות, חלקי פרויקט או מידע קבוצתי; לכן קודי QR של קבוצה הם חסויים.
פורמט נתוני QR
ייבוא QR ופורמט נתונים QR
קודי QR ב-ArxSilex MapTools הם פורמט החלפה גרסה עבור נתוני אפליקציות קומפקטיות. דף זה מסביר שימוש, פרטיות ופרטים טכניים.
עדכון אחרון: 28 במאי 2026
תַקצִיר
סקירה כללית לשימוש ופיתוח
חלק זה מסכם מה מכילים קודי QR, כיצד ניתן ליצור אותם מבחינה טכנית ומדוע הייבוא מתרחש באופן מקומי.
תאימות טכנית
כלים מותאמים אישית יכולים ליצור קודי QR אם הם פועלים לפי ניהול גרסאות, מגבלות גודל, כללי קידוד ואימות.
יבוא מקומי
הקישור אינו העלאה. השרת אינו מעבד את המטען; האפליקציה קוראת את הנתונים באופן מקומי מקישור ה-QR.
מבנה כתובת האתר
הקישור ל-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. |
| כתובת אתר של תיעוד | 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. |
| גרסת סכימה | v: 1 | גרסאות מתחת ל-1 אינן חוקיות; ניתן לדחות גרסאות חדשות יותר. |
| מגבלת מטען | 2,200 בתים | מכסה שמרני ליצירת ופענוח QR אמינים. |
| מכסת URI נכנסת | 64 KiB | גבול עליון קשה לקישורים עמוקים נכנסים. |
| עיבוד QR | ZXing QR, תיקון שגיאות M, 512 פיקסלים | האפליקציה מציגה מפות סיביות של QR בגודל 512 פיקסלים ועשויה להציב שכבת-על של לוגו אפליקציה קטנה. |
סכֵימָה
סכימת אובייקט קומפקטית
קודי QR של אובייקט משתמשים במקשים קצרים כדי לשמור על קוד QR קטן. המפתחות עצמם נשארים מזהים טכניים.
| מַפְתֵחַ | מַשְׁמָעוּת | שדות |
|---|---|---|
| v | גרסת סכימה | מִספָּר שָׁלֵם |
| מ | סמנים | i, n, inf, la, lo, ic, cl |
| ג | מעגלים | i, n, la, הנה, r, cl, sc, fc |
| ד | מרחקים | i, n, la, הנה, ea, eo, cl |
| ב | אזימוטים/כיוונים | i, n, la, lo, bg, ln, iv, bc, cl |
| א | אזורים | i, n, pts, cl, sc, fc |
| ר | מסלולים | i, n, pts, cl |
קבוצות
מטענים קבוצתיים מוקלדים
קודי QR קבוצתיים משתמשים במטעני JSON מוקלדים. מפתח הקבוצה חסוי.
סוג: קבוצה
מכיל שם, group_id, group_key, מקור, צבע, תיאור והודעות מהירות אופציונליות.
סוג: אובייקטים
עוטף נתוני אובייקט בשדה אובייקטים.
סוג: 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
}