QR-Codes

Mit einer URL GET-Anfrage können Sie im Handumdrehen einen QR-Code erstellen.

Überblick

QR-Codes sind eine beliebte Art von zweidimensionalen Barcodes. Sie werden auch als Hardlinks oder Hyperlinks zur physischen Welt bezeichnet. QR-Codes können bis zu 4.296 alphanumerische Zeichen beliebigen Texts speichern. Dieser Text kann beliebig sein, z. B. eine URL, Kontaktdaten, eine Telefonnummer oder sogar ein Gedicht. QR-Codes können von einem optischen Gerät mit der entsprechenden Software gelesen werden. Das Angebot reicht von dedizierten QR-Code-Lesegeräten bis hin zu Smartphones.

Syntax

Stamm-URL: https://chart.googleapis.com/chart?

Bei QR-Code-Anfragen werden die folgenden URL-Suchparameter nach dem Fragezeichen ? in der Stamm-URL enthalten:

Parameter Erforderlich oder optional Beschreibung
cht=qr Erforderlich Gibt einen QR-Code an.
chs=<width>x<height> Erforderlich Bildgröße.
chl=<data> Erforderlich Die zu codierenden Daten. Daten können Ziffern (0–9), alphanumerische Zeichen, binäre Datenbyte oder Kanji sein. Datentypen können innerhalb eines QR-Codes nicht gemischt werden. Die Daten müssen URL-codiert sein. URLs haben eine maximale Länge von 2.000 Byte. Wenn Sie also mehr als 2.000 Byte (ohne die anderen URL-Zeichen) codieren möchten, müssen Sie Ihre Daten mit POST senden.
choe=<output_encoding> Optional So codieren Sie die Daten im QR-Code. Folgende Werte sind verfügbar:
  • UTF-8 [Standard]
  • Shift_JIS
  • ISO-8859-1
chld=<error_correction_level>|<margin> Optional
  • error_correction_level: QR-Codes unterstützen vier Ebenen der Fehlerkorrektur, um fehlende, falsch gelesene oder verdeckte Daten wiederherzustellen. Eine höhere Redundanz wird auf Kosten erzielt, da weniger Daten gespeichert werden können. Weitere Informationen finden Sie im Anhang. Folgende Werte werden unterstützt:
    • L: [Standardeinstellung] ermöglicht die Wiederherstellung eines Datenverlusts von bis zu 7 %
    • M – Ermöglicht die Wiederherstellung von bis zu 15% Datenverlust
    • Q – Ermöglicht die Wiederherstellung von bis zu 25% Datenverlust
    • H – Ermöglicht die Wiederherstellung von bis zu 30% Datenverlust
  • margin – Breite des weißen Rahmens um den Datenteil des Codes. Die Angabe erfolgt in Zeilen, nicht in Pixeln. Unten finden Sie Informationen dazu, welche Zeilen ein QR-Code enthält. Der Standardwert ist 4.

 

Example:

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

Details zum QR-Code [optionale Informationen]

Im Folgenden findest du weitere Informationen zur Funktionsweise von QR-Codes. Dies ist nicht zwingend erforderlich, um einen QR-Code generieren zu können.

QR-Codes sind Quadrate mit der gleichen Anzahl von Zeilen und Spalten. Es gibt einen festen Satz von QR-Code-Größen: von 21 bis 177 Zeilen/Spalten, die in 4-Schritten erhöht werden. Jede Konfiguration wird als Version bezeichnet. Je mehr Zeilen/Spalten vorhanden sind, desto mehr Daten kann der Code speichern. Hier eine Zusammenfassung der Versionen:

  • Version 1 hat 21 Zeilen und 21 Spalten und kann bis zu 25 alphanumerische Zeichen codieren
  • Version 2 hat 25 Zeilen und 25 Spalten und kann bis zu 47 alphanumerische Zeichen codieren
  • Version 3 hat 29 Zeilen und 29 Spalten und kann bis zu 77 alphanumerische Zeichen codieren
  • ...
  • Version 40 hat 177 Zeilen und 177 Spalten und kann bis zu 4.296 alphanumerische Zeichen codieren

Verwechseln Sie nicht die Anzahl der Zeilen und Spalten mit der Größe des QR-Code-Bildes. Die Pixelgröße des Codes wird wie gewohnt mit chs bestimmt.

Die API bestimmt anhand der von Ihnen bereitgestellten Datenmenge, welche Version verwendet werden soll.

Je nach der Anzahl der von Ihnen angegebenen Zeichen wird die entsprechende QR-Code-Version zurückgegeben. Wenn Sie beispielsweise 55 alphanumerische Zeichen angeben, erhalten Sie einen QR-Code der Version 3. Dieser kann sich jedoch ändern, wenn Sie mit dem Parameter chld explizit eine EC-Ebene (Fehlerkorrektur) angeben.

Bevor Sie den QR-Code generieren, überlegen Sie, welche Art von Gerät zum Lesen des Codes verwendet wird: Die besten QR-Code-Lesegeräte können Version 40-Codes lesen, Mobilgeräte können möglicherweise nur bis Version 4 lesen.

In der folgenden Tabelle sind die Merkmale einiger verschiedener Versionen zusammengefasst:

Version Zeilen x Spalten EC-Ebene Maximale Zeichenanzahl nach EC-Ebene und Zeichentyp
Ziffern: 0 bis 9 Alphanumerisch:
0 bis 9, A bis Z,
Leerzeichen, $ % * + - . /
Binär Kanji
1 21x21 L 41 25 17 10
M 34 20 14 8
F 27 16 11 7
H 17 10 7 4
2 25x25 L 77 47 32 20
M 63 38 26 16
F 48 29 20 12
H 34 20 14 8
3 29x29 L 127 77 53 32
M 101 61 42 26
F 77 47 32 20
H 58 35 24 15
4 33x33 L 187 114 78 48
M 149 90 62 38
F 111 67 46 28
H 82 50 34 21
10 57x57 L 652 395 271 167
M 513 311 213 131
F 364 221 151 93
H 288 174 119 74
40 177 × 177 L 7,089 4,296 2,953 1,817
M 5,596 3,391 2,331 1,435
F 3,993 2,420 1,663 1.024
H 3.057 1,852 1,273 784

Weitere Informationen und Standards

Der QR-Code-Standard ist durch Denso Wave, Inc. geschützt.

Das ISO verkauft die englischsprachige Spezifikation auf seiner Website. Die japanische Version ist kostenlos.

QR-Code-Standards sind genehmigt als:

  • AIM International (Automatic Identification Manufacturers International) Standard (ISS – QR Code) im Oktober 1997.
  • JEIDA-Standard (Japanese Electronic Industry Development Association) (JEIDA-55) im März 1998.
  • JIS-Standard (Japanese Industrial Standards) (JIS X 0510) im Januar 1999.
  • Internationaler ISO-Standard (ISO/IEC18004) im Juni 2000.

Es gibt eine Vielzahl von Quellen zum QR-Code-Lesegerät. Google bietet kostenlos die QR-Code-Lesebibliothek Zebra Crossing (ZXing) an. Weitere Informationen finden Sie unter http://code.google.com/p/zxing/.

Unter Barcodeinhalte finden Sie einen groben Leitfaden für die Standardcodierung von Informationen in Barcodes