کدهای QR

می‌توانید با درخواست URL GET یک کد QR ایجاد کنید.

بررسی اجمالی

کدهای QR یک نوع محبوب بارکد دو بعدی هستند. آنها همچنین به عنوان پیوندهای سخت یا ابر پیوندهای دنیای فیزیکی شناخته می شوند. کدهای QR حداکثر 4296 کاراکتر الفبایی از متن دلخواه را ذخیره می کنند. این متن می تواند هر چیزی باشد، به عنوان مثال URL، اطلاعات تماس، شماره تلفن، حتی یک شعر! کدهای QR را می توان با یک دستگاه نوری با نرم افزار مناسب خواند. چنین دستگاه هایی از کدخوان QR اختصاصی گرفته تا تلفن های همراه را شامل می شود.

نحو

URL ریشه: https://chart.googleapis.com/chart?

درخواست‌های کد QR از پارامترهای جستجوی URL زیر پس از ? در آدرس ریشه:

پارامتر الزامی یا اختیاری شرح
cht=qr ضروری کد QR را مشخص می کند.
chs=< width >x< height > ضروری اندازه تصویر.
chl=< data > ضروری داده هایی برای رمزگذاری داده ها می توانند ارقام (0-9)، نویسه های الفبایی، بایت های باینری داده یا کانجی باشند. شما نمی توانید انواع داده را در یک کد QR ترکیب کنید. داده ها باید با URL UTF-8 رمزگذاری شوند. توجه داشته باشید که URL ها حداکثر طول 2K دارند، بنابراین اگر می خواهید بیش از 2K بایت (منهای دیگر کاراکترهای 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 code
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 ستون است و می تواند تا 4296 کاراکتر الفبایی عددی را رمزگذاری کند.

تعداد سطرها و ستون ها را با اندازه تصویر کد 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
م 34 20 14 8
س 27 16 11 7
اچ 17 10 7 4
2 25x25 L 77 47 32 20
م 63 38 26 16
س 48 29 20 12
اچ 34 20 14 8
3 29x29 L 127 77 53 32
م 101 61 42 26
س 77 47 32 20
اچ 58 35 24 15
4 33x33 L 187 114 78 48
م 149 90 62 38
س 111 67 46 28
اچ 82 50 34 21
10 57x57 L 652 395 271 167
م 513 311 213 131
س 364 221 151 93
اچ 288 174 119 74
40 177x177 L 7,089 4296 2,953 1,817
م 5,596 3,391 2,331 1,435
س 3,993 2,420 1663 1024
اچ 3,057 1,852 1273 784

اطلاعات بیشتر و استانداردها

استاندارد کد QR توسط Denso Wave، Inc علامت تجاری است.

ISO مشخصات زبان انگلیسی را در سایت خود می فروشد. نسخه ژاپنی رایگان است.

استانداردهای کد QR به شرح زیر تایید می شوند:

  • استاندارد AIM International (Automatic Identification Manufacturers International) (ISS - QR Code) در اکتبر 1997.
  • استاندارد JEIDA (انجمن توسعه صنعت الکترونیک ژاپن) (JEIDA-55) در مارس 1998.
  • استاندارد JIS (استانداردهای صنعتی ژاپن) (JIS X 0510) در ژانویه 1999.
  • استاندارد بین المللی ISO (ISO/IEC18004) در ژوئن 2000.

نرم افزار کدخوان QR از منابع زیادی در دسترس است. Google یک کتابخانه خواننده کد QR، Zebra Crossing (ZXing) را به صورت رایگان ارائه می دهد. برای جزئیات بیشتر به http://code.google.com/p/zxing/ مراجعه کنید.

برای یک راهنمای تقریبی برای رمزگذاری استاندارد اطلاعات در بارکد، به محتوای بارکد مراجعه کنید