使用 IronOCR 在 C# 中提取護照資料。

IronOCR 的 ReadPassport 方法只需一行 C# 程式碼即可從護照影像中擷取結構化資料，包括姓名、護照號碼、出生日期和有效日期，非常適合移民和安全應用程式。

在機場的登機櫃檯和安全入境等應用程式和系統中，代理人員每天都要處理大量護照，因此擁有一個能夠準確擷取旅客關鍵資訊的可靠系統，對於確保有效率且簡化的入境程序至關重要。 IronOCR 函式庫提供先進的 OCR 功能，專門針對護照閱讀進行最佳化，在引擎蓋下利用 Tesseract 5 與機器學習增強功能。

快速入門：一行提取護照 MRZ 資訊

本範例展示如何使用 OcrInput 載入護照影像，使用 ReadPassport() 擷取資料，並從回傳的 PassportInfo 中存取結構化欄位，例如姓名、號碼和日期。 不需要複雜的設定 - 只需要簡單直接的一行。與傳統的 Tesseract 實作不同，IronOCR 提供了專門用於文件擷取的簡化 API。

如何在 C# 中提取護照資料？ 例如，我們將使用護照影像作為輸入來展示 IronOCR 的功能。 使用`OcrInput`載入影像後，您可以利用`ReadPassport`方法識別和提取護照資訊。 此方法傳回一個`OcrPassportResult`對象，其中包含`GivenNames` 、 `Country` 、 `PassportNumber` 、 `Surname` 、 `DateOfBirth`和`DateOfExpiry`等屬性。 `PassportInfo`物件的所有成員均為字串。 `ReadPassport` 方法是 IronOCR 專門的文件讀取功能的一部分，該功能還包括用於[讀取車牌](https://ironsoftware.com/csharp/ocr/how-to/read-license-plate/)、[MICR 支票](https://ironsoftware.com/csharp/ocr/how-to/read-micr-cheque/)和其他結構化文件的方法。 此方法使用先進的 [ 電腦視覺技術](https://ironsoftware.com/csharp/ocr/how-to/computer-vision/)來自動定位並擷取 MRZ (Machine Readable Zone) 區域。 [{i:(@ - 此方法目前僅適用於英文版護照。 - 在 .NET Framework 上使用進階掃描功能需要專案在 x64 架構上運作。 - Mac 使用者請注意， `ReadPassport`方法目前不會自動旋轉輸入內容。 使用輸入時，請確保 MRZ 始終位於文件底部；否則，處理將失敗。 @@--括號關閉--@@

我應該使用何種護照影像格式？ IronOCR 支援各種 [影像格式](https://ironsoftware.com/csharp/ocr/how-to/input-images/)，包括 JPG、PNG、TIFF 和 BMP。為了達到最佳效果，請確保您的護照影像有足夠的解析度 (至少 300 DPI) 和適當的光線。 [DPI設定](https://ironsoftware.com/csharp/ocr/how-to/dpi-setting/)可在使用較低品質掃描時進行調整。

擷取護照資料需要哪些程式碼？ 以下範例展示了擷取護照資料的完整過程。 對於處理多本護照的應用程式，請考慮實施 [ 多執行緒支援](https://ironsoftware.com/csharp/ocr/how-to/async/) 以提高效能。 您也可以追蹤[OCR 的進度](https://ironsoftware.com/csharp/ocr/how-to/progress-tracking/)，以進行長時間的作業。 ```csharp :path=/static-assets/ocr/content-code-examples/how-to/read-passport-read-passport.cs ```

我可以期待 ReadPassport 帶來哪些輸出？ 擷取的資料會以結構化的格式傳回，方便與現有系統整合。 [OcrResult 類別](https://ironsoftware.com/csharp/ocr/examples/results-objects/)提供對所有萃取資訊的全面存取。

然後我們訪問從`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](https://www.icao.int/)標準的護照底部兩行所包含的 MRZ 資訊。 MRZ 資料由兩行資料組成，每組位置都包含獨特的資訊。 以下是一個簡表，顯示哪些資訊與該行的索引相對應。 IronOCR 中的 MRZ 解析功能旨在處理印刷品質和 [影像方向](https://ironsoftware.com/csharp/ocr/how-to/image-orientation-correction/)的變化。 對於具挑戰性的文件，您可以套用 [影像修正篩選器](https://ironsoftware.com/csharp/ocr/how-to/image-quality-correction/)來提高辨識準確度。

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`屬性。 為了除錯的目的，您可能想要[高亮顯示文字區域](https://ironsoftware.com/csharp/ocr/how-to/highlight-texts-as-images/)來直觀地驗證哪些區域被辨識出來。 此功能在排除抽取問題或最佳化掃描區域時尤其有用。 ```csharp :path=/static-assets/ocr/content-code-examples/how-to/read-passport-debug.cs ``` 。 - `Confidence` ： `OcrPassportResult`的`Confidence`屬性是一個浮點數，表示 OCR 統計準確度置信度，即每個字元的平均值。 如果護照影像模糊或包含其他資訊，則此浮動值較低。 1 代表最高和最有信心，0 代表最低和最沒信心。 對於生產應用程式，請考慮實施 [結果置信度](https://ironsoftware.com/csharp/ocr/how-to/tesseract-result-confidence/)臨界值，以確保資料品質。 - `Text` ： `OcrPassportResult`的`Text`屬性包含從護照影像中提取的原始、未解析的文字。 開發人員可在單元測試中使用，以驗證擷取的護照影像文字。 針對進階方案，您可以 [hOCR 格式](https://ironsoftware.com/csharp/ocr/how-to/html-hocr-export/)匯出結果，以便進一步分析。 ## 護照掃描應用程式的最佳實務 在生產環境中實施護照掃描時，請考慮這些額外因素： 1.**影像品質**：確保輸入的影像符合最低品質標準。 [Filter Wizard](https://ironsoftware.com/csharp/ocr/how-to/filter-wizard/) 可協助最佳化影像，以獲得更好的辨識度。 2.**效能**：若要進行大量處理，請執行 [async 支援](https://ironsoftware.com/csharp/ocr/how-to/async/)，並考慮批次處理多本護照。 3.**安全性**： 由於護照資料相當敏感，因此必須確保資料處理得宜，並考慮與安全的文件管理系統整合。 4.**驗證**：針對擷取的 MRZ 資料執行校驗位元驗證，以確保準確性。 MRZ 格式包含多個校驗碼，可用於驗證擷取資訊的完整性。 5.**錯誤處理**：針對護照影像可能受損、光線不足或包含非標準格式的情況，實施健全的錯誤處理。