Mã QR

Bạn có thể tạo mã QR nhanh chóng bằng yêu cầu GET URL.

Tổng quan

Mã QR là một loại mã vạch hai chiều phổ biến. Chúng còn được gọi là đường liên kết cứng hoặc siêu liên kết trong thế giới thực. Mã QR lưu trữ lên đến 4.296 ký tự chữ-số của văn bản tuỳ ý. Nội dung này có thể là bất kỳ nội dung gì, ví dụ như URL, thông tin liên hệ, số điện thoại, thậm chí là một bài thơ! Thiết bị quang học có thể đọc mã QR bằng phần mềm thích hợp. Những thiết bị như vậy đa dạng từ trình đọc mã QR chuyên dụng cho đến điện thoại di động.

Cú pháp

URL gốc: https://chart.googleapis.com/chart?

Yêu cầu mã QR hỗ trợ các tham số truy vấn URL sau đây sau ký tự ? trong URL gốc:

Thông số Bắt buộc hoặc Không bắt buộc Nội dung mô tả
cht=qr Bắt buộc Chỉ định mã QR.
chs=<width>x<height> Bắt buộc Kích thước hình ảnh.
chl=<data> Bắt buộc Dữ liệu cần mã hoá. Dữ liệu có thể là chữ số (0-9), ký tự chữ-số, byte dữ liệu nhị phân hoặc chữ Kanji. Bạn không thể kết hợp các loại dữ liệu trong một mã QR. Dữ liệu phải được mã hoá URL theo định dạng UTF-8. Xin lưu ý rằng URL có độ dài tối đa là 2K, vì vậy, nếu muốn mã hoá hơn 2K byte (trừ các ký tự URL khác), bạn sẽ phải gửi dữ liệu bằng phương thức POST.
choe=<output_encoding> Không bắt buộc Cách mã hoá dữ liệu trong mã QR. Dưới đây là các giá trị có sẵn:
  • UTF-8 [Mặc định]
  • Shift_JIS
  • ISO-8859-1
chld=<error_correction_level>|<margin> Không bắt buộc
  • error_correction_level – Mã QR hỗ trợ 4 cấp độ sửa lỗi để cho phép khôi phục dữ liệu bị thiếu, đọc sai hoặc bị che khuất. Việc lưu trữ ít dữ liệu hơn sẽ giúp đảm bảo khả năng dự phòng lớn hơn. Hãy xem phụ lục để biết thông tin chi tiết. Sau đây là các giá trị được hỗ trợ:
    • L – [Mặc định] Cho phép khôi phục số lượng dữ liệu mất đến 7%
    • M – Cho phép khôi phục dữ liệu bị mất lên tới 15%
    • Q – Cho phép khôi phục dữ liệu bị mất lên tới 25%
    • H – Cho phép khôi phục dữ liệu bị mất lên đến 30%
  • lề – Chiều rộng của đường viền trắng xung quanh phần dữ liệu của mã. Đây là tính năng trong hàng, không phải trong pixel. (Xem bên dưới để tìm hiểu các hàng có trong mã QR.) Giá trị mặc định là 4.

 

Ví dụ:

Mã QR
cht=qr
chl=Hello+world
choe=UTF-8

Thông tin chi tiết về mã QR [Cách đọc không bắt buộc]

Sau đây là thông tin thêm về cách hoạt động của mã QR; bạn không nhất thiết phải biết điều này để có thể tạo mã QR.

Mã QR là các hình vuông, có số lượng hàng và cột bằng nhau. Có một tập hợp kích thước mã QR cố định: từ 21 đến 177 hàng/cột, tăng theo các bước 4. Mỗi cấu hình được gọi là một phiên bản. Càng có nhiều hàng/cột thì mã càng lưu trữ được nhiều dữ liệu. Dưới đây là phần tóm tắt về các phiên bản:

  • Phiên bản 1 có 21 hàng và 21 cột, có thể mã hoá lên đến 25 ký tự bao gồm chữ và số
  • Phiên bản 2 có 25 hàng và 25 cột, có thể mã hoá lên đến 47 ký tự chữ-số
  • Phiên bản 3 có 29 hàng và 29 cột, có thể mã hoá lên đến 77 ký tự bao gồm chữ và số
  • ...
  • Phiên bản 40 có 177 hàng và 177 cột, đồng thời có thể mã hoá lên đến 4.296 ký tự chữ-số

Đừng nhầm lẫn số hàng và cột với kích thước của hình ảnh mã QR. Kích thước pixel của mã được xác định bằng cách sử dụng chs như bình thường.

API sẽ xác định phiên bản cần sử dụng dựa trên lượng dữ liệu bạn cung cấp.

Phiên bản mã QR thích hợp sẽ được trả về tuỳ thuộc vào số lượng ký tự bạn cung cấp. Ví dụ: nếu cung cấp 55 ký tự bao gồm chữ và số, bạn sẽ nhận được mã QR Phiên bản 3, mặc dù mã này có thể thay đổi nếu bạn chỉ định cấp sửa lỗi (EC) một cách rõ ràng bằng tham số chld.

Trước khi tạo mã QR, hãy cân nhắc loại thiết bị dùng để đọc mã của bạn: trình đọc mã QR tốt nhất có thể đọc mã Phiên bản 40; thiết bị di động chỉ đọc được tối đa Phiên bản 4.

Bảng sau đây tóm tắt các đặc điểm của một vài phiên bản:

Phiên bản Hàng x Cột Cấp độ EC Số ký tự tối đa theo cấp độ EC và loại ký tự
Các chữ số: từ 0 đến 9 Chữ và số:
0 đến 9, A đến Z,
dấu cách, $ % * + - . / :
Tệp nhị phân Tiếng Kanji
1 21x21 L 41 25 17 10
M 34 20 14 8
Hỏi 27 16 11 7
Số lần bị đánh trúng bóng 17 10 7 4
2 25x25 L 77 47 32 20
M 63 38 26 16
Hỏi 48 29 20 12
Số lần bị đánh trúng bóng 34 20 14 8
3 29x29 L 127 77 53 32
M 101 61 42 26
Hỏi 77 47 32 20
Số lần bị đánh trúng bóng 58 35 24 15
4 33x33 L 187 114 78 48
M 149 90 62 38
Hỏi 111 67 46 28
Số lần bị đánh trúng bóng 82 50 34 21
10 57x57 L 652 395 271 167
M 513 311 213 131
Hỏi 364 221 151 93
Số lần bị đánh trúng bóng 288 174 119 74
40 177x177 L 7,089 4,296 2,953 1,817
M 5,596 3,391 2,331 1,435
Hỏi 3,993 2,420 1,663 1.024
Số lần bị đánh trúng bóng 3.057 1,852 1,273 784

Thông tin và tiêu chuẩn khác

Tiêu chuẩn mã QR đã được Denso Wave, Inc. đăng ký nhãn hiệu.

ISO bán bản đặc tả kỹ thuật bằng tiếng Anh trên trang web của họ. Phiên bản tiếng Nhật là miễn phí.

Các tiêu chuẩn mã QR được phê duyệt như sau:

  • tiêu chuẩn dành cho Nhà sản xuất tự động nhận dạng nội dung (giá trị nhận dạng tự động toàn cầu) (ISS – QR Code) vào tháng 10 năm 1997.
  • Tiêu chuẩn JEIDA (Hiệp hội phát triển công nghiệp điện tử Nhật Bản) (JEIDA-55) vào tháng 3 năm 1998.
  • Tiêu chuẩn JIS (Tiêu chuẩn Công nghiệp Nhật Bản) (JIS X 0510) vào tháng 1 năm 1999.
  • Tiêu chuẩn quốc tế ISO (ISO/IEC18004) vào tháng 6 năm 2000.

Phần mềm trình đọc mã QR có sẵn từ nhiều nguồn. Google cung cấp miễn phí thư viện trình đọc mã QR, Zebra Crossing (zing). Hãy xem http://code.google.com/p/zxing/ để biết chi tiết.

Xem Nội dung mã vạch để có hướng dẫn sơ bộ về cách mã hoá tiêu chuẩn thông tin trong mã vạch