二维码

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

概览

QR 码是一种流行的二维条形码。也称为“硬链接”或“物理世界超链接”。二维码最多可存储 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

二维码详细信息 [选读]

下面稍微详细地介绍了二维码的工作原理;即使您不一定了解这些信息也能生成二维码。

QR 码呈方形,行数和列数相同。有一组固定的二维码大小:从 21 行到 177 行/列,以 4 步递增。每种配置称为一个“版本”。行/列越多,代码可存储的数据就越多。下文大致介绍了各种版本:

  • 版本 1 包含 21 行和 21 列,最多可对 25 个字母数字字符进行编码
  • 版本 2 包含 25 行和 25 列,最多可对 47 个字母数字字符进行编码
  • 版本 3 包含 29 行和 29 列,最多可对 77 个字母数字字符进行编码
  • ...
  • 版本 40 包含 177 行和 177 列,最多可对 4,296 个字母数字字符进行编码

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

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

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

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

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

版本 行数 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 1,435,000
Q 3,993 2,420 1,663 1024
H 3,057 1,852 1,273 784

更多信息和标准

二维码标准已注册为 Denso Wave, Inc. 的商标。

ISO 会在其网站上提供英语规范。日语版本免费。

二维码标准已被批准为:

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

您可以从多种来源获取二维码读取器软件。Google 免费提供二维码读取器库和斑马线 (ZXing)。如需了解详情,请参阅 http://code.google.com/p/zxing/

有关对条形码信息进行标准编码的粗略指南,请参阅条形码内容