警告: この API は非推奨になりました。代わりに、現在メンテナンス中の Google Charts API を使用してください。詳しくは、非推奨ポリシーをご覧ください。

QR コード

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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 コードでデータをエンコードする方法。指定できる値は次のとおりです。
  • UTF-8(デフォルト
  • Shift_JIS
  • ISO-8859-1
chld=<error_correction_level>|<margin> 任意
  • error_correction_level - QR コードは、4 レベルのエラー修正をサポートし、データの欠落、誤読み取り、不明瞭なデータの回復を可能にします。冗長性を高めると、保存できるデータ量が少なくなります。詳しくは、こちらの付録をご覧ください。サポートされている値は次のとおりです。
    • L - [デフォルト] 最大 7% のデータ損失を復旧できます。
    • M - 最大 15% のデータ損失を復旧できます。
    • Q - 最大 25% のデータ損失を回復可能
    • H - 最大 30% のデータ損失を復旧できます。
  • マージン - コードのデータ部分を囲む白い枠線の幅。これはピクセルではなく行で行われます。(QR コード内の行については、以下をご覧ください)。デフォルト値は 4 です。

 

例:

QR コード
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/ をご覧ください。

バーコードの情報の標準エンコードについては、バーコードの内容をご覧ください。