Un passaporto fa un regalo a chi lo elabora: la zona a lettura ottica. Un blocco di lettere maiuscole, cifre e caratteri di riempimento < in fondo alla pagina dati, con cifre di controllo calcolate sui suoi campi. Leggi la zona, ricalcoli le cifre e sai se la lettura è coerente prima di fidarti di un solo campo.
Una patente di guida di solito non ti dà niente di tutto questo. La maggior parte degli emittenti non stampa alcuna zona a lettura ottica sulla patente, quindi non c'è niente da ricalcolare. Gli sviluppatori che hanno costruito il primo flusso sui passaporti spesso lo scoprono a proprie spese, quando il codice che "valida la MRZ" incontra una tessera senza zona e comincia a trattare una patente perfettamente valida come un errore.
Questo articolo parla di quel caso. Cosa riporta una patente al posto della zona, cosa un'API di riconoscimento può e non può dirti, e come controllare tu stesso i campi quando non ci sono cifre di controllo su cui contare. Le citazioni di AAMVA e dell'UE sono tradotte da noi; gli originali sono in inglese.
Questo è il blog di doc.cheap, un'API OCR per passaporti e documenti d'identità. Leggi la parte sul prodotto tenendolo presente.
Cosa riporta una patente al suo posto
Non esiste un formato unico di patente. Ogni emittente progetta la propria tessera, e gli standard esistenti stabiliscono cosa deve contenere e come deve essere organizzata, non una stringa fissa da analizzare.
Nord America: un codice a barre sul retro. L'American Association of Motor Vehicle Administrators pubblica l'AAMVA DL/ID Card Design Standard per le tessere rilasciate dai suoi membri. L'edizione 2026 ha un allegato intitolato "Codice a barre PDF417 obbligatorio", che dice: "La simbologia di codice a barre bidimensionale PDF417 è la tecnologia minima obbligatoria a lettura ottica che deve essere presente sui documenti DL/ID conformi". Lo stesso allegato aggiunge: "Tutti i dati obbligatori e facoltativi devono essere non cifrati". Quindi una tessera conforme riporta i dati del titolare due volte: stampati sul fronte e codificati in un codice a barre bidimensionale che chiunque abbia un decodificatore può leggere.
L'UE: un modello di tessera comune, letto dalla faccia. La pagina di La tua Europa sulla conversione e il riconoscimento delle patenti descrive la patente attuale come "il nuovo formato standard dell'UE (tessera con fotografia in plastica, del formato di una carta di credito)". L'impaginazione è comune, ma ciò che ne leggi è il testo stampato. Sono ancora in circolazione anche vecchie patenti cartacee: la stessa pagina dice che "se hai una patente UE del vecchio modello, puoi ancora usarla in tutti i paesi dell'UE", e che una patente del genere va sostituita "entro il 2033 al più tardi".
Il livello internazionale. La pagina stessa di AAMVA osserva che il lavoro verso uno standard internazionale per le patenti si svolge in ISO, e che "lo standard internazionale (18013) stabilisce linee guida sul formato e sul contenuto delle patenti di guida dei veicoli a motore (DL)". Elenca le tecnologie di cui lo standard si occupa, tra cui "codici a barre, mono e bidimensionali" e "riconoscimento ottico dei caratteri". In altre parole, lo standard lascia scegliere all'emittente; non ti consegna una zona con cifre di controllo.
Il risultato pratico per chi elabora il documento:
| Passaporto | Patente di guida | |
|---|---|---|
| Zona a lettura ottica | Sempre, nella pagina dati | Di solito nessuna |
| Cifre di controllo che puoi ricalcolare | Sì, sulla zona | Nessuna, quando non c'è zona |
| Una seconda copia dei dati | La zona | Un codice a barre, se l'emittente lo stampa (di solito sul retro) |
| Data di scadenza | Stampata nella pagina dati | Stampata quando la patente ne ha una; alcune valgono a vita |
| Cosa ti dice che la lettura è coerente | La zona confrontata con la pagina stampata | I tuoi controlli sui campi stampati |
Perché "nessuna zona" non deve voler dire "non valida"
Se il tuo flusso è nato con i passaporti, probabilmente si dirama in base alla zona: superata, prosegui; non superata, chiedi una nuova foto. Una patente aggiunge una terza risposta, ed è quella più comune.
doc.cheap riporta la zona come un unico verdetto, mrz.status, con tre valori. passed significa che la zona è presente e ogni cifra di controllo è stata validata. failed significa che una zona è stata letta e qualcosa non tornava. absent significa che il documento non ne ha – e allora reason, lines e text sono tutti null. La guida alla patente di guida lo dice chiaramente: "Tratta absent come un esito normale, non come un errore."
Il resto del documento non ne risente. Una patente viene riconosciuta dalla sua faccia stampata come qualsiasi altro documento, e meta.status torna recognized. Quindi la diramazione che ti serve non è "zona superata o rifiuto", ma:
failed– qualcosa in una zona non tornava; chiedi una foto migliore.passed– la zona è stata verificata; prosegui.absent– non c'era niente da verificare; passa ai tuoi controlli sui campi qui sotto.
Leggerla con una sola chiamata API
Una patente va allo stesso endpoint di un passaporto, con lo stesso corpo: un POST /v1/scans con la foto codificata in base64 dentro un JSON. La chiave pubblica di sandbox sk_sandbox_public funziona senza account. Usala con un'immagine di prova, mai con una patente vera: ogni scansione fatta con la chiave pubblica viene conservata per un anno per il registro interno del servizio.
curl -X POST https://api.doc.cheap/v1/scans \
-H "Authorization: Bearer sk_sandbox_public" \
-H "Content-Type: application/json" \
-d "{\"image\": \"$(base64 < licence-front.jpg | tr -d '\n')\"}"
Le parti della risposta che contano per una patente sono fatte così. Ogni valore è inventato, e lo Stato emittente è UTO, lo Stato fittizio usato dai documenti campione:
{
"meta": { "status": "recognized", "billed": true, "confidence": "high" },
"document": {
"country": "UTO",
"number": "DL0000000",
"issue_date": "2024-05-02",
"expiry_date": "2034-05-01",
"is_expired": false,
"days_remaining": 2725
},
"holder": {
"surname": "SPECIMEN",
"given_names": "ALEX JORDAN",
"birth_date": "1990-01-01"
},
"fields": [
{ "id": "dl_class@0", "name": "dl_class", "label": "Driving-licence class",
"category": "document", "value": "B, BE", "language": "English", "confidence": "high" },
{ "id": "authority@0", "name": "authority", "label": "Issuing authority",
"category": "document", "value": "UTOPIA LICENSING OFFICE", "language": "English", "confidence": "medium" }
],
"mrz": { "status": "absent", "reason": null, "lines": null, "text": null },
"authenticity": { "overall": "not_checked", "checks": [] }
}
Cosa leggerci:
fieldsè dove stanno i dati specifici della patente. Il catalogo dei campi elenca cosa riporta di solito una patente:surname,given_names,birth_date,document_number,dl_classopermit_class,issue_date,expiry_date,addresseauthority. Le parti dell'indirizzo (address_street,address_city,address_state,address_postal_code) vengono pubblicate anche separatamente, oltre all'indirizzo intero. L'insieme è aperto, quindi un campo che il vocabolario non nomina viene comunque pubblicato, nella categoriaother.- Usa
idcome chiave, nonname. Una patente stampata in due alfabeti restituisce una voce per lingua con lo stessoname; soloidè univoco. document.expiry_date,is_expirededays_remainingsono calcolati dalla data di scadenza stampata, a partire dal giorno della scansione.
Cosa aggiunge un codice a barre e cosa ne fa l'API
Un codice a barre decodificato non ha un gruppo tutto suo nella risposta. I suoi valori arrivano in fields insieme a tutto il resto, e images.barcode ne contiene un ritaglio quando è stato possibile estrarlo.
C'è un dettaglio pratico. L'endpoint legge un'immagine per chiamata, e un emittente che stampa un codice a barre di solito lo mette sul retro della tessera. Quando ti serve ciò che contiene il codice a barre, invia il retro come scansione separata e unisci tu i due risultati. Questa unione è anche il miglior sostituto delle cifre di controllo: due letture indipendenti della stessa tessera, che dovrebbero coincidere.
Validare una patente senza cifre di controllo
Senza zona, la coerenza è compito tuo. Nessuno di questi controlli dimostra che una patente sia autentica; servono a intercettare letture errate e dati palesemente sbagliati prima che arrivino al tuo database.
- Date in ordine.
birth_dateprima diissue_date,issue_datenel giorno della scansione o prima,expiry_datedopoissue_date. Una lettura che rompe quest'ordine è un errore di lettura o una foto scadente. - La scadenza dal documento, non da una formula. I periodi di validità cambiano da emittente a emittente – l'esempio della pagina UE stessa è una patente di Cipro "valida per 15 anni, invece di 10 anni come in Italia". Leggi la data sulla tessera; non calcolarla.
- Prevedi l'assenza della data di scadenza. La stessa pagina UE cita "patenti di guida UE valide a vita". Quando non è stata letta alcuna data di scadenza,
expiry_date,is_expirededays_remainingsononullinsieme, e anche il campo derivatodays_to_expireènull. Decidi cosa fa il tuo flusso in quel caso; non trattarenullper sbaglio né come scaduta né come valida. - La categoria, non solo la presenza. Se ti serve qualcuno abilitato a guidare l'auto, cerca quella categoria in
dl_classopermit_classinvece di controllare solo che esista una patente. Il valore è testo stampato comeB, BE, quindi dividilo prima del confronto, e confrontalo con le categorie definite dalla tua giurisdizione. - Fronte contro retro. Se la tessera ha un codice a barre, scansiona entrambi i lati e confronta il nome, la data di nascita e il numero del documento. Una discrepanza merita una seconda foto.
- Contro ciò che ha scritto l'utente. Confronta
holder.surnameeholder.birth_datecon il modulo compilato dal tuo utente, normalizzati allo stesso modo. - La confidenza come segnale. Ogni lettura ha una fascia –
high,mediumolow. Una fascialowsu un campo da cui dipendi è un buon motivo per chiedere una nuova foto.
Quanto costa una scansione quando non c'è zona
Con una chiave reale, una scansione consuma un credito quando il tipo di documento è stato determinato e vale una di tre condizioni: una zona è stata letta e le sue cifre di controllo sono risultate corrette, sono stati letti cinque o più campi della zona visiva, oppure è stato decodificato un codice a barre. Una patente quindi viene addebitata per la seconda o la terza. Una foto troppo scadente per dare cinque campi e senza codice a barre è gratuita. La regola di addebito riporta la definizione completa.
Cosa l'OCR non ti dice
Leggere una patente e verificarla sono lavori diversi. doc.cheap legge ciò che è stampato sulla tessera e, sul retro, il codice a barre. Nello scenario di solo riconoscimento authenticity.overall è not_checked, quindi non ti dice se la tessera è autentica, se è stata sospesa o se la persona che la tiene in mano ne è il titolare. Se il tuo flusso ha bisogno di una di queste cose, sono passaggi separati, con strumenti e archivi pensati apposta.
Provalo
La chiave pubblica di sandbox non richiede un account. Registrandoti ottieni 100 riconoscimenti gratuiti ogni mese sulla tua chiave, abbastanza per costruire l'intero flusso – fronte, retro e i tuoi controlli. Se stai scegliendo un fornitore, il confronto tra API OCR per passaporti mette fianco a fianco i prezzi pubblicati, e la guida alla patente di guida riporta la chiamata in curl, JavaScript e Python, con consigli per fotografare una tessera lucida.
Una domanda per te: quando una patente non ha zona, quale controllo intercetta più letture sbagliate nel tuo flusso – le date, il codice a barre sul retro o qualcos'altro? Raccontacelo nei commenti qui sotto.