使用 IronOCR 在 C# 中提取護照數據

如何在C#中擷取護照資料？

例如，我們將使用護照影像作為輸入來展示 IronOCR 的功能。 使用OcrInput載入影像後，您可以利用ReadPassport方法識別和提取護照資訊。 此方法傳回一個OcrPassportResult對象，其中包含GivenNames 、 Country 、 PassportNumber 、 Surname 、 DateOfBirth和DateOfExpiry等屬性。 PassportInfo物件的所有成員均為字串。

ReadPassport方法是 IronOCR 專門的文件讀取功能的一部分，該功能還包括讀取車牌、 MICR 支票和其他結構化文件的方法。 此方法利用先進的電腦視覺技術自動定位和提取 MRZ（機器可讀區域）區域。

[{i:(

• 目前此方法僅適用於英文護照。
• 在 .NET Framework 上使用進階掃描功能需要專案在 x64 架構上運作。
• Mac 使用者請注意， ReadPassport方法目前不會自動旋轉輸入內容。 使用輸入時，請確保 MRZ 始終位於文件底部；否則，處理將失敗。
  @@--括號關閉--@@

我應該使用哪種護照照片格式？

IronOCR 支援多種影像格式，包括 JPG、PNG、TIFF 和 BMP。為獲得最佳識別效果，請確保您的護照照片具有足夠的解析度（至少 300 DPI）和良好的光線。 如果處理的是低品質掃描件，可以調整DPI 設定。

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

ReadPassport 可以輸出什麼內容？

提取的資料以結構化格式返回，以便於與現有系統整合。 OcrResult 類別提供了對所有提取資訊的全面存取。

然後我們訪問從OcrPassportResult物件取得的PassportInfo資料成員。 提取過程可自動處理各種護照佈局和格式，在不同的簽發國家/地區提供一致的結果。

• GivenNames ： PassportInfo的屬性，以字串形式傳回護照輸入的姓名。 這對應於 MRZ 資料的第一行，位置 4 到 44。
• Country ： PassportInfo的一個屬性，以字串形式傳回護照輸入的國家。 這對應於 MRZ 資料的第一行，位置 2 到 3。傳回的字串拼出簽發國家的全名，而不是縮寫。 在我們的例子中，USA 返回"美利堅合眾國"。
• PassportNumber ： PassportInfo的屬性，以字串形式傳回護照輸入的護照號碼。 這對應於第二個 MRZ 資料行，位置 1 到 9。
• Surname ： PassportInfo的屬性，以字串形式傳回護照輸入的姓氏。 這對應於 MRZ 資料的第一行，位置 4 到 44。
• DateOfBirth ： PassportInfo的屬性，以 YYYY-MM-DD 格式的字串傳回護照輸入的出生日期。 這對應於 MRZ 資料的第二行，位置 14 到 19。
• DateOfExpiry ： PassportInfo的一個屬性成員，以 YYYY-MM-DD 格式傳回護照輸入的到期日期字串。 這對應於 MRZ 資料的第二行，位置 22 到 27。

---

我可以從護照中提取哪些MRZ資訊？

IronOCR 讀取符合國際民用航空組織 ( ICAO ) 標準的任何護照底部兩行中包含的 MRZ 資訊。 MRZ 資料由兩行資料組成，每行資料包含一組位置資訊。 下面這張簡表顯示了哪些資訊與行的索引相對應。

IronOCR 中的 MRZ 解析功能旨在處理列印品質和影像方向的變化。 對於識別難度較高的文檔，您可以應用影像校正濾鏡來提高識別準確度。

MRZ 區域是什麼樣的？

MRZ 通常位於護照頁的底部，由兩行標準化的文字組成。 了解 MRZ 結構有助於解決提取問題和驗證結果。

第一排

位置	場地	描述
1	文件類型	通常"P"代表護照。
2-3	簽發國	三字母國家代碼（ISO 3166-1 alpha-3）
4-44	姓氏和名字	姓氏後面跟著"<<"，名字後面跟著"<"分隔。

第二排

位置	場地	描述
1-9	護照號碼	唯一護照號碼
10	校驗位（護照號碼）	護照號碼校驗位
11-13	國籍	三字母國籍代碼（ISO 3166-1 alpha-3）
14-19	出生日期	出生日期（YYMMDD格式）
20	校驗位（出生日期）	出生日期校驗位
21	性別	性別（'M' 代表男性，'F' 代表女性，'X' 代表未指定）
22-27	到期日期	到期日（YYMMDD 格式）
28	校驗位（到期日）	有效期校驗位
29-42	個人號碼	可選的個人號碼（通常為國民身分證號碼）
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);

！ VS Code 偵錯控制台顯示護照資料輸出，包括個人資訊、國家/地區和編碼字串

• Confidence ： OcrPassportResult的Confidence屬性是一個浮點數，表示 OCR 統計準確度置信度，即每個字元的平均值。 如果護照照片模糊或包含其他訊息，則此浮動值會降低。 1代表最高且最有信心，0代表最低且最沒有信心。 對於生產應用，可以考慮實施結果置信度閾值來確保資料品質。
• Text ： OcrPassportResult的Text屬性包含從護照影像中提取的原始、未解析的文字。 開發人員可以在單元測試中使用此功能來驗證從護照圖像中提取的文字。 對於進階場景，您可以將結果匯出為hOCR 格式以進行進一步分析。

護照掃描申請的最佳實踐

在生產環境中部署護照掃描時，請考慮以下其他因素：

1.影像品質：確保輸入影像符合最低品質標準。 濾鏡精靈可以幫助優化影像，從而提高辨識效果。

2.性能：對於大批量處理，實現非同步支援並考慮批量處理多個護照。

3.安全性：由於護照資料敏感，請確保妥善處理數據，並考慮與安全文件管理系統整合。

4.驗證：對擷取的 MRZ 資料實施校驗位驗證，以確保準確性。 MRZ 格式包含多個校驗位，可用於驗證擷取資訊的完整性。

5.錯誤處理：針對護照影像可能損壞、光線不足或包含非標準格式的情況，實施強大的錯誤處理。