Extraire les données d'un passeport en C# ; avec IronOCR

Comment extraire les données d'un passeport en C#?

À titre d'exemple, nous utiliserons une image de passeport comme donnée d'entrée pour illustrer les fonctionnalités d'IronOCR. Après avoir chargé l'image à l'aide OcrInput , vous pouvez utiliser la méthode ReadPassport pour identifier et extraire les informations du passeport. Cette méthode renvoie un objet OcrPassportResult , qui contient des propriétés telles que GivenNames , Country , PassportNumber , Surname , DateOfBirth et DateOfExpiry . Tous les membres de l'objet PassportInfo sont des chaînes de caractères.

La méthode ReadPassport fait partie des capacités de lecture de documents spécialisés d'IronOCR, qui comprend également des méthodes pour lire les plaques d'immatriculation, chèques MICR, et d'autres documents structurés. La méthode utilise des techniques avancées de vision artificielle pour localiser et extraire automatiquement la zone MRZ (Machine Readable Zone).

[{i:(

• La méthode ne fonctionne actuellement que pour les passeports en anglais.
• L'utilisation de l'analyse avancée sur .NET Framework nécessite que le projet s'exécute sur une architecture x64.
• Pour les utilisateurs de Mac, veuillez noter que la méthode ReadPassport ne fait actuellement pas pivoter automatiquement l'entrée. Lors de l'utilisation de cette entrée, veuillez vous assurer que le fichier MRZ se trouve toujours en bas du fichier ; sinon, le processus échouera.
  @@--BRACKET-FERMETURE--@@

Quel format d'image de passeport dois-je utiliser ? IronOcr prend en charge divers formats d'image [](https://ironsoftware.com/csharp/ocr/how-to/input-images/), notamment JPG, PNG, TIFF et BMP. Pour des résultats optimaux, veillez à ce que votre image de passeport ait une résolution adéquate (au moins 300 DPI) et un éclairage approprié. Les paramètres [DPI](https://ironsoftware.com/csharp/ocr/how-to/dpi-setting/) peuvent être ajustés si vous travaillez avec des scans de moindre qualité.

### De quel code ai-je besoin pour extraire les données d'un passeport? L'exemple suivant illustre le processus complet d'extraction des données d'un passeport. Pour les applications traitant plusieurs passeports, envisagez de mettre en œuvre [la prise en charge du multithreading](https://ironsoftware.com/csharp/ocr/how-to/async/) pour améliorer les performances. Vous pouvez également suivre la progression de l'OCR pour les opérations de longue durée. ```csharp :path=/static-assets/ocr/content-code-examples/how-to/read-passport-read-passport.cs ``` ### Quel résultat puis-je attendre de ReadPassport? Les données extraites sont renvoyées dans un format structuré qui facilite leur intégration dans les systèmes existants. La classe [OcrResult](https://ironsoftware.com/csharp/ocr/examples/results-objects/) fournit un accès complet à toutes les informations extraites.

Nous accédons ensuite au membre de données `PassportInfo` obtenu à partir de l'objet `OcrPassportResult` . Le processus d'extraction gère automatiquement les différents formats et mises en page des passeports, ce qui permet d'obtenir des résultats cohérents dans les différents pays d'émission. - `GivenNames` : Une propriété de `PassportInfo` renvoie les prénoms du passeport saisi sous forme de chaîne de caractères. Cela correspond à la première ligne de données MRZ, positions 4 à 44. - `Country` : Une propriété de `PassportInfo` renvoie le pays du passeport saisi sous forme de chaîne de caractères. Cela correspond à la première ligne de données MRZ, positions 2 à 3. La chaîne renvoyée indique le nom complet du pays émetteur au lieu de l'abréviation. Dans notre exemple, USA signifie "États-Unis d'Amérique". - `PassportNumber` : Une propriété de `PassportInfo` renvoie le numéro de passeport du passeport saisi sous forme de chaîne de caractères. Cela correspond à la deuxième ligne de données MRZ, positions 1 à 9. - `Surname` : Une propriété de `PassportInfo` renvoie le nom de famille de l'entrée du passeport sous forme de chaîne de caractères. Cela correspond à la première ligne de données MRZ, positions 4 à 44. - `DateOfBirth` : Une propriété de `PassportInfo` renvoie la date de naissance du passeport saisi sous forme de chaîne de caractères au format AAAA-MM-JJ. Cela correspond à la deuxième ligne de données MRZ, positions 14 à 19. - `DateOfExpiry` : Une propriété membre de `PassportInfo` renvoie la date d'expiration du passeport saisi sous forme de chaîne de caractères au format AAAA-MM-JJ. Cela correspond à la deuxième ligne de données MRZ, positions 22 à 27.

---

Quelles sont les informations MRZ que je peux extraire des passeports ? IronOCR lit les informations MRZ contenues dans les deux rangées inférieures de tout passeport qui suit la norme de l'(Organisation de l'aviation civile internationale) [ICAO](https://www.icao.int/). Les données MRZ se composent de deux lignes de données, chaque ensemble de positions contenant des informations uniques. Voici un bref tableau indiquant les informations correspondant à l'index de la ligne. La fonctionnalité d'analyse MRZ d'IronOcr est conçue pour gérer les variations de la qualité d'impression et [l'orientation de l'image](https://ironsoftware.com/csharp/ocr/how-to/image-orientation-correction/). Pour les documents difficiles, vous pouvez appliquer des [filtres de correction d'image](https://ironsoftware.com/csharp/ocr/how-to/image-quality-correction/) pour améliorer la précision de la reconnaissance. ### À quoi ressemble la section MRZ? La MRZ se trouve généralement au bas de la page du passeport et consiste en deux lignes de texte normalisé. La compréhension de la structure MRZ permet de résoudre les problèmes d'extraction et de valider les résultats.

Première rangée

Poste à pourvoir	Champ	Description du projet
1	Type de document	Généralement, " P " pour passeport
2-3	Pays émetteur	Code pays à trois lettres (ISO 3166-1 alpha-3)
4-44	Nom et prénom	Nom de famille suivi de '<<' puis prénoms séparés par '<'

Deuxième rangée

Poste à pourvoir	Champ	Description du projet
1-9	Numéro de passeport	numéro de passeport unique
10	Chiffre de contrôle (numéro de passeport)	Chiffre de contrôle du numéro de passeport
11-13	Nationalité	Code de nationalité à trois lettres (ISO 3166-1 alpha-3)
14-19	Date de naissance	Date de naissance au format AAMMJJ
20	Chiffre de contrôle (Date de naissance)	Chiffre de contrôle de la date de naissance
21	Sexe	Genre (" M " pour masculin, " F " pour féminin, " X " pour non spécifié)
22-27	Date d'expiration	Date d'expiration au format AAMMJJ
28	Chiffre de contrôle (date d'expiration)	Chiffre de contrôle de la date d'expiration
29-42	Numéro personnel	Numéro personnel facultatif (généralement numéro d'identification national)
43	Chiffre de contrôle (numéro personnel)	Chiffre de contrôle du numéro personnel
44	Chiffre de contrôle (composite)	chiffre de contrôle global

---

## Comment déboguer et vérifier les résultats de l'extraction de passeports? Nous pouvons également vérifier les résultats d'IronOcr en obtenant le texte brut extrait de l'image du passeport et le niveau de confiance pour confirmer si les informations extraites sont exactes. En utilisant l'exemple ci-dessus, nous pouvons accéder aux propriétés `Confidence` et `Text` de l'objet `OcrPassportResult`. À des fins de débogage, vous pourriez vouloir [mettre en évidence des zones de texte](https://ironsoftware.com/csharp/ocr/how-to/highlight-texts-as-images/) pour vérifier visuellement quelles zones ont été reconnues. Cette fonctionnalité est particulièrement utile pour résoudre les problèmes d'extraction ou optimiser les zones de balayage. ```csharp :path=/static-assets/ocr/content-code-examples/how-to/read-passport-debug.cs ``` [VS Code debug console showing passport data output with personal details, countries, and encoded strings](/static-assets/ocr/how-to/read-passport/debug.webp) (Console de débogage du code VS affichant les données du passeport avec les détails personnels, les pays et les chaînes encodées) - `Confidence` : La propriété `Confidence` de `OcrPassportResult` est un nombre flottant indiquant la confiance dans la précision statistique de l'OCR sous forme de moyenne pour chaque caractère. Cette marge est plus faible si l'image du passeport est floue ou contient d'autres informations. Le chiffre un correspond à la valeur la plus élevée et la plus sûre, et le chiffre zéro à la valeur la plus basse et la moins sûre. Pour les applications de production, envisagez de mettre en place des [seuils de confiance des résultats](https://ironsoftware.com/csharp/ocr/how-to/tesseract-result-confidence/) pour garantir la qualité des données. - `Text` : La propriété `Text` de `OcrPassportResult` contient le texte brut, non analysé, extrait de l'image du passeport. Les développeurs peuvent l'utiliser dans des tests unitaires pour vérifier le texte extrait de l'image du passeport. Pour les scénarios avancés, vous pouvez exporter les résultats au format [hOCR](https://ironsoftware.com/csharp/ocr/how-to/html-hocr-export/) pour une analyse plus approfondie. ## Bonnes pratiques pour les applications de numérisation de passeports Lors de la mise en œuvre de la numérisation des passeports dans des environnements de production, il convient de tenir compte de ces facteurs supplémentaires : 1. **Qualité des images** : veillez à ce que les images d'entrée répondent à des normes de qualité minimales. L'[Assistant de filtrage](https://ironsoftware.com/csharp/ocr/how-to/filter-wizard/) peut aider à optimiser les images pour une meilleure reconnaissance. 2. **Performance** : Pour le traitement de gros volumes, mettez en œuvre la prise en charge [async](https://ironsoftware.com/csharp/ocr/how-to/async/) et envisagez le traitement par lots de plusieurs passeports. 3. **Sécurité** : les données des passeports étant sensibles, il convient de veiller au traitement adéquat des données et d'envisager l'intégration avec des systèmes de gestion de documents sécurisés. 4. **Validation** : mettre en œuvre la validation des chiffres de contrôle pour les données MRZ extraites afin d'en garantir l'exactitude. Le format MRZ comprend plusieurs chiffres de contrôle qui peuvent être utilisés pour vérifier l'intégrité des informations extraites. 5. **Gestion des erreurs** : mettre en œuvre une gestion robuste des erreurs pour les cas où les images de passeport peuvent être endommagées, mal éclairées ou contenir des formats non standard.