QR-коды

Вы можете создать 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% потерянных данных
  • margin — ширина белой границы вокруг части данных кода. Это в строках , а не в пикселях . (См. ниже , чтобы узнать, какие строки находятся в QR-коде.) Значение по умолчанию — 4.

Пример:

QR код
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.

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

Версия Строки x столбцы уровень ЕС Максимальное количество персонажей по уровню 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 3391 2331 1435
Вопрос 3993 2420 1663 1024
ЧАС 3057 1852 1273 784

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

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

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

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

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

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

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