Codici QR

Puoi creare un codice QR all'istante con una richiesta URL GET.

Panoramica

I codici QR sono un tipo comune di codici a barre bidimensionali. Sono noti anche come hardlink o link ipertestuali del mondo fisico. I codici QR memorizzano fino a 4296 caratteri alfanumerici di testo arbitrario. Può trattarsi di qualsiasi testo, ad esempio URL, dati di contatto, un numero di telefono e persino una poesia. I codici QR possono essere letti da un dispositivo ottico con il software appropriato. Questi dispositivi spaziano dai lettori di codici QR dedicati ai cellulari.

Sintassi

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

Le richieste di codici QR supportano i seguenti parametri di query dell'URL dopo il carattere ? nell'URL principale:

Parametro Obbligatorio o facoltativo Descrizione
cht=qr Obbligatorio Specifica un codice QR.
chs=<width>x<height> Obbligatorio Dimensioni delle immagini.
chl=<data> Obbligatorio I dati da codificare. I dati possono essere cifre (0-9), caratteri alfanumerici, byte binari di dati o Kanji. Non puoi combinare i tipi di dati all'interno di un codice QR. I dati devono utilizzare la codifica URL UTF-8. Tieni presente che gli URL hanno una lunghezza massima di 2000, quindi se vuoi codificare più di 2000 byte (meno gli altri caratteri URL), devi inviare i dati tramite POST.
choe=<output_encoding> Facoltativo Come codificare i dati nel codice QR. Ecco i valori disponibili:
  • UTF-8 [valore predefinito]
  • Shift_JIS
  • ISO-8859-1
chld=<error_correction_level>|<margin> Facoltativo
  • error_correction_level: i codici QR supportano quattro livelli di correzione degli errori per consentire il recupero di dati mancanti, letti erroneamente o oscurati. Si ottiene una maggiore ridondanza a costo di archiviare meno dati. Per ulteriori dettagli, vedi l'appendice. Ecco i valori supportati:
    • L: [valore predefinito] consente il recupero della perdita di dati fino al 7%
    • M: consente il recupero fino al 15% della perdita di dati
    • Q: consente il recupero fino al 25% della perdita di dati
    • H: consente il recupero fino al 30% della perdita di dati
  • margin: la larghezza del bordo bianco intorno alla porzione di dati del codice. Questo dato è espresso in righe, non in pixel. (Vedi di seguito per sapere quali righe sono in un codice QR). Il valore predefinito è 4.

 

Esempio:

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

Dettagli codice QR [Lettura facoltativa]

Di seguito sono riportate ulteriori informazioni sul funzionamento dei codici QR; non è necessario conoscerli per poter generare un codice QR.

I codici QR sono quadrati, con un numero uguale di righe e colonne. È disponibile un insieme fisso di dimensioni dei codici QR: da 21 a 177 righe/colonne, con incrementi di quattro. Ogni configurazione è chiamata versione. Più righe/colonne, maggiore sarà la quantità di dati che il codice potrà archiviare. Ecco un riepilogo delle versioni:

  • La versione 1 ha 21 righe e 21 colonne e può codificare fino a 25 caratteri alfanumerici
  • La versione 2 ha 25 righe e 25 colonne e può codificare fino a 47 caratteri alfanumerici
  • La versione 3 ha 29 righe e 29 colonne e può codificare fino a 77 caratteri alfanumerici
  • ...
  • La versione 40 ha 177 righe e 177 colonne e può codificare fino a 4296 caratteri alfanumerici

Non confondere il numero di righe e colonne con le dimensioni dell'immagine del codice QR. La dimensione in pixel del codice viene determinata utilizzando chs come di consueto.

L'API determinerà quale versione utilizzare in base alla quantità di dati forniti.

A seconda del numero di caratteri fornito, verrà restituita la versione corretta del codice QR. Ad esempio, se fornisci 55 caratteri alfanumerici, riceverai un codice QR della versione 3, anche se questo può cambiare se specifichi un livello di correzione degli errori (EC) in modo esplicito utilizzando il parametro chld.

Prima di generare il codice QR, valuta il tipo di dispositivo utilizzato per leggerlo: i migliori lettori di codici QR sono in grado di leggere i codici della versione 40; i dispositivi mobili potrebbero essere in grado di leggere solo fino alla versione 4.

La tabella riportata di seguito riassume le caratteristiche di alcune versioni diverse:

Versione Righe x Colonne Livello EC Numero massimo di caratteri per livello EC e tipo di carattere
Cifre: da 0 a 9 Alfanumerico:
da 0 a 9, dalla A alla Z,
spazio, $ % * + - . / : 		Programma binario kanji
1 21x21 L 41 25 17 10
L 34 20 14 8
D 27 16 11 7
V 17 10 7 4
2 25x25 L 77 47 32 20
L 63 38 26 16
D 48 29 20 12
V 34 20 14 8
3 29x29 L 127 77 53 32
L 101 61 42 26
D 77 47 32 20
V 58 35 24 15
4 33x33 L 187 114 78 48
L 149 90 62 38
D 111 67 46 28
V 82 50 34 21
10 57x57 L 652 395 271 167
L 513 311 213 131
D 364 221 151 93
V 288 174 119 74
40 177x177 L 7,089 4,296 2,953 1,817
L 5,596 3,391 2,331 1,435
D 3,993 2,420 1,663 1024
V 3.057 1,852 1,273 784

Ulteriori informazioni e standard

Lo standard del codice QR è un marchio registrato di Denso Wave, Inc.

L'ISO vende la specifica in lingua inglese sul proprio sito. La versione in giapponese è senza costi.

Gli standard relativi ai codici QR sono approvati come:

  • AIM International (Automatic Identification Manufacturers International) (ISS - QR Code) nell'ottobre 1997.
  • JEIDA (Japanese Electronic Industry Development Association) (JEIDA-55) nel marzo 1998.
  • JIS (Japanese Industrial Standards) (JIS X 0510) nel gennaio 1999.
  • standard internazionale ISO (ISO/IEC18004) nel giugno 2000.

Il software di lettura dei codici QR è disponibile da molte fonti. Google offre senza costi una libreria con lettore di codici QR, Zebra Crossing (ZXing). Per maggiori dettagli, visita la pagina http://code.google.com/p/zxing/.

Consulta la sezione Contenuti dei codici a barre per una guida approssimativa alla codifica standard delle informazioni in codici a barre