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 の最大長は 2, 000 です。したがって、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 行 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 までしか読み取れない場合があります。
次の表は、いくつかの異なるバージョンの特性をまとめたものです。
バージョン | 行 × 列 | EC レベル | EC レベルと文字タイプごとの最大文字数 | |||
---|---|---|---|---|---|---|
0 ~ 9 桁の数字 | 英数字: 0 ~ 9、A ~ Z、 スペース、$ % * + - . / : |
バイナリ | 漢字 | |||
1 | 21x21 | L | 41 | 25 | 17 | 10 |
M | 34 | 20 | 14 | 8 | ||
Q | 27 | 16 | 11 | 7 | ||
H | 17 | 10 | 7 | 4 | ||
2 | 25x25 | L | 77 | 47 | 32 | 20 |
M | 63 | 38 | 26 | 16 | ||
Q | 48 | 29 | 20 | 12 | ||
H | 34 | 20 | 14 | 8 | ||
3 | 29x29 | L | 127 | 77 | 53 | 32 |
M | 101 | 61 | 42 | 26 | ||
Q | 77 | 47 | 32 | 20 | ||
H | 58 | 35 | 24 | 15 | ||
4 | 33x33 | L | 187 | 114 | 78 | 48 |
M | 149 | 90 | 62 | 38 | ||
Q | 111 | 67 | 46 | 28 | ||
H | 82 | 50 | 34 | 21 | ||
10 | 57x57 | L | 652 | 395 | 271 | 167 |
M | 513 | 311 | 213 | 131 | ||
Q | 364 | 221 | 151 | 93 | ||
H | 288 | 174 | 119 | 74 | ||
40 | 177×177 | 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 | ||
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)。
- ISO 国際規格(ISO/IEC18004)(2000 年 6 月)
QR コードリーダー ソフトウェアは多くの提供元から入手できます。Google では、QR コードリーダー ライブラリ「Zebra Crossing(ZXing)」を無料で提供しています。詳しくは http://code.google.com/p/zxing/ をご覧ください。
バーコードの情報の標準エンコードについては、バーコードの内容をご覧ください。