二维码

您可以通过网址 GET 请求即时创建二维码。

概览

二维码是一种常见的二维条形码。它们也称为硬链接或物理世界超链接。二维码最多可存储 4296 个字母数字字符的任意文本。这些文本可以是任何内容,例如网址、联系信息、电话号码,甚至是诗歌!光学设备可通过相应的软件读取二维码。这些设备包括专用的二维码读取器、手机等。

语法

根网址https://chart.googleapis.com/chart?

二维码请求支持在 ?(在根网址中):

参数 必填还是选填 说明
cht=qr 必需 指定 QR 码。
chs=<width>x<height> 必需 图片大小。
chl=<data> 必需 要编码的数据。数据可以是数字 (0-9)、字母数字字符、数据的二进制字节或日文汉字。您不能在二维码中混用多种数据类型。数据必须采用 UTF-8 网址编码。请注意,网址的长度上限为 2K,因此,如果要编码超过 2K 字节(减去其他网址字符),则必须使用 POST 发送数据。
choe=<output_encoding> 可选 如何对二维码中的数据进行编码。可用值如下:
  • UTF-8 [默认]
  • Shift_JIS
  • ISO-8859-1
chld=<error_correction_level>|<margin> 可选
  • error_correction_level - 二维码支持四个纠错级别,用于恢复缺失、读错或被遮挡的数据。但可以存储更少的数据,从而提高冗余性。如需了解详情,请参阅附录。以下是支持的值:
    • 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 列,最多可对 4296 个字母数字字符进行编码

请勿将行数和列数与二维码图片的大小混淆。 代码的像素尺寸照常使用 chs 确定。

API 会根据您提供的数据量确定要使用的版本。

系统将根据您提供的字符数返回相应的二维码版本。例如,如果您提供 55 个字母数字字符,则会收到版本 3 二维码;不过,如果您使用 chld 参数明确指定纠错 (EC) 级别,该二维码会发生变化。

在生成二维码之前,请考虑使用哪种设备来读取您的代码:最好的二维码读取器能够读取版本 40 的代码;移动设备可能只能读取版本 4 的代码。

下表概述了一些不同版本的特征:

版本 行数 x 列数 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 177x177 L 7,089 4,296 2,953 1,817
M 5,596,000 3,391,000 2,331,000 1435
Q 3,993 2,420 1,663 1024
H 3,057 1,852 1,273 784

更多信息和标准

二维码标准的注册商标归 Denso Wave, Inc. 所有。

ISO 在其网站上销售英语规范。日语版本免费。

二维码标准获批的标准:

  • AIM 国际(自动识别制造商国际)标准(ISS - 二维码)于 1997 年 10 月发布。
  • JEIDA(日本电子产业发展协会)标准 (JEIDA-55),于 1998 年 3 月颁布。
  • 于 1999 年 1 月被批准为 JIS(日本工业标准)标准 (JIS X 0510)。
  • 于 2000 年 6 月被批准为 ISO 国际标准 (ISO/IEC18004)。

二维码读取器软件有多种来源。Google 免费提供二维码读取器库 Zebra Crossing (ZXing)。如需了解详情,请参阅 http://code.google.com/p/zxing/

如需查看对条形码中的信息进行标准编码的粗略指南,请参阅条形码内容