Предупреждение: этот API устарел. Вместо этого используйте активно поддерживаемый API Google Charts . Подробнее см. в нашей политике прекращения поддержки.

Эта страница переведена с помощью Cloud Translation API.

QR-коды

chs=50x50&cht=qr&chl=Hello+world&chld=L|1&choe=UTF-8

Вы можете создать QR-код на лету с помощью запроса URL GET.

Обзор

QR-коды — популярный тип двумерного штрих-кода. Они также известны как жесткие ссылки или гиперссылки физического мира . QR-коды хранят до 4296 буквенно-цифровых символов произвольного текста. Этот текст может быть чем угодно, например URL-адресом, контактной информацией, номером телефона или даже стихотворением! QR-коды могут считываться оптическим устройством с соответствующим программным обеспечением. Такие устройства варьируются от специализированных считывателей QR-кодов до мобильных телефонов.

Синтаксис

Корневой URL-адрес: https://chart.googleapis.com/chart?

Запросы QR-кода поддерживают следующие параметры URL-запроса после знака ? в корневом URL:

Параметр	Обязательный или необязательный	Описание
`cht=qr`	Необходимый	Указывает QR-код.
`chs=< width >x< height >`	Необходимый	Размер изображения.
`chl=< data >`	Необходимый	Данные для кодирования. Данные могут быть цифрами (0–9), буквенно-цифровыми символами, двоичными байтами данных или кандзи. Вы не можете смешивать типы данных в QR-коде. Данные должны иметь URL-кодировку UTF-8. Обратите внимание, что URL-адреса имеют максимальную длину 2 КБ, поэтому, если вы хотите закодировать более 2 КБ байт (за вычетом других символов URL-адреса), вам придется отправлять данные с помощью POST.
`choe=< output_encoding >`	Необязательный	Как закодировать данные в QR-коде. Вот доступные значения: `UTF-8` [ по умолчанию ] `Shift_JIS` `ISO-8859-1`
`chld=< error_correction_level >\|< margin >`	Необязательный	error_correction_level — QR-коды поддерживают четыре уровня исправления ошибок, позволяющие восстановить отсутствующие, неправильно прочитанные или скрытые данные. Большая избыточность достигается за счет возможности хранить меньше данных. Подробности смотрите в приложении . Вот поддерживаемые значения: `L` — [ По умолчанию ] Позволяет восстановить до 7% потерь данных. `M` — позволяет восстановить до 15 % потерянных данных. `Q` : позволяет восстановить до 25 % потерянных данных. `H` — позволяет восстановить до 30 % потерянных данных. поле — ширина белой рамки вокруг части данных кода. Это в строках , а не в пикселях . (Чтобы узнать, какие строки находятся в QR-коде, см . ниже .) Значение по умолчанию — 4.

Пример:

QR code
cht=qr chl=Hello+world choe=UTF-8

Подробности QR-кода [ Необязательное чтение ]

Вот еще немного о том, как работают QR-коды; вам не обязательно знать это, чтобы иметь возможность создать QR-код.

QR-коды представляют собой квадраты с равным количеством строк и столбцов. Существует фиксированный набор размеров QR-кода: от 21 до 177 строк/столбцов, увеличивающихся с шагом в четыре. Каждая конфигурация называется версией . Чем больше строк/столбцов, тем больше данных может хранить код. Вот краткий обзор версий:

Версия 1 имеет 21 строку и 21 столбец и может кодировать до 25 буквенно-цифровых символов.
Версия 2 имеет 25 строк и 25 столбцов и может кодировать до 47 буквенно-цифровых символов.
Версия 3 имеет 29 строк и 29 столбцов и может кодировать до 77 буквенно-цифровых символов.
...
Версия 40 имеет 177 строк и 177 столбцов и может кодировать до 4296 буквенно-цифровых символов.

Не путайте количество строк и столбцов с размером изображения QR-кода. Размер пикселя кода определяется, как обычно, с помощью chs .

API определит, какую версию использовать, в зависимости от объема предоставленных вами данных.

Соответствующая версия QR-кода будет возвращена в зависимости от количества введенных вами символов. Например, если вы укажете 55 буквенно-цифровых символов, вы получите QR-код версии 3, хотя это может измениться, если вы явно укажете уровень исправления ошибок (EC) с помощью параметра chld .

Прежде чем создавать QR-код, подумайте, какое устройство используется для считывания вашего кода: лучшие считыватели QR-кодов способны считывать коды версии 40; мобильные устройства могут читать только до версии 4.

В следующей таблице приведены характеристики нескольких различных версий:

Версия	Строки х Столбцы	уровень ЕС	Максимальное количество персонажей в зависимости от уровня EC и типа персонажа
Версия	Строки х Столбцы	уровень ЕС	Цифры: от 0 до 9	Буквенно-цифровой: от 0 до 9, от А до Я, пробел, $ % * + - . / :	Двоичный	Кандзи
1	21x21	л	41	25	17	10
		М	34	20	14	8
		вопрос	27	16	11	7
		ЧАС	17	10	7	4
2	25x25	л	77	47	32	20
		М	63	38	26	16
		вопрос	48	29	20	12
		ЧАС	34	20	14	8
3	29x29	л	127	77	53	32
		М	101	61	42	26
		вопрос	77	47	32	20
		ЧАС	58	35	24	15
4	33x33	л	187	114	78	48
		М	149	90	62	38
		вопрос	111	67	46	28
		ЧАС	82	50	34	21
10	57x57	л	652	395	271	167
		М	513	311	213	131
		вопрос	364	221	151	93
		ЧАС	288	174	119	74
40	177x177	л	7089	4296	2953	1817
		М	5,596	3,391	2331	1435
		вопрос	3993	2420	1663	1024
		ЧАС	3057	1852	1273	784

Дополнительная информация и стандарты

Стандарт QR-кода является зарегистрированной торговой маркой Denso Wave, Inc.

ISO продает спецификацию на английском языке на своем сайте . Японская версия бесплатна.

Стандарты QR-кодов утверждены как:

Международный стандарт AIM (Международная организация производителей автоматической идентификации) (ISS — QR-код) в октябре 1997 года.
Стандарт JEIDA (Японской ассоциации развития электронной промышленности) (JEIDA-55) в марте 1998 года.
Стандарт JIS (Японские промышленные стандарты) (JIS X 0510) в январе 1999 г.
Международный стандарт ISO (ISO/IEC18004) в июне 2000 года.

Программное обеспечение для считывания QR-кода доступно из многих источников. Google предлагает бесплатную библиотеку для чтения QR-кодов Zebra Crossing (ZXing). Подробнее см. http://code.google.com/p/zxing/ .

См. «Содержимое штрих-кода» для получения примерного руководства по стандартному кодированию информации в штрих-кодах.