Codes 2D

Vous pouvez créer un code QR à la volée avec une demande URL GET.

Présentation

Les codes QR sont un type populaire de code-barres bidimensionnel. Ils sont également appelés hardlinks ou liens hypertextes physiques. Les codes QR stockent jusqu'à 4 296 caractères alphanumériques de texte arbitraire. Il peut s'agir de n'importe quel texte, comme une URL, des coordonnées, un numéro de téléphone ou même un poème ! Les codes QR peuvent être lus par un périphérique optique équipé du logiciel approprié. Ces appareils vont des lecteurs de code QR dédiés aux téléphones mobiles.

Syntaxe

URL racine:https://chart.googleapis.com/chart?

Les requêtes de code QR sont compatibles avec les paramètres de requête d'URL suivants après le point d'interrogation dans l'URL racine:

Paramètres Obligatoire ou facultatif Description
cht=qr Obligatoire Spécifie un code QR.
chs=<width>x<height> Obligatoire Taille de l'image.
chl=<data> Obligatoire Données à encoder. Les données peuvent être des chiffres (0 à 9), des caractères alphanumériques, des octets binaires de données ou des kanjis. Vous ne pouvez pas mélanger des types de données dans un code QR. Les données doivent être encodées au format URL UTF-8. Notez que les URL ont une longueur maximale de 2 000. Par conséquent, si vous souhaitez encoder plus de 2 000 octets (moins les autres caractères d'URL), vous devez envoyer vos données à l'aide de la méthode POST.
choe=<output_encoding> Facultatif Encoder les données du code QR Voici les valeurs disponibles :
  • UTF-8 [par défaut]
  • Shift_JIS
  • ISO-8859-1
chld=<error_correction_level>|<margin> Facultatif
  • error_correction_level : les codes QR sont compatibles avec quatre niveaux de correction d'erreur afin de permettre la récupération des données manquantes, mal lues ou masquées. Une plus grande redondance est obtenue au prix de la possibilité de stocker moins de données. Pour en savoir plus, consultez l'annexe. Voici les valeurs acceptées :
    • L - [Par défaut] Permet de récupérer jusqu'à 7% de perte de données
    • M : permet de récupérer jusqu'à 15% de données perdues
    • Q : permet de récupérer jusqu'à 25% de données perdues
    • H : permet de récupérer jusqu'à 30% de données perdues
  • margin : largeur de la bordure blanche autour de la partie données du code. Cela se compte en lignes, et non en pixels. (Voir ci-dessous pour savoir quelles sont les lignes d'un code QR.) La valeur par défaut est 4.

 

Exemple :

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

Détails du code QR [lecture facultative]

Voici un peu plus d'informations sur le fonctionnement des codes QR. Vous n'avez pas besoin de les connaître pour pouvoir générer un code QR.

Les codes QR sont des carrés, avec un nombre égal de lignes et de colonnes. Il existe un ensemble fixe de tailles de code QR: de 21 à 177 lignes/colonnes, augmentant par étape de 4. Chaque configuration est appelée version. Plus il y a de lignes/colonnes, plus le code peut stocker de données. Voici un récapitulatif des versions:

  • La version 1 comporte 21 lignes et 21 colonnes, et peut encoder jusqu'à 25 caractères alphanumériques
  • La version 2 comporte 25 lignes et 25 colonnes, et peut encoder jusqu'à 47 caractères alphanumériques
  • La version 3 comporte 29 lignes et 29 colonnes, et peut encoder jusqu'à 77 caractères alphanumériques
  • ...
  • La version 40 comporte 177 lignes et 177 colonnes, et peut encoder jusqu'à 4 296 caractères alphanumériques

Ne confondez pas le nombre de lignes et de colonnes avec la taille de l'image du code QR. La taille en pixels du code est déterminée à l'aide de chs, comme d'habitude.

L'API détermine la version à utiliser en fonction de la quantité de données que vous fournissez.

La version appropriée du code QR est renvoyée en fonction du nombre de caractères que vous fournissez. Par exemple, si vous fournissez 55 caractères alphanumériques, vous obtiendrez un code QR version 3. Toutefois, cela peut changer si vous spécifiez explicitement un niveau de correction d'erreur à l'aide du paramètre chld.

Avant de générer votre code QR, réfléchissez au type d'appareil utilisé pour lire votre code: les meilleurs lecteurs de code QR sont capables de lire les codes de la version 40. Il est possible que les appareils mobiles ne puissent lire que la version 4.

Le tableau suivant récapitule les caractéristiques de plusieurs versions:

Version Lignes x Colonnes Niveau de suivi avancé des conversions Nombre maximal de caractères par niveau de suivi avancé des conversions et par type
Chiffres: de 0 à 9 Alphanumériques:
0 à 9, A à Z,
espace, $ % * + - . / : 		Binaire Kanji
1 21x21 L 41 25 17 10
M 34 20 14 8
Q 27 16 11 7
H 17 10 7 4
2 25x25 L 77 47 32 20
M 63 38 26 16
Q 48 29 20 12
H 34 20 14 8
3 29x29 L 127 77 53 32
M 101 61 42 26
Q 77 47 32 20
H 58 35 24 15
4 33x33 L 187 114 78 48
M 149 90 62 38
Q 111 67 46 28
H 82 50 34 21
10 57x57 L 652 395 271 167
M 513 311 213 131
Q 364 221 151 93
H 288 174 119 74
40 177x177 L 7,089 4,296 2,953 1,817
M 5,596 3,391 2,331 1,435
Q 3,993 2,420 1,663 1 024
H 3 057 1,852 1,273 784

Informations complémentaires et normes

La norme de code QR est déposée par Denso Wave, Inc.

L'ISO vend les spécifications en anglais sur son site. La version japonaise est sans frais.

Les normes de code QR sont approuvées comme:

  • la norme AIM International (Automatic Identification Manufacturers International) (ISS (Code QR)) en octobre 1997.
  • la norme JEIDA (Japan Electronic Industry Development Association) (JEIDA-55) en mars 1998.
  • la norme JIS (norme industrielle japonaise) (JIS X 0510) en janvier 1999.
  • la norme internationale ISO (ISO/IEC18004) en juin 2000.

Les logiciels de lecture de code QR sont disponibles auprès de nombreuses sources. Google propose sans frais une bibliothèque de lecteurs de code QR, Zebra Crossing (ZXing). Pour en savoir plus, consultez la page http://code.google.com/p/zxing/.

Pour obtenir une description approximative du codage standard des informations dans les codes-barres, consultez la section Contenu des codes-barres.