קודי QR

ניתן ליצור קוד QR בזמן אמת באמצעות בקשת GET של כתובת URL.

סקירה כללית

קודי QR הם סוג פופולרי של ברקוד דו-ממדי. הם נקראים גם hardlinks או היפר-קישורים לעולם הפיזי. קודי QR מכילים עד 4,296 תווים אלפאנומריים של טקסט שרירותי. הטקסט יכול להיות כל דבר, לדוגמה: כתובת אתר, פרטים ליצירת קשר, מספר טלפון ואפילו שיר! ניתן לקרוא קודי QR באמצעות מכשיר אופטי עם התוכנה המתאימה. מגוון המכשירים האלה נע בין קוראי קוד QR ייעודיים לטלפונים ניידים.

תחביר

כתובת ה-URL הבסיסית: https://chart.googleapis.com/chart?

בקשות קוד QR תומכות בפרמטרים הבאים של שאילתה לגבי כתובת ה-URL אחרי הסימן '?' בכתובת ה-URL הבסיסית:

פרמטר נדרש או אופציונלי תיאור
cht=qr חובה מציין קוד QR.
chs=<width>x<height> חובה גודל התמונה.
chl=<data> חובה הנתונים לקידוד. הנתונים יכולים להיות ספרות (0-9), תווים אלפאנומריים, בייטים בינאריים של נתונים או Kanji. לא ניתן לשלב בין סוגי נתונים בתוך קוד QR. הנתונים חייבים להיות בקידוד כתובת URL מסוג UTF-8. הערה: האורך המקסימלי של כתובות ה-URL הוא 2K, כך שאם ברצונך לקודד יותר מ-2,000 בייטים (בלי התווים האחרים של כתובות ה-URL), עליך לשלוח את הנתונים באמצעות POST.
choe=<output_encoding> אופציונלי איך לקודד את הנתונים בקוד ה-QR אלה הערכים הזמינים:
  • UTF-8 [ברירת מחדל]
  • Shift_JIS
  • ISO-8859-1
chld=<error_correction_level>|<margin> אופציונלי
  • error_correction_level – קודי QR תומכים בארבע רמות של תיקון שגיאות, כדי לאפשר שחזור של נתונים חסרים, שלא נקראו או שמטושטשים. אפשר להשיג יתירות גדולה יותר בגלל היכולת לאחסן פחות נתונים. לקבלת פרטים, יש לעיין בנספח. אפשר לבחור מבין הערכים הנתמכים הבאים:
    • L – [ברירת מחדל] מאפשר שחזור של עד 7% אובדן נתונים
    • M – מאפשרת שחזור של עד 15% אובדן נתונים
    • Q – מאפשרת שחזור של עד 25% אובדן נתונים
    • H – מאפשרת שחזור של עד 30% אובדן נתונים
  • שוליים – רוחב הגבול הלבן שמסביב לחלק הנתונים בקוד. הערך מופיע בשורות, לא בפיקסלים. (בהמשך מוסבר אילו שורות מופיעות בקוד QR). ערך ברירת המחדל הוא 4.

 

דוגמה:

קוד QR
cht=qr
chl=Hello+world
choe=UTF-8

פרטי קוד QR [קריאה אופציונלית]

כאן יש מידע נוסף על אופן הפעולה של קודי QR. לא חייבים לדעת זאת כדי ליצור קוד QR.

קודי QR הם ריבועים, ויש בהם מספר שווה של שורות ועמודות. יש קבוצה קבועה של גדלים של קודי QR: מ-21 עד 177 שורות/עמודות, עלייה בשלבים מתוך ארבע. כל תצורה נקראת גרסה. ככל שיש יותר שורות או עמודות, כך הקוד יוכל לאחסן יותר נתונים. זהו סיכום של הגרסאות:

  • גרסה 1 מכילה 21 שורות ו-21 עמודות, ואפשר לקודד עד 25 תווים אלפאנומריים
  • גרסה 2 מכילה 25 שורות ו-25 עמודות, ואפשר לקודד עד 47 תווים אלפאנומריים
  • גרסה 3 כוללת 29 שורות ו-29 עמודות, ואפשר לקודד עד 77 תווים אלפאנומריים
  • ...
  • גרסה 40 מכילה 177 שורות ו-177 עמודות, ויכולה לקודד עד 4,296 תווים אלפאנומריים

חשוב לזכור שיש הבדל בין מספר השורות והעמודות לבין הגודל של תמונת קוד ה-QR. גודל הפיקסלים של הקוד נקבע באמצעות chs כרגיל.

ה-API יקבע באיזו גרסה להשתמש על סמך כמות הנתונים שתספק.

גרסת קוד ה-QR המתאימה תוחזר בהתאם למספר התווים שסיפקת. לדוגמה, אם מציינים 55 תווים אלפאנומריים, מקבלים קוד QR מגרסה 3, אבל הוא עשוי להשתנות אם מציינים רמה של תיקון שגיאה (EC) באופן מפורש באמצעות הפרמטר chld.

לפני שיוצרים קוד QR, חשוב לשקול איזה סוג של מכשיר משמש לקריאת הקוד: קוראי קוד ה-QR הכי טובים יכולים לקרוא קודים של גרסה 40. במכשירים ניידים, אולי תהיה אפשרות לקרוא רק עד גרסה 4.

הטבלה הבאה מסכמת את המאפיינים של כמה גרסאות שונות:

גרסה שורות x עמודות רמת EC מספר התווים המקסימלי לפי רמת ה-EC וסוג התווים
ספרות: 0 עד 9 אלפאנומריים:
0 עד 9, A עד Z,
רווח, $ % * + - . / : 		בינארית קאנג'י
1 21x21 L 41 25 17 10
M 34 20 14 8
Q 27 16 11 7
H 17 10 7 4
2 25x25 L 77 47 32 20
M 63 38 26 16
Q 48 29 20 12
H 34 20 14 8
3 29x29 L 127 77 53 32
M 101 61 42 26
Q 77 47 32 20
H 58 35 24 15
4 33x33 L 187 114 78 48
M 149 90 62 38
Q 111 67 46 28
H 82 50 34 21
10 57x57 L 652 395 271 167
M 513 311 213 131
Q 364 221 151 93
H 288 174 119 74
40 177x177 L 7,089 4,296 2,953 1,817
M 5,596 3,391 2,331 1,435
Q 3,993 2,420 1,663 1,024
H 3,057 1,852 1,273 784

מידע וסטנדרטים נוספים

התקן של קוד ה-QR מסומן על ידי Denso Wave, Inc.

המפרט של השפה האנגלית מוצג באתר של ISO. הגרסה היפנית היא בחינם.

הסטנדרטים של קודי QR מאושרים בתור:

  • תקן RANGE International (Automatic Identification Manufacturers International) (ISS - קוד QR) באוקטובר 1997.
  • תקן JEIDA (Japanese Electronic Industry Development Association) (JEIDA-55) במרץ 1998.
  • תקן JIS (תקנים תעשייתיים יפניים) (JIS X 0510) בינואר 1999.
  • תקן ISO בינלאומי (ISO/IEC18004) ביוני 2000.

תוכנה לקריאת קודי QR זמינה ממקורות רבים. Google מציעה בחינם ספרייה של קוראי קוד QR, Zebra Crossing (ZXing). פרטים נוספים זמינים בכתובת http://code.google.com/p/zxing/.

במאמר תוכן ברקוד אפשר לקרוא מדריך כללי לקידוד סטנדרטי של מידע בברקודים