URL GET 요청을 사용하여 신속하게 QR 코드를 만들 수 있습니다.
개요
QR 코드는 널리 사용되는 2차원 바코드 유형입니다. 하드링크 또는 실제 세계 하이퍼링크라고도 합니다. QR 코드는 임의의 텍스트를 최대 4,296자의 영숫자 문자로 저장합니다. 이 텍스트는 URL, 연락처 정보, 전화번호, 시 등 무엇이든 될 수 있습니다. QR 코드는 적절한 소프트웨어를 사용하여 광학 기기에서 읽을 수 있습니다. 이러한 기기는 전용 QR 코드 리더부터 휴대전화에 이르기까지 다양합니다.
문법
루트 URL: https://chart.googleapis.com/chart?
QR 코드 요청은 ? 를 루트 URL로 대체합니다.
매개변수 | 필수 또는 선택사항 | 설명 |
---|---|---|
cht=qr |
필수 | QR 코드를 지정합니다. |
chs=<width>x<height> |
필수 | 이미지 크기입니다. |
chl=<data> |
필수 | 인코딩할 데이터입니다. 숫자 (0~9), 영숫자 문자, 데이터의 바이너리 바이트 또는 간지일 수 있습니다. QR 코드 내에서 데이터 유형을 혼합할 수 없습니다. 데이터는 UTF-8 URL로 인코딩되어야 합니다. URL의 최대 길이는 2K이므로 2,000바이트 (다른 URL 문자 제외)를 초과하여 인코딩하려면 POST를 사용하여 데이터를 전송해야 합니다. |
choe=<output_encoding> |
선택사항 | QR 코드에서 데이터를 인코딩하는 방법 사용 가능한 값은 다음과 같습니다.
|
chld=<error_correction_level>|<margin> |
선택사항 |
|
예:
cht=qr
chl=Hello+world
choe=UTF-8
QR 코드 세부정보[선택 사항]
다음은 QR 코드의 작동 방식에 관한 자세한 내용입니다. QR 코드를 생성하기 위해 이 기능을 알 필요는 없습니다.
QR 코드는 행과 열의 수가 같은 정사각형입니다. QR 코드 크기는 고정되어 있으며, 행/열의 수는 21~177개로 4단계로 증가합니다. 각 구성을 버전이라고 합니다. 행/열이 많을수록 코드에서 저장할 수 있는 데이터도 많아집니다. 버전을 요약하면 다음과 같습니다.
- 버전 1은 행과 21개의 열을 포함하며 최대 25개의 영숫자 문자를 인코딩할 수 있습니다.
- 버전 2는 25개의 행과 25개의 열을 포함하며 최대 47개의 영숫자 문자를 인코딩할 수 있습니다.
- 버전 3은 29개 행과 29개 열을 포함하며 최대 77개의 영숫자 문자를 인코딩할 수 있습니다.
- ...
- 버전 40은 177개 행과 177개 열을 포함하며 최대 4,296개의 영숫자 문자를 인코딩할 수 있습니다.
행과 열의 수를 QR 코드 이미지의 크기와 혼동하지 마세요.
코드의 픽셀 크기는 평소와 같이 chs
를 사용하여 결정됩니다.
API는 제공된 데이터 양에 따라 사용할 버전을 결정합니다.
제공한 문자 수에 따라 적절한 QR 코드 버전이 반환됩니다. 예를 들어 55자리 영숫자 문자를 제공하면 버전 3 QR 코드를 받게 됩니다. 단, chld
매개변수를 명시적으로 사용하여 오류 수정 (EC) 수준을 지정하면 변경될 수 있습니다.
QR 코드를 생성하기 전에 어떤 종류의 기기를 사용하여 코드를 읽을지 고려하세요. 가장 적합한 QR 코드 리더는 버전 40 코드를 읽을 수 있지만 휴대기기는 버전 4까지만 읽을 수 있습니다.
다음 표에는 몇 가지 버전의 특징이 요약되어 있습니다.
버전 | 행 x 열 | EC 수준 | EC 수준 및 문자 유형별 최대 문자 수 | |||
---|---|---|---|---|---|---|
숫자: 0~9 | 영숫자: 0~9, A~Z, 공백, $ % * + - . / : |
바이너리 | 간지 | |||
1 | 21x21 | L | 41 | 25 | 17 | 10 |
월 | 34 | 20 | 14 | 8 | ||
Q | 27 | 16 | 11 | 7 | ||
H | 17 | 10 | 7 | 4 | ||
2 | 25x25 | L | 77 | 47 | 32 | 20 |
월 | 63 | 38 | 26 | 16 | ||
Q | 48 | 29 | 20 | 12 | ||
H | 34 | 20 | 14 | 8 | ||
3 | 29x29 | L | 127 | 77 | 53 | 32 |
월 | 101 | 61 | 42 | 26 | ||
Q | 77 | 47 | 32 | 20 | ||
H | 58 | 35 | 24 | 15 | ||
4 | 33x33 | L | 187 | 114 | 78 | 48 |
월 | 149 | 90 | 62 | 38 | ||
Q | 111 | 67 | 46 | 28 | ||
H | 82 | 50 | 34 | 21 | ||
10 | 연중무휴 | L | 652 | 395 | 271 | 167 |
월 | 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회 |
월 | 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 코드 표준은 다음과 같이 승인됩니다.
- 1997년 10월에 AIM International (Automatic Identification Manufacturers International) 표준 (ISS - QR 코드)이 추가되었습니다.
- 1998년 3월 JEIDA (일본 전자 산업 개발 협회) 표준 (JEIDA-55)입니다.
- 1999년 1월 JIS (일본 산업 표준) 표준 (JIS X 0510)
- 2000년 6월의 ISO 국제 표준 (ISO/IEC18004)입니다.
QR 코드 리더 소프트웨어는 다양한 소스에서 제공됩니다. Google은 QR 코드 리더 라이브러리인 Zebra Crossing (ZXing)을 무료로 제공합니다. 자세한 내용은 http://code.google.com/p/zxing/을 참조하세요.
바코드의 정보 표준 인코딩에 관한 대략적인 가이드는 바코드 콘텐츠를 참고하세요.