IronOCR을 사용하여 C#에서 여권 데이터 추출하기

C#에서 여권 정보를 추출하는 방법은 무엇인가요?

예시로, IronOCR의 기능을 보여주기 위해 여권 이미지를 입력으로 사용하겠습니다. OcrInput을 사용하여 이미지를 로드한 후, ReadPassport 메서드를 활용하여 여권의 정보를 식별하고 추출할 수 있습니다. 이 메서드는 OcrPassportResult 객체를 반환하며, 해당 객체는 GivenNames, Country, PassportNumber, Surname, DateOfBirth, DateOfExpiry 등의 속성을 포함하고 있습니다. PassportInfo 객체의 모든 멤버는 문자열입니다.

ReadPassport 메서드는 IronOCR의 특수 문서 읽기 기능의 일부로, 번호판 읽기, MICR 수표 읽기 및 기타 구조화된 문서를 위한 메서드를 포함합니다. 이 방법은 고급 컴퓨터 비전 기술을 사용하여 MRZ(기계 판독 가능 영역) 영역을 자동으로 찾아 추출합니다.

• 현재 이 방법은 영문 여권에만 적용됩니다.
• .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 알파-3)
4-44	성씨와 이름	성 뒤에 '<<'를 붙이고, 그 뒤에 이름을 '<'로 구분합니다.

두 번째 줄

위치	필드	설명
1-9	여권 번호	고유 여권 번호
10	검증 숫자(여권 번호)	여권 번호의 검사 숫자
11-13	국적	세 글자 국적 코드(ISO 3166-1 알파-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);

• Confidence: Confidence의 OcrPassportResult 속성은 각 문자당 평균을 사용하여 OCR 통계적 정확도 자신감을 나타내는 부동 소수점 수입니다. 여권 사진이 흐릿하거나 다른 정보가 포함되어 있는 경우 이 플로트는 더 낮아집니다. 1은 가장 높고 확신도가 가장 높은 값이고, 0은 가장 낮고 확신도가 가장 낮은 값입니다. 실제 운영 환경에서는 데이터 품질을 보장하기 위해 결과 신뢰도 임계값을 구현하는 것을 고려하십시오.
• Text: Text의 OcrPassportResult 속성은 여권 이미지에서 추출된 원시, 미파싱된 텍스트를 포함하고 있습니다. 개발자는 이를 단위 테스트에서 사용하여 여권 이미지에서 추출된 텍스트를 검증할 수 있습니다. 고급 시나리오의 경우, 추가 분석을 위해 결과를 hOCR 형식 으로 내보낼 수 있습니다.

여권 스캔 애플리케이션 사용 모범 사례

실제 운영 환경에서 여권 스캔 기능을 구현할 때 다음과 같은 추가 요소를 고려하십시오.

1. 이미지 품질 : 입력 이미지가 최소 품질 기준을 충족하는지 확인하십시오. 필터 마법사는 이미지 인식률을 높이기 위해 이미지 최적화에 도움을 줄 수 있습니다.

2. 성능 : 대용량 처리를 위해 비동기 지원을 구현하고 여러 여권의 일괄 처리를 고려하십시오.

3. 보안 : 여권 정보는 민감한 정보이므로 적절한 데이터 처리를 보장하고 안전한 문서 관리 시스템과의 통합을 고려해야 합니다.

4. 유효성 검사 : 추출된 MRZ 데이터의 정확성을 보장하기 위해 검사 숫자 유효성 검사를 수행합니다. MRZ 형식에는 추출된 정보의 무결성을 확인하는 데 사용할 수 있는 여러 개의 검사 숫자가 포함되어 있습니다.

5. 오류 처리 : 여권 사진이 손상되었거나, 조명이 불량하거나, 비표준 형식을 포함하는 경우에 대비하여 강력한 오류 처리 기능을 구현하십시오.