คิวอาร์โค้ด

คุณสร้างคิวอาร์โค้ดได้ทันทีโดยใช้คำขอ GET สำหรับ URL

ภาพรวม

คิวอาร์โค้ดเป็นบาร์โค้ดสองมิติที่ได้รับความนิยม หรือเรียกอีกอย่างว่าลิงก์ฮาร์ดแวร์ หรือไฮเปอร์ลิงก์ในโลกจริง คิวอาร์โค้ดจัดเก็บอักขระที่เป็นตัวอักษรและตัวเลขคละกันได้สูงสุด 4,296 ตัวของข้อความที่กำหนดเอง ข้อความนี้จะเป็นอะไรก็ได้ เช่น URL ข้อมูลติดต่อ หมายเลขโทรศัพท์ หรือบทกวี อุปกรณ์ออปติคัลที่มีซอฟต์แวร์ที่เหมาะสมสามารถอ่านคิวอาร์โค้ดได้ อุปกรณ์ดังกล่าวมีตั้งแต่เครื่องอ่านคิวอาร์โค้ดโดยเฉพาะไปจนถึงโทรศัพท์มือถือ

ไวยากรณ์

URL ราก: https://chart.googleapis.com/chart?

คำขอคิวอาร์โค้ดรองรับพารามิเตอร์การค้นหาของ URL ต่อไปนี้หลังอักขระ ? ใน URL รูท:

พารามิเตอร์	ต้องระบุหรือไม่บังคับ	คำอธิบาย
cht=qr	จำเป็น	ระบุคิวอาร์โค้ด
chs=<width>x<height>	จำเป็น	ขนาดรูปภาพ
chl=<data>	จำเป็น	ข้อมูลที่จะเข้ารหัส ข้อมูลอาจเป็นตัวเลข (0-9) อักขระที่เป็นตัวอักษรและตัวเลขคละกัน ไบต์ข้อมูลไบนารี หรือตัวคันจิ แต่จะใช้ประเภทข้อมูลผสมกันในคิวอาร์โค้ดไม่ได้ ข้อมูลต้องเข้ารหัส URL แบบ UTF-8 โปรดทราบว่า URL มีความยาวสูงสุดอยู่ที่ 2, 000 รายการ ดังนั้นหากต้องการเข้ารหัสที่มากกว่า 2,000 ไบต์ (ลบด้วยอักขระของ URL อื่นๆ) คุณจะต้องส่งข้อมูลโดยใช้ POST
choe=<output_encoding>	ไม่บังคับ	วิธีเข้ารหัสข้อมูลในคิวอาร์โค้ด ค่าที่ใช้ได้มีดังนี้ UTF-8 [ค่าเริ่มต้น] Shift_JIS ISO-8859-1
chld=<error_correction_level>|<margin>	ไม่บังคับ	error_correction_level - คิวอาร์โค้ดรองรับการแก้ไขข้อผิดพลาด 4 ระดับเพื่อเปิดใช้การกู้คืนข้อมูลที่สูญหาย อ่านผิด หรือถูกบดบัง การสำรองข้อมูลจะสูงขึ้นตามไปด้วยเนื่องจากมีต้นทุนในการจัดเก็บข้อมูลได้น้อยลง ดูรายละเอียดได้ที่ภาคผนวก ค่าที่รองรับมีดังนี้ L - [ค่าเริ่มต้น] อนุญาตให้กู้คืนข้อมูลที่สูญหายสูงสุด 7% M - อนุญาตให้กู้คืนข้อมูลที่สูญหายได้สูงสุด 15% Q - อนุญาตให้กู้คืนข้อมูลที่สูญหายได้สูงสุด 25% H - อนุญาตให้กู้คืนข้อมูลที่สูญหายได้สูงสุด 30% margin - ความกว้างของขอบสีขาวรอบส่วนข้อมูลของโค้ด ข้อมูลนี้อยู่ในแถว ไม่ใช่ในพิกเซล (ดูด้านล่างเพื่อดูแถวที่อยู่ในคิวอาร์โค้ด) ค่าเริ่มต้นคือ 4

 

ตัวอย่างเช่น

cht=qr
chl=Hello+world
choe=UTF-8

รายละเอียดคิวอาร์โค้ด [อ่านเพิ่มเติม]

ต่อไปนี้เป็นข้อมูลเพิ่มเติมเล็กน้อยเกี่ยวกับวิธีการทำงานของคิวอาร์โค้ด คุณไม่จำเป็นต้องทราบข้อมูลนี้จึงจะสร้างคิวอาร์โค้ดได้

คิวอาร์โค้ดเป็นสี่เหลี่ยมจัตุรัสที่มีจำนวนแถวและคอลัมน์เท่ากัน คิวอาร์โค้ดมีชุดขนาดคงที่ ได้แก่ แถว/คอลัมน์ 21-177 แถว โดยเพิ่มขึ้นในขั้นตอนที่ 4 การกำหนดค่าแต่ละรายการเรียกว่าเวอร์ชัน ยิ่งมีแถว/คอลัมน์มาก โค้ดก็จะยิ่งจัดเก็บข้อมูลได้มาก ข้อมูลสรุปของเวอร์ชันมีดังนี้

• เวอร์ชัน 1 มี 21 แถว 21 คอลัมน์ และเข้ารหัสอักขระที่เป็นตัวอักษรและตัวเลขคละกันได้สูงสุด 25 ตัว
• เวอร์ชัน 2 มี 25 แถว 25 คอลัมน์ และเข้ารหัสอักขระที่เป็นตัวอักษรและตัวเลขคละกันได้สูงสุด 47 ตัว
• เวอร์ชัน 3 มี 29 แถว 29 คอลัมน์ และเข้ารหัสอักขระที่เป็นตัวอักษรและตัวเลขคละกันได้สูงสุด 77 ตัว
• ...
• เวอร์ชัน 40 มี 177 แถวและ 177 คอลัมน์ และเข้ารหัสอักขระที่เป็นตัวอักษรและตัวเลขคละกันได้สูงสุด 4,296 ตัว

อย่าสับสนระหว่างจำนวนแถวและคอลัมน์กับขนาดของรูปภาพคิวอาร์โค้ด ขนาดพิกเซลของโค้ดจะกำหนดโดยใช้ chs ตามปกติ

API จะกําหนดเวอร์ชันที่จะใช้โดยอิงตามปริมาณข้อมูลที่คุณให้ไว้

ระบบจะแสดงเวอร์ชันคิวอาร์โค้ดที่เหมาะสมโดยขึ้นอยู่กับจำนวนอักขระที่คุณระบุ เช่น หากระบุอักขระที่เป็นตัวอักษรและตัวเลขคละกัน 55 ตัว คุณจะได้รับคิวอาร์โค้ดเวอร์ชัน 3 แม้ว่าจะมีการเปลี่ยนแปลงได้หากคุณระบุระดับการแก้ไขข้อผิดพลาด (EC) อย่างชัดเจนโดยใช้พารามิเตอร์ chld

ก่อนสร้างคิวอาร์โค้ด ให้พิจารณาประเภทอุปกรณ์ที่ใช้อ่านโค้ด นั่นคือ เครื่องอ่านคิวอาร์โค้ดที่ดีที่สุดจะอ่านโค้ดเวอร์ชัน 40 ได้ อุปกรณ์เคลื่อนที่อาจอ่านได้จนถึงเวอร์ชัน 4 เท่านั้น

ตารางต่อไปนี้เป็นการสรุปลักษณะเฉพาะของเวอร์ชันต่างๆ 2-3 เวอร์ชัน

เวอร์ชัน	แถว x คอลัมน์	ระดับ EC	จำนวนอักขระสูงสุดตามระดับ EC และประเภทอักขระ
			ตัวเลข: 0 ถึง 9	ตัวอักษรและตัวเลข: 0 ถึง 9, A ถึง Z, วรรค, $ % * + - / :	ไบนารี	คันจิ
1	ให้บริการทุกวันตลอด 21 ชั่วโมง	L	41	25	17	10
		M	34	20	14	8
		Q	27	16	11	7
		ฮิต	17	10	7	4
2	ให้บริการทุกวันตลอด 25 ชั่วโมง	L	77	47	32	20
		M	63	38	26	16
		Q	48	29	20	12
		ฮิต	34	20	14	8
3	29x29	L	127	77	53	32
		M	101	61	42	26
		Q	77	47	32	20
		ฮิต	58	35	24	15
4	33x33	L	187	114	78	48
		M	149	90	62	38
		Q	111	67	46	28
		ฮิต	82	50	34	21
10	57x57	L	652	395	271	167
		M	513	311	213	131
		Q	364	221	151	93
		ฮิต	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 คน
		ฮิต	3,057 ครั้ง	1,852 คน	1,273 คน	784

ข้อมูลและมาตรฐานเพิ่มเติม

มาตรฐานคิวอาร์โค้ดเป็นเครื่องหมายการค้าของ Denso Wave, Inc.

ISO จะขายข้อกำหนดภาษาอังกฤษในเว็บไซต์ เวอร์ชันภาษาญี่ปุ่นใช้งานได้ฟรี

มาตรฐานคิวอาร์โค้ดได้รับอนุมัติดังต่อไปนี้

• มาตรฐาน CPI ระหว่างประเทศ (ผู้ผลิตการระบุอัตโนมัติระหว่างประเทศ) (ISS - คิวอาร์โค้ด) ในเดือนตุลาคม 1997
• มาตรฐานของ JEIDA (Japanese Electronic Industry Development Association) (JEIDA-55) ในเดือนมีนาคม 1998
• มาตรฐาน JIS (มาตรฐานอุตสาหกรรมญี่ปุ่น) (JIS X 0510) ในเดือนมกราคม 1999
• มาตรฐาน ISO สากล (ISO/IEC18004) ในเดือนมิถุนายน 2000

ซอฟต์แวร์โปรแกรมอ่านคิวอาร์โค้ดพร้อมใช้งานจากหลายแหล่งที่มา Google มีไลบรารีโปรแกรมอ่านคิวอาร์โค้ด Zebra Crossing (ZXing) โดยไม่มีค่าใช้จ่าย ดูรายละเอียดได้ที่ http://code.google.com/p/zxing/

ดูเนื้อหาของบาร์โค้ดสำหรับคำแนะนำคร่าวๆ เกี่ยวกับการเข้ารหัสมาตรฐานของข้อมูลในบาร์โค้ด