Passdaten in C# mit IronOCR extrahieren

Beispiel für das Extrahieren von Passdaten

Als Beispiel verwenden wir ein Passbild als Eingabe, um die Funktionalität von IronOCR zu demonstrieren. Nach dem Laden des Bildes mit OcrInput können Sie die ReadPassport-Methode nutzen, um Informationen aus dem Pass zu erkennen und zu extrahieren. Diese Methode gibt ein OcrPassportResult-Objekt zurück, das Eigenschaften wie GivenNames, Country, PassportNumber, Surname, DateOfBirth und DateOfExpiry enthält. Alle Mitglieder des PassportInfo-Objekts sind Zeichenfolgen.

[{i:(

• Die Methode funktioniert derzeit nur für englischbasierte Pässe.
• Die Verwendung eines erweiterten Scans auf .NET Framework erfordert, dass das Projekt auf x64-Architektur läuft.
• Für Mac-Benutzer: Bitte beachten Sie, dass die ReadPassport-Methode derzeit die Eingabe nicht automatisch dreht. Bei der Verwendung der Eingabe stellen Sie bitte sicher, dass die MRZ immer am unteren Ende der Datei ist; andernfalls schlägt der Vorgang fehl. @@--KLAMMER-SCHLIESSEN--@@

Pass Eingabe

:path=/static-assets/ocr/content-code-examples/how-to/read-passport-read-passport.cs

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);

Imports IronOcr
Imports System

' Instantiate OCR engine
Private ocr = New IronTesseract()

Private inputPassport = New OcrInput()

inputPassport.LoadImage("passport.jpg")

' Perform OCR
Dim result As OcrPassportResult = 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)

Ausgabe

Wir greifen dann auf das PassportInfo-Datenmitglied zu, das aus dem OcrPassportResult-Objekt abgerufen wurde.

• GivenNames: Eine Eigenschaft von PassportInfo gibt die Vornamen der Pass-Eingabe als Zeichenfolge zurück. Dies entspricht der ersten MRZ-Datenreihe, mit Stelleen von 4 bis 44.
• Country: Eine Eigenschaft von PassportInfo gibt das Land der Pass-Eingabe als Zeichenfolge zurück. Dies entspricht der ersten MRZ-Datenreihe, mit Stelleen von 2 bis 3. Die zurückgegebene Zeichenkette gibt den vollständigen Namen des ausstellenden Landes anstelle der Abkürzung an. In unserem Beispiel gibt die USA 'Vereinigte Staaten von Amerika' zurück.
• PassportNumber: Eine Eigenschaft von PassportInfo gibt die Passnummer der Pass-Eingabe als Zeichenfolge zurück. Dies entspricht der zweiten MRZ-Datenreihe, mit Stelleen von 1 bis 9.
• Surname: Eine Eigenschaft von PassportInfo gibt den Nachnamen der Pass-Eingabe als Zeichenfolge zurück. Dies entspricht der ersten MRZ-Datenreihe, mit Stelleen von 4 bis 44.
• DateOfBirth: Eine Eigenschaft von PassportInfo gibt das Geburtsdatum der Pass-Eingabe als Zeichenfolge im Format JJJJ-MM-TT zurück. Dies entspricht der zweiten MRZ-Datenreihe, mit Stelleen 14 bis 19.
• DateOfExpiry: Ein Mitglied der Eigenschaften von PassportInfo gibt das Ablaufdatum des Reisepasses als Zeichenfolge im Format YYYY-MM-DD zurück. Dies entspricht der zweiten MRZ-Datenreihe, mit Stelleen 22 bis 27.

---

Das MRZ-Informationen verstehen

IronOCR liest die MRZ-Informationen, die in den unteren zwei Reihen eines jeden Passes enthalten sind, der dem Standard der (International Civil Aviation Organization) ICAO folgt. Die MRZ-Daten bestehen aus zwei Datenreihen, wobei jede Stelle eindeutige Informationen enthält. Hier ist eine kurze Tabelle, die zeigt, welche Informationen dem Index der Zeile entsprechen.

Beispiel-Eingabe

Erste Reihe

Stelle	Feld	Beschreibung
1	Dokumenttyp	Typischerweise 'P' für Reisepass
2-3	Ausstellendes Land	Dreistelliger Ländercode (ISO 3166-1 alpha-3)
4-44	Nachname und Vornamen	Nachname gefolgt von '<<' und dann Vornamen getrennt durch '<'

Zweite Reihe

Stelle	Feld	Beschreibung
1-9	Passnummer	Eindeutige Passnummer
10	Prüfziffer (Passnummer)	Prüfziffer für die Passnummer
11-13	Nationalität	Dreistelliger Nationalitätscode (ISO 3166-1 alpha-3)
14-19	Geburtsdatum	Geburtsdatum im Format JJMMTT
20	Prüfziffer (Geburtsdatum)	Prüfziffer für das Geburtsdatum
21	Sex	Geschlecht ('M' für männlich, 'F' für weiblich, 'X' für nicht angegeben)
22-27	Ablaufdatum	Ablaufdatum im Format JJMMTT
28	Prüfziffer (Ablaufdatum)	Prüfziffer für das Ablaufdatum
29-42	Persönliche Nummer	Optionale persönliche Nummer (in der Regel die nationale Identifikationsnummer)
43	Prüfziffer (Persönliche Nummer)	Prüfziffer für die persönliche Nummer
44	Prüfziffer (zusammengesetzt)	Gesamtprüfziffer

---

Debugging

Wir können die Ergebnisse von IronOCR auch überprüfen, indem wir den rohen extrahierten Text aus dem Passbild und das Vertrauensniveau abrufen, um zu bestätigen, ob die extrahierten Informationen korrekt sind. Mit dem obigen Beispiel können wir auf die Eigenschaften Confidence und Text des OcrPassportResult-Objekts zugreifen.

:path=/static-assets/ocr/content-code-examples/how-to/read-passport-debug.cs

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);

Imports IronOcr
Imports System

' Instantiate OCR engine
Private ocr = New IronTesseract()

Private inputPassport = New OcrInput()

inputPassport.LoadImage("passport.jpg")

' Perform OCR
Dim result As OcrPassportResult = ocr.ReadPassport(inputPassport)

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

• Confidence: Die Confidence-Eigenschaft von OcrPassportResult ist ein Gleitkommawert, der die OCR statistische Genauigkeitszuversicht als Durchschnitt jedes Zeichens anzeigt. Dieser Gleitkommawert wäre niedriger, wenn das Passbild unscharf ist oder andere Informationen enthält. Eins ist das höchste und zuversichtlichste und 0 das niedrigste und am wenigsten vertrauensvolle.
• Text: Die Text-Eigenschaft von OcrPassportResult enthält den rohen, ungeparsten Text, der aus dem Passbild extrahiert wurde. Entwickler könnten dies in Komponententests verwenden, um den extrahierten Text des Passbildes zu überprüfen.