Codici QR

Puoi creare un codice QR in tempo reale con una richiesta URL GET.

Panoramica

I codici QR sono un tipo molto diffuso di codice a barre bidimensionale. 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 un testo qualsiasi, ad esempio URL, dati di contatto, un numero di telefono o 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 telefoni cellulari.

Sintassi

URL di base: https://chart.googleapis.com/chart?

Le richieste di codice 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 dell'immagine.
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 tipi di dati all'interno di un codice QR. I dati devono avere codifica URL UTF-8. Tieni presente che gli URL hanno una lunghezza massima di 2000 byte, quindi se vuoi codificare più di 2000 byte (meno gli altri caratteri URL), dovrai inviare i dati tramite POST.
choe=<output_encoding> Facoltativo Come codificare i dati nel codice QR. Ecco i valori disponibili:
  • UTF-8 [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, non letti correttamente o oscurati. Una maggiore ridondanza viene raggiunta al costo di poter archiviare meno dati. Per informazioni dettagliate, consulta l'appendice. Di seguito sono riportati i valori supportati:
    • L - [Predefinito] Consente il recupero fino al 7% di una perdita di dati
    • M - Consente di recuperare fino al 15% di perdita di dati
    • Q - Consente di recuperare fino al 25% di perdita di dati
    • H - Consente di recuperare una perdita di dati fino al 30%
  • margine - La larghezza del bordo bianco intorno alla parte di dati del codice. Indicabile in righe, non in pixel. (consulta di seguito per scoprire quali righe sono presenti in un codice QR.) Il valore predefinito è 4.

 

Esempio:

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

Dettagli del codice QR [Lettura facoltativa]

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

I codici QR sono quadrati con lo stesso numero di righe e colonne. Esiste un insieme fisso di dimensioni dei codici QR: da 21 a 177 righe/colonne, con incrementi di quattro. Ogni configurazione è chiamata versione. Maggiore è il numero di righe/colonne, maggiore è la quantità di dati che il codice può 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 come di consueto chs.

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

Verrà restituita la versione del codice QR appropriata a seconda del numero di caratteri forniti. Ad esempio, se fornisci 55 caratteri alfanumerici, riceverai un codice QR della versione 3, che potrebbe cambiare se specifichi esplicitamente un livello di correzione degli errori (EC) usando il parametro chld.

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

La tabella seguente 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, $ % * + - . / : 		Proprietà binaria 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 7089 4296 2.953 1.817
L 5.596 3.391 2.331 1.435
D 3.993 2420 1.663 1024
V 3.057 1.852 1.273 784

Ulteriori informazioni e standard

Lo standard per i codici QR è un marchio registrato da Denso Wave, Inc.

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

Gli standard dei codici QR sono approvati come:

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

Il software per il lettore di codici QR è disponibile da molte fonti. Google offre senza costi una libreria di lettori 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 nei codici a barre.