![chs=50x50&cht=qr&chl=Hello+world&chld=L|1&choe=UTF-8](https://developers-dot-devsite-v2-prod.appspot.com/static/chart/infographics/images/chart_526.png?authuser=3&hl=vi)
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ữ tối đa 4.296 ký tự chữ-số của văn bản tuỳ ý. Văn bản này có thể là bất kỳ nội dung nào, chẳng hạn 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ó phần mềm thích hợp có thể đọc mã QR. Các thiết bị như vậy đa dạng từ trình đọc mã QR chuyên dụng đế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ột 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 nhiều loại dữ liệu trong một mã QR. Dữ liệu phải được mã hoá URL theo phương thức UTF-8. Xin lưu ý rằng các URL có độ dài tối đa là 2K. Vì vậy, nếu muốn mã hoá nhiều hơn 2K byte (trừ các ký tự khác trong URL), bạn sẽ phải gửi dữ liệu của mình 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. Sau đây là các giá trị hiện có:
|
chld=<error_correction_level>|<margin> |
Không bắt buộc |
|
Ví dụ:
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à một số thông tin khác 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à hình vuông, có số lượng hàng và cột bằng nhau. Có một nhóm kích thước mã QR cố định: từ 21 đến 177 hàng/cột, tăng dần theo bước là 4. Mỗi cấu hình được gọi là một phiên bản. Càng nhiều hàng/cột, mã càng có thể lưu trữ nhiều dữ liệu. Dưới đây là nội dung tóm tắt về các phiên bản:
- Phiên bản 1 có 21 hàng và 21 cột, đồng thời có thể mã hoá tối đa 25 ký tự chữ-số
- Phiên bản 2 có 25 hàng và 25 cột, đồng thời có thể mã hoá tối đa 47 ký tự chữ-số
- Phiên bản 3 có 29 hàng và 29 cột, đồng thời có thể mã hoá tối đa 77 ký tự chữ-số
- ...
- Phiên bản 40 có 177 hàng và 177 cột, đồng thời có thể mã hoá tối đa 4.296 ký tự chữ-số
Đừng nhầm lẫn số lượng 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ư thường lệ.
API này 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ự mà 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. Tuy nhiên, giá trị này có thể thay đổi nếu bạn chỉ định rõ cấp độ sửa lỗi (EC) 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: các trình đọc mã QR tốt nhất có thể đọc mã Phiên bản 40; thiết bị di động có thể chỉ đọc được tối đa Phiên bản 4.
Bảng sau đây tóm tắt đặc điểm của một số 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ự | |||
---|---|---|---|---|---|---|
Chữ số: 0 đến 9 | Chữ và số: 0 đến 9, A đến Z, dấu cách, $ % * + - . / : |
Tệp nhị phân | Chữ 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 | Tăng 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 quy cách 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 là:
- Tiêu chuẩn Quốc tế (Nhà sản xuất nhận dạng tự động quốc tế) (ISS – Mã QR) của Mục tiêu Quốc tế Mục tiêu 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 đọc mã QR có từ nhiều nguồn. Google cung cấp miễn phí một thư viện Trình đọc mã QR, Zebra Crossing (ZXing). Hãy truy cập vào http://code.google.com/p/zxing/ để biết chi tiết.
Xem phần Nội dung mã vạch để biết hướng dẫn sơ bộ về phương thức mã hoá thông tin tiêu chuẩn trong mã vạch