Codes 2D

Vous pouvez créer un code QR à la volée à l'aide d'une requête GET URL.

Présentation

Les codes QR sont un type populaire de code-barres bidimensionnel. Ils sont également appelés hardlinks ou hyperlinks physiques. Les codes QR stockent jusqu'à 4 296 caractères alphanumériques de texte arbitraire. Il peut s'agir d'une URL, de coordonnées, d'un numéro de téléphone ou même d'un poème. Les codes QR peuvent être lus par un appareil optique équipé du logiciel approprié. Il peut s'agir de lecteurs de code QR dédiés ou de 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 kanji. Vous ne pouvez pas mélanger les 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 octets. 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 dans le 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 pour permettre la récupération des données manquantes, mal lues ou dissimulées. Vous obtenez une redondance accrue au détriment de la capacité à 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 de code. Cette valeur est exprimée en lignes, et non en pixels. (Consultez la section ci-dessous pour découvrir 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 nécessairement besoin de le savoir pour pouvoir en générer un.

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 étapes de quatre. Chaque configuration est appelée version. Plus le nombre de lignes/colonnes est important, plus le code peut stocker de données. Voici un résumé 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éterminera la version à utiliser en fonction de la quantité de données que vous fournissez.

La version appropriée du code QR sera 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 le lire: les meilleurs lecteurs de code QR sont capables de lire les codes de la version 40, tandis que les appareils mobiles ne peuvent lire que la version 4.

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

Version Lignes x colonnes Niveau du suivi avancé des conversions Nombre maximal de caractères par niveau de suivi avancé des conversions et type de caractère
Chiffres: de 0 à 9 Alphanumérique:
0 à 9, A à Z,
espace, $ % * + - . / : 		Binaire Kanji
1 21x21 L 41 25 17 10
Lu 34 20 14 8
Q 27 16 11 7
H 17 10 7 4
2 25x25 L 77 47 32 20
Lu 63 38 26 16
Q 48 29 20 12
H 34 20 14 8
3 29x29 L 127 77 53 32
Lu 101 61 42 26
Q 77 47 32 20
H 58 35 24 15
4 33x33 L 187 114 78 48
Lu 149 90 62 38
Q 111 67 46 28
H 82 50 34 21
10 57x57 L 652 395 271 167
Lu 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
Lu 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 une marque déposée par Denso Wave, Inc.

L'ISO vend les spécifications de la langue anglaise sur son site. La version japonaise est sans frais.

Les normes de code QR sont approuvées en tant que:

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

Un lecteur de code QR est disponible dans de nombreuses sources. Google propose sans frais une bibliothèque de lecteurs de codes QR, Zebra Crossing (ZXing). Pour en savoir plus, consultez http://code.google.com/p/zxing/.

Pour obtenir un guide approximatif de l'encodage standard des informations dans les codes-barres, consultez la page Contenu des codes-barres.