Вы можете создать 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-коде. Вот доступные значения:
|
chld=< error_correction_level >|< margin > | Необязательный |
|
Пример:
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/ .
См. «Содержимое штрих-кода» для получения примерного руководства по стандартному кодированию информации в штрих-кодах.