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

Curtis Chau
Curtis Chau
Mis à jour : 2 août 2026

La méthode ReadPassport d'IronOCR extrait des données structurées des images de passeports, y compris les noms, les numéros de passeport, les dates de naissance et les dates d'expiration en une seule ligne de code C#, ce qui la rend idéale pour les applications d'immigration et de sécurité.

Dans les applications et systèmes tels que les comptoirs d'enregistrement et l'immigration de sécurité dans les aéroports, où les agents traitent de grands volumes de passeports quotidiennement, disposer d'un système fiable qui extrait avec précision les informations critiques sur les voyageurs est crucial pour assurer un processus d'immigration efficace et fiable. La bibliothèque IronOCR offre des capacités avancées d'OCR spécifiquement optimisées pour la lecture de passeports, en s'appuyant sur Tesseract 5 avec des améliorations d'apprentissage automatique.

Guide de démarrage rapide : extraire les informations MRZ d'un passeport en une seule ligne

Cet exemple montre comment charger une image de passeport en utilisant OcrInput, utiliser ReadPassport() pour extraire les données, et accéder à des champs structurés comme les noms, le numéro, et les dates à partir de l'PassportInfo retourné. Aucune configuration complexe requise - juste une ligne simple. Contrairement aux implémentations Tesseract traditionnelles, IronOCR fournit une API simplifiée spécifiquement conçue pour l'extraction de documents.

  1. 1Installez IronOCR avec NuGet Package Manager

    PM > Install-Package IronOcr

  2. 2Copiez et exécutez cet extrait de code.

    var input = new IronOcr.OcrInput();
    input.LoadImage("passport.jpg");
    var passportInfo = new IronOcr.IronTesseract().ReadPassport(input).PassportInfo;
  3. 3Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronOCR dans votre projet dès aujourd'hui avec un essai gratuit
    arrow pointer

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 en utilisant OcrInput, vous pouvez utiliser la méthode ReadPassport pour identifier et extraire des informations du passeport. Cette méthode retourne un objet OcrPassportResult, qui contient des propriétés comme GivenNames, Country, PassportNumber, Surname, DateOfBirth, DateOfExpiry, Gender, DocumentType, Nationality, NationalityCode, IssuingCountryCode, PersonalNumber, et DateOfIssue.

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

Veuillez noter: - 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 Mac, veuillez noter que la méthode ReadPassport ne fait pas automatiquement tourner l'entrée pour le moment. 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.

Quel format d'image de passeport devrais-je utiliser ?

IronOCR prend en charge divers formats d'image y compris JPG, PNG, TIFF et BMP. Pour des résultats optimaux, assurez-vous que votre image de passeport a une résolution adéquate (au moins 300 DPI) et un éclairage approprié. Les paramètres DPI peuvent être ajustés si vous travaillez avec des numérisations de moindre qualité.

Exemple de page de données de passeport américain montrant les champs biographiques, les dates et la zone lisible par machine pour la démonstration d'extraction de données

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 pour améliorer les performances. Vous pouvez également suivre les progrès de l'OCR pour les opérations longue durée.

using IronOcr;
using System;

// Instantiate OCR engine
var ocr = new IronTesseract();

using var inputPassport = new OcrInput();

inputPassport.LoadImage("passport.jpg");

// Perform OCR
OcrPassportResult result = ocr.ReadPassport(inputPassport);

// Output passport information
Console.WriteLine(result.PassportInfo.GivenNames);
Console.WriteLine(result.PassportInfo.Country);
Console.WriteLine(result.PassportInfo.PassportNumber);
Console.WriteLine(result.PassportInfo.Surname);
Console.WriteLine(result.PassportInfo.DateOfBirth);
Console.WriteLine(result.PassportInfo.DateOfExpiry);
Console.WriteLine(result.PassportInfo.Gender);
Console.WriteLine(result.PassportInfo.DocumentType);
Console.WriteLine(result.PassportInfo.Nationality);
Console.WriteLine(result.PassportInfo.NationalityCode);
Console.WriteLine(result.PassportInfo.IssuingCountryCode);
Console.WriteLine(result.PassportInfo.PersonalNumber);
Console.WriteLine(result.PassportInfo.DateOfIssue);

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 offre un accès complet à toutes les informations extraites.

Console de débogage montrant les données de passeport extraites : nom, pays, numéro de passeport et dates du traitement OCR

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 retourne les prénoms de l'entrée de passeport sous forme de chaîne. Cela correspond à la première ligne de données MRZ, positions 4 à 44.
  • Country : Une propriété de PassportInfo retourne le pays de l'entrée de passeport sous forme de chaîne. 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 retourne le numéro de passeport de l'entrée de passeport sous forme de chaîne. Cela correspond à la deuxième ligne de données MRZ, positions 1 à 9.
  • Surname : Une propriété de PassportInfo retourne le nom de famille de l'entrée de passeport sous forme de chaîne. Cela correspond à la première ligne de données MRZ, positions 4 à 44.
  • DateOfBirth : Une propriété de PassportInfo retourne la date de naissance de l'entrée de passeport sous forme de chaîne dans le format AAAA-MM-JJ. Cela correspond à la deuxième ligne de données MRZ, positions 14 à 19.
  • DateOfExpiry : Un membre de propriété de PassportInfo retourne la date d'expiration de l'entrée de passeport sous forme de chaîne dans le format AAAA-MM-JJ. Cela correspond à la deuxième ligne de données MRZ, positions 22 à 27.
  • Gender : Retourne le sexe de la position 21 du MRZ sous forme de Gender.Male, Gender.Female, ou Gender.Unspecified.
  • DocumentType : Retourne le type de document à partir des positions 1-2 du MRZ, comme "P" pour passeport, "PS" pour service, ou "PD" pour diplomatique.
  • Nationality : Retourne le nom complet du pays en anglais dérivé des positions 11-13 du MRZ.
  • NationalityCode : Retourne le code brut ISO 3166-1 alpha-3 des positions 11-13 du MRZ.
  • IssuingCountryCode : Retourne le code brut ISO 3166-1 alpha-3 pour l'état émetteur des positions 3-5 du MRZ.
  • PersonalNumber : Retourne le numéro d'identification nationale optionnel des positions 29-42 du MRZ.
  • DateOfIssue : Retourne la date d'émission extraite de la zone d'inspection visuelle (VIZ) via une correspondance d'étiquettes dans 27 langues.

Quelles informations MRZ puis-je 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) OACI. 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 dans IronOCR est conçue pour gérer les variations de qualité d'impression et l'orientation de l'image. Pour les documents difficiles, vous pouvez appliquer des filtres de correction d'image pour améliorer la précision de 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.

Page de passeport américain avec la zone de lecture automatique (MRZ) surlignée en rouge montrant les lignes de données alphanumériques codées

Première rangée

Poste à pourvoirChampDescription du projet
1Type de documentGénéralement, « P » pour passeport
2-3Pays émetteurCode pays à trois lettres (ISO 3166-1 alpha-3)
4-44Nom et prénomSurname followed by '<<' and then given names separated by '<'

Deuxième rangée

Poste à pourvoirChampDescription du projet
1-9Numéro de passeportnuméro de passeport unique
10Chiffre de contrôle (numéro de passeport)Chiffre de contrôle du numéro de passeport
11-13NationalitéCode de nationalité à trois lettres (ISO 3166-1 alpha-3)
14-19Date de naissanceDate de naissance au format AAMMJJ
20Chiffre de contrôle (Date de naissance)Chiffre de contrôle de la date de naissance
21SexeGenre (« M » pour masculin, « F » pour féminin, « X » pour non spécifié)
22-27Date d'expirationDate d'expiration au format AAMMJJ
28Chiffre de contrôle (date d'expiration)Chiffre de contrôle de la date d'expiration
29-42Numéro personnelNuméro personnel facultatif (généralement numéro d'identification national)
43Chiffre de contrôle (numéro personnel)Chiffre de contrôle du numéro personnel
44Chiffre 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 souhaiterez peut-être mettre en évidence les régions de texte 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.

using IronOcr;
using System;

// Instantiate OCR engine
var ocr = new IronTesseract();

using var inputPassport = new OcrInput();

inputPassport.LoadImage("passport.jpg");

// Perform OCR
OcrPassportResult result = ocr.ReadPassport(inputPassport);

// Output Confidence level and raw extracted text
Console.WriteLine(result.Confidence);
Console.WriteLine(result.Text);

Console de débogage VS Code affichant la sortie des données de passeport avec des détails personnels, pays et chaînes encodées

  • Confidence : La propriété Confidence de OcrPassportResult est un flottant indiquant la confiance statistique de précision de l'OCR comme une moyenne de 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 en production, envisagez de mettre en place des seuils de confiance des résultats pour garantir la qualité des données.
  • Text : La propriété Text de OcrPassportResult contient le texte brut, non analysé extrait de l'image de passeport. Les développeurs peuvent l'utiliser dans des tests unitaires pour vérifier le texte extrait de l'image du passeport. Pour des scénarios avancés, vous pouvez exporter les résultats en format hOCR pour une analyse plus poussée.

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é de l'image : Assurez-vous que les images d'entrée respectent les normes de qualité minimales. L'assistant de filtre peut aider à optimiser les images pour une meilleure reconnaissance.
  2. Performance : Pour le traitement en grande quantité, implémentez la prise en charge asynchrone et envisagez le traitement par lots de plusieurs passeports.
  3. Sécurité : Étant donné que les données des passeports sont sensibles, assurez une gestion appropriée des données et envisagez une intégration avec des systèmes de gestion de documents sécurisés.
  4. Validation : Mettez en œuvre une validation de chiffre de contrôle pour les données MRZ extraites afin d'assurer leur 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 : Mettez en œuvre une gestion fiable des erreurs pour les cas où les images de passeport peuvent être endommagées, mal éclairées, ou contenir des formats non standard.

Questions fréquemment posées

À quoi sert la méthode ReadPassport de IronOCR ?

La méthode ReadPassport de IronOCR est utilisée pour extraire des données structurées à partir d'images de passeport, telles que les noms, numéros de passeport, dates de naissance et dates d'expiration, ce qui la rend idéale pour les applications d'immigration et de sécurité.

Comment IronOCR peut-il aider à l'extraction de données de passeport en C# ?

IronOCR simplifie l'extraction de données de passeport en utilisant la méthode ReadPassport, qui fournit une API simple pour extraire les données MRZ, les noms, les numéros de passeport et les dates en une seule ligne de code C#.

Quel type d'information pouvez-vous extraire d'un passeport en utilisant IronOCR ?

Avec IronOCR, vous pouvez extraire des informations telles que les prénoms, le numéro de passeport, le pays, la date de naissance, le code de nationalité et d'autres champs de données MRZ d'un passeport.

IronOCR est-il spécifique à une langue de passeport particulière ?

Actuellement, la méthode ReadPassport de IronOCR est optimisée pour les passeports basés en anglais mais inclut des techniques avancées de vision par ordinateur pour gérer les variations de qualité d'impression et d'orientation des images.

Quelles sont les meilleures pratiques lors de l'utilisation de IronOCR pour le scannage des passeports ?

Les meilleures pratiques incluent l'assurance d'images de haute qualité (300 DPI), la validation des données MRZ extraites avec des chiffres de contrôle, la mise en œuvre d'une gestion fiable des erreurs, et l'utilisation d'une gestion sécurisée des données pour les informations sensibles des passeports.

Quelles sont les exigences pour utiliser la méthode ReadPassport sur un Mac ?

Lors de l'utilisation de ReadPassport sur un Mac, assurez-vous que la MRZ est en bas de l'image d'entrée, car la rotation automatique n'est pas supportée, et le projet doit fonctionner en architecture x64 sur le cadre .NET avancé.

Quels formats d'image sont pris en charge par IronOCR pour l'OCR des passeports ?

IronOCR prend en charge divers formats d'image, y compris JPG, PNG, TIFF et BMP, pour l'OCR des passeports et recommande des images avec une résolution d'au moins 300 DPI.

IronOCR peut-il gérer des formats de passeport non standards ?

Le parsing MRZ de IronOCR est conçu pour gérer les variations de qualité d'impression des passeports et l'orientation des images, ce qui le rend adaptable à différents agencements et formats de passeports.

Comment IronOCR garantit-il la précision des données de passeport extraites ?

IronOCR fournit la propriété Confidence dans l'OcrPassportResult, qui indique la précision statistique du processus d'OCR, et les développeurs peuvent mettre en œuvre des seuils pour l'assurance qualité.

Quelles fonctionnalités supplémentaires IronOCR offre-t-il pour la validation de l'extraction MRZ ?

IronOCR inclut des fonctionnalités telles que la validation du chiffre de contrôle pour les champs de données MRZ, garantissant la précision et l'intégrité des informations extraites.

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 6,394,824Version :2026.11tout juste publié