![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=ja)
URL GET リクエストを使用して、その場で QR コードを作成できます。
概要
QR コードは、一般的な 2 次元バーコードの一種です。これらは、ハードリンクまたは物理世界のハイパーリンクとも呼ばれます。QR コードには、最大 4,296 文字の英数字の任意のテキストが保存されます。このテキストには、URL、連絡先情報、電話番号、詩など、どのようなテキストでもかまいません。QR コードは、適切なソフトウェアを搭載した光学式デバイスで読み取ることができます。このようなデバイスは、専用の QR コードリーダーからスマートフォンまで多岐にわたります。
構文
ルート URL: https://chart.googleapis.com/chart?
QR コード リクエストでは、? の後に続く URL クエリ パラメータがサポートされています。をルート 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 行 21 列で構成され、最大 25 文字の英数字をエンコードできます。
- バージョン 2 は 25 行 25 列で構成され、最大 47 文字の英数字をエンコードできます。
- バージョン 3 は 29 行 29 列で、最大 77 文字の英数字をエンコードできます。
- ...
- バージョン 40 は 177 行、177 列で構成され、最大 4,296 文字の英数字をエンコードできます。
行数と列数と QR コード画像のサイズを混同しないでください。コードのピクセルサイズは、通常どおり chs
を使用して決定されます。
指定したデータの量に基づいて、使用するバージョンが API によって決定されます。
指定した文字数に応じて、適切な QR コード バージョンが返されます。たとえば、55 文字の英数字を入力すると、バージョン 3 の QR コードが表示されます。ただし、chld
パラメータを使用してエラー修正(EC)レベルを明示的に指定すると、バージョン 3 の QR コードが変更されることがあります。
QR コードを生成する前に、コードの読み取りに使用するデバイスの種類を検討してください。最も優れた QR コードリーダーはバージョン 40 のコードを読み取ることができますが、モバイル デバイスではバージョン 4 までしか読み取れない場合があります。
次の表は、いくつかの異なるバージョンの特徴をまとめたものです。
バージョン | 行 x 列 | 拡張コンバージョンのレベル | 拡張コンバージョンのレベルと文字の種類別の最大文字数 | |||
---|---|---|---|---|---|---|
数字: 0 ~ 9 | 英数字: 0 ~ 9、A ~ Z、 スペース、$ % * + - . / : |
バイナリ | 漢字 | |||
1 | 21×21 | L | 41 | 25 | 17 | 10 |
M | 34 | 20 | 14 | 8 | ||
Q | 27 | 16 | 11 | 7 | ||
H | 17 | 10 | 7 | 4 | ||
2 | 25×25 | L | 77 | 47 | 32 | 20 |
M | 63 | 38 | 26 | 16 | ||
Q | 48 | 29 | 20 | 12 | ||
H | 34 | 20 | 14 | 8 | ||
3 | 29×29 | L | 127 | 77 | 53 | 32 |
M | 101 | 61 | 42 | 26 | ||
Q | 77 | 47 | 32 | 20 | ||
H | 58 | 35 | 24 | 15 | ||
4 | 33×33 | L | 187 | 114 | 78 | 48 |
M | 149 | 90 | 62 | 38 | ||
Q | 111 | 67 | 46 | 28 | ||
H | 82 | 50 | 34 | 21 | ||
10 | 57×57 | 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 コードは、株式会社デンソーウェーブの登録商標です。
ISO はサイトで英語の仕様を販売しています。日本語版は無料です。
QR コードの規格は、次のように承認されています。
- AIM International(Automatic Identification Manufacturers International)規格(ISS - QR コード)(1997 年 10 月)。
- JEIDA(日本電子産業開発協会)規格(JEIDA-55)が 1998 年 3 月に制定されました。
- 1999 年 1 月の JIS(日本工業規格)規格(JIS X 0510)。
- 2000 年 6 月に ISO 国際標準(ISO/IEC18004)として制定されました。
QR コードリーダー ソフトウェアはさまざまなソースから入手できます。Google では、QR コードリーダー ライブラリである Zebra Crossing(ZXing)を無料で提供しています。詳しくは、http://code.google.com/p/zxing/ をご覧ください。
バーコード内の情報の標準エンコードに関する大まかなガイドについては、バーコードの内容をご覧ください。