QR-Codes

Sie können direkt einen QR-Code mit einer URL GET-Anfrage erstellen.

Überblick

QR-Codes sind eine beliebte Art von zweidimensionalen Barcodes. Sie werden auch als Hardlinks oder Hyperlinks bezeichnet. QR-Codes speichern bis zu 4.296 alphanumerische Zeichen beliebigen Textes. 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. Solche Geräte reichen 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 unterstützt. in der Stamm-URL:

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. Sie können Datentypen nicht innerhalb eines QR-Codes mischen. Die Daten müssen URL-codiert sein. URLs haben eine maximale Länge von 2 KB. Wenn Sie also mehr als 2 KB (abzüglich der 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 Korrekturebenen, um fehlende, falsch gelesene oder verdeckte Daten wiederherzustellen. Eine größere Redundanz wird auf Kosten der Möglichkeit erreicht, weniger Daten speichern zu können. Weitere Informationen finden Sie im Anhang. Folgende Werte werden unterstützt:
    • L – [Standard] ermöglicht die Wiederherstellung von bis zu 7% Datenverlust
    • 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. Dieser Wert wird in Zeilen und nicht in Pixeln angegeben. Informationen zu den Zeilen eines QR-Codes finden Sie unten. Der Standardwert ist 4.

 

Example:

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

Details zum QR-Code [optional]

Hier erfährst du mehr darüber, wie QR-Codes funktionieren. Du musst diese nicht zwingend wissen, um einen QR-Code generieren zu können.

QR-Codes sind Quadrate mit gleich vielen Zeilen und Spalten. Es gibt einen festen Satz von QR-Code-Größen: von 21 auf 177 Zeilen/Spalten, die in Schritten von vier ansteigen. 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 die Anzahl der Zeilen und Spalten nicht mit der Größe des QR-Code-Bilds. Die Pixelgröße des Codes wird wie gewohnt mithilfe von chs bestimmt.

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

Je nach Anzahl der 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. Dies kann sich jedoch ändern, wenn Sie explizit mit dem Parameter chld eine Fehlerkorrekturstufe (Error Correction, EC) angeben.

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

In der folgenden Tabelle sind die Merkmale 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 wird von Denso Wave, Inc. geschützt.

ISO verkauft die englische Sprachspezifikation auf seiner Website. Die japanische Version ist kostenlos.

QR-Code-Standards werden genehmigt als:

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

Die Software zum Scannen von QR-Codes ist aus vielen Quellen erhältlich. Google bietet Zebra Crossing (ZXing) kostenlos an, eine Bibliothek für QR-Code-Lesegeräte. Weitere Informationen finden Sie unter http://code.google.com/p/zxing/.

Unter Barcode-Inhalte finden Sie eine grobe Anleitung zur Standardcodierung von Informationen in Barcodes.