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