IronOCR を使って C# でパスポートデータを抽出する

パスポートデータの抽出例

例として、パスポート画像を入力として使用し、IronOCR の機能を紹介します。 OcrInputを使用して画像を読み込んだ後、 ReadPassportメソッドを使用してパスポートから情報を識別および抽出できます。 このメソッドは、 GivenNames 、 Country 、 PassportNumber 、 Surname 、 DateOfBirth 、 DateOfExpiryなどのプロパティを含むOcrPassportResultオブジェクトを返します。 PassportInfoオブジェクトのすべてのメンバーは文字列です。

ブラケットオープン

• この方法は現時点では英語ベースのパスポートに対してのみ機能します。
• .NET Framework で詳細スキャンを使用するには、プロジェクトを x64 アーキテクチャで実行する必要があります。
• Mac ユーザーの場合、 ReadPassportメソッドでは現在、入力が自動的に回転されないことに注意してください。 入力を使用する場合は、MRZ が常にファイルの下部にあることを確認してください。そうでない場合、プロセスは失敗します。 ブラケットを閉じる

パスポート入力

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

出力

次に、 OcrPassportResultオブジェクトから取得したPassportInfoデータ メンバーにアクセスします。

• GivenNames : PassportInfoのプロパティは、パスポート入力の名を文字列として返します。 これは、位置が 4 から 44 の最初の MRZ データ行に対応します。
• Country : PassportInfoのプロパティは、パスポート入力の国を文字列として返します。 これは、位置 2 から 3 までの最初の MRZ データ行に対応します。返される文字列には、発行国の略語ではなく、完全な名前が表示されます。 この例では、USA は"United States of America"を返します。
• PassportNumber : PassportInfoのプロパティは、入力されたパスポートのパスポート番号を文字列として返します。 これは、位置が 1 ～ 9 の 2 番目の MRZ データ行に対応します。
• Surname : PassportInfoのプロパティは、パスポート入力の姓を文字列として返します。 これは、位置が 4 から 44 の最初の MRZ データ行に対応します。
• DateOfBirth : PassportInfoのプロパティは、パスポート入力の生年月日を YYYY-MM-DD 形式の文字列として返します。 これは、位置 14 ～ 19 の 2 番目の MRZ データ行に対応します。
• DateOfExpiry : PassportInfoのプロパティ メンバーは、パスポート入力の有効期限を YYYY-MM-DD 形式の文字列として返します。 これは、位置 22 ～ 27 の 2 番目の MRZ データ行に対応します。

---

MRZ情報の理解

IronOCR は、 ICAO (国際民間航空機関) の標準に準拠したパスポートの下部 2 行に含まれる MRZ 情報を読み取ります。 MRZ データは 2 つのデータ行で構成され、各位置セットには一意の情報が含まれています。 以下に、行のインデックスに対応する情報を示す簡単な表を示します。

入力例

1行目

ポジション	フィールド	翻訳内容
1	文書の種類	通常、パスポートの"P"
2-3	発行国	3文字の国コード（ISO 3166-1 alpha-3）
4-44	姓と名	姓の後に"<<"が続き、その後に名が"<"で区切られます

2行目

ポジション	フィールド	翻訳内容
1-9	パスポート番号	固有のパスポート番号
10	チェックディジット（パスポート番号）	パスポート番号のチェックデジット
11-13	国籍	3文字の国籍コード（ISO 3166-1 alpha-3）
14-19	生年月日	生年月日（YYMMDD形式）
20	チェックディジット（生年月日）	生年月日のチェックデジット
21	セックス	性別（男性は"M"、女性は"F"、未指定は"X"）
22-27	有効期限	YYMMDD形式の有効期限
28	チェックディジット（有効期限）	有効期限のチェックデジット
29-42	個人番号	オプションの個人番号（通常は国民ID番号）
43	チェックディジット（個人番号）	個人番号のチェックデジット
44	チェックディジット（複合）	全体のチェックディジット

---

デバッグ

また、パスポート画像から抽出された生のテキストと信頼度レベルを取得して、抽出された情報が正確かどうかを確認することで、IronOCR の結果を検証することもできます。 上記の例を使用すると、 OcrPassportResultオブジェクトのConfidenceプロパティとTextプロパティにアクセスできます。

: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 : OcrPassportResultのConfidenceプロパティは、各文字の平均として OCR の統計的精度の信頼性を示す浮動小数点数です。 パスポートの画像がぼやけている場合や他の情報が含まれている場合、このフロートは低くなります。 1 は最高で最も自信がある状態、0 は最低で最も自信がない状態です。
• Text : OcrPassportResultのTextプロパティには、パスポート画像から抽出された未解析の生のテキストが含まれます。 開発者はこれをユニットテストで使用して、パスポート画像から抽出されたテキストを検証できます。