IronOCR ile C# İçerisinde Pasaport Verilerini Çıkarın

C# ile Pasaport Verilerini Nasıl Çıkarım?

Örnek olarak, IronOCR'un işlevselliğini göstermek için giriş olarak bir pasaport görüntüsünü kullanacağız. OcrInput kullanarak görüntüyü yükledikten sonra, ReadPassport yöntemini kullanarak pasaporttaki bilgileri tanımlayabilir ve çıkarabilirsiniz. Bu yöntem, OcrPassportResult nesnesini döndürür; bu nesne GivenNames, Country, PassportNumber, Surname, DateOfBirth, DateOfExpiry, Gender, DocumentType, Milliyet, MilliyetCode, IssuingCountryCode, PersonalNumber ve DateOfIssue.

ReadPassport yöntemi, IronOCR'nin özel belge okuma yeteneklerinin bir parçasıdır. Bu yetenekler arasında plaka, MICR çekleri ve diğer yapılandırılmış belgeleri okumaya yönelik yöntemler de bulunmaktadır. Yöntem, MRZ (Makine Okunabilir Bölge) alanını otomatik olarak bulup çıkarmak için gelişmiş bilgisayarla görüş tekniklerini kullanır.

• Yöntem şu anda yalnızca İngilizce tabanlı pasaportlar için çalışıyor. Gelişmiş tarama işleminin .NET Framework üzerinde kullanımı için projenin x64 mimarisinde çalıştırılması gerekmektedir.
• Mac kullanıcıları için, ReadPassport yönteminin şu anda girişi otomatik olarak döndürmediğini lütfen unutmayın. Girişi kullanırken, MRZ'nin her zaman dosyanın altında olduğundan emin olun; aksi takdirde işlem başarısız olur. )}]

Hangi Pasaport Görüntü Formatını Kullanmalıyım?

IronOCR, JPG, PNG, TIFF ve BMP dahil çeşitli görüntü formatlarını destekler. En iyi sonuçlar için, pasaport görüntünüzün yeterli çözünürlüğe sahip olduğundan (en az 300 DPI) ve uygun aydınlatma olduğundan emin olun. Daha düşük kaliteli taramalarla çalışıyorsanız, DPI ayarları ayarlanabilir.

: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);
Console.WriteLine(result.PassportInfo.Gender);
Console.WriteLine(result.PassportInfo.DocumentType);
Console.WriteLine(result.PassportInfo.Nationality);
Console.WriteLine(result.PassportInfo.NationalityCode);
Console.WriteLine(result.PassportInfo.IssuingCountryCode);
Console.WriteLine(result.PassportInfo.PersonalNumber);
Console.WriteLine(result.PassportInfo.DateOfIssue);

Imports IronOcr
Imports System

' Instantiate OCR engine
Dim ocr As New IronTesseract()

Using inputPassport As 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)
    Console.WriteLine(result.PassportInfo.Gender)
    Console.WriteLine(result.PassportInfo.DocumentType)
    Console.WriteLine(result.PassportInfo.Nationality)
    Console.WriteLine(result.PassportInfo.NationalityCode)
    Console.WriteLine(result.PassportInfo.IssuingCountryCode)
    Console.WriteLine(result.PassportInfo.PersonalNumber)
    Console.WriteLine(result.PassportInfo.DateOfIssue)
End Using

ReadPassport'tan Ne Tür Çıktılar Bekleyebilirim?

Çıkarılan veriler, mevcut sistemlere entegre edilmesini kolaylaştıran yapılandırılmış bir formatta döndürülür. OcrResult sınıfı, çıkarılan tüm bilgilere kapsamlı erişim sağlar.

Ardından, PassportInfo nesnesinden elde edilen OcrPassportResult veri üyesine erişiriz. Çıkarma süreci, farklı pasaport düzenlerini ve formatlarını otomatik olarak ele alır, farklı veren ülkeler arasında tutarlı sonuçlar sağlar.

• GivenNames: PassportInfo'nin bir özelliği, pasaport girdisinin verilen adlarını bir dize olarak döndürür. Bu, ilk MRZ veri satırına karşılık gelir, pozisyonlar 4'ten 44'e kadar.
• Country: PassportInfo'nin bir özelliği, pasaport girişindeki ülkeyi bir dize olarak döndürür. Bu, ilk MRZ veri satırına karşılık gelir, pozisyonlar 2 ila 3. Döndürülen dizi, kısaltma yerine veren ülkenin tam adını ifade eder. Örneğimizde, ABD 'Amerika Birleşik Devletleri' olarak döner.
• PassportNumber: PassportInfo'nin bir özelliği, pasaport girişinin pasaport numarasını bir dize olarak döndürür. Bu, ikinci MRZ veri satırına karşılık gelir, pozisyonlar 1'den 9'a kadar.
• Surname: PassportInfo'nin bir özelliği, passport girdisinin soyadını bir dize olarak döndürür. Bu, ilk MRZ veri satırına karşılık gelir, pozisyonlar 4'ten 44'e kadar.
• DateOfBirth: PassportInfo'nin bir özelliği, pasaport girdisindeki doğum tarihini YYYY-MM-DD biçiminde bir dize olarak döndürür. Bu, ikinci MRZ veri satırına karşılık gelir, pozisyonlar 14'ten 19'a kadar.
• DateOfExpiry: PassportInfo'nin bir özellik üyesi, pasaport girdisinin son kullanma tarihini YYYY-MM-DD biçiminde bir dize olarak döndürür. Bu, ikinci MRZ veri satırına karşılık gelir, pozisyonlar 22 ila 27.
• Gender: MRZ konum 21'den cinsiyeti Gender.Male, Gender.Female veya Gender.Unspecified olarak döndürür.
• DocumentType: MRZ'nin 1-2 numaralı konumlarından belge türünü döndürür; örneğin, pasaport için "P", hizmet için "PS" veya diplomatik için "PD".
• Milliyet: MRZ'nin 11-13. konumlarından türetilen tam İngilizce ülke adını döndürür.
• MilliyetCode: MRZ konumları 11-13'ten ham ISO 3166-1 alfa-3 kodunu döndürür.
• IssuingCountryCode: MRZ'nin 3-5. konumlarından düzenleyen ülkeye ait ham ISO 3166-1 alfa-3 kodunu döndürür.
• PersonalNumber: MRZ'nin 29-42 konumlarından isteğe bağlı ulusal kimlik numarasını döndürür.
• DateOfIssue: 27 dilde en iyi etiket eşleştirme yöntemi kullanılarak Visual Inspection Zone (VIZ) 'dan çıkarılan yayın tarihini döndürür.

---

Pasaportlardan Hangi MRZ Bilgisini Çıkarabilirim?

IronOCR, (Uluslararası Sivil Havacılık Örgütü) ICAO standardına uyan herhangi bir pasaportun alt iki satırında yer alan MRZ bilgilerini okur. MRZ verisi iki veri satırından oluşur ve her pozisyon kümesi benzersiz bilgi içerir. Satır indeksine karşılık gelen bilgilerin hangi bilgilerini içeren kısa bir tablo.

IronOCR'deki MRZ ayrıştırma işlevi, yazdırma kalitesi ve görüntü yönelimi üzerine yapılan farklılıkları ele almak için tasarlanmıştır. Zor belgeler için, doğruluğu artırmak amacıyla görüntü düzeltme filtrelerini uygulayabilirsiniz.

MRZ Bölümü Nasıl Görünür?

MRZ genellikle pasaport sayfasının alt kısmında yer alır ve iki satırlık standartlaştırılmış metinlerden oluşur. MRZ yapısını anlamak, çıkarma sorunlarını gidermede ve sonuçları doğrulamada yardımcı olur.

İlk Satır

Pozisyon	Alan	Açıklama
1	Belge Türü	Genellikle pasaport için 'P'
2-3	Veren Ülke	Üç harfli ülke kodu (ISO 3166-1 alpha-3)
4-44	Soyadı ve Verilen İsimler	Soy isim '<<' izler ve ardından '<' ile ayrılmış verilen isimler

İkinci Satır

Pozisyon	Alan	Açıklama
1-9	Pasaport Numarası	Eşsiz pasaport numarası
10	Kontrol Basamağı (Pasaport Numarası)	Pasaport numarası için kontrol basamağı
11-13	Milliyet	Üç harfli milliyet kodu (ISO 3166-1 alpha-3)
14-19	Doğum Tarihi	Doğum tarihi YYAA-GG formatında
20	Kontrol Basamağı (Doğum Tarihi)	Doğum tarihi için kontrol basamağı
21	Cinsiyet	Cinsiyet ('M' erkek, 'F' kadın, 'X' belirsiz için)
22-27	Son Kullanma Tarihi	Son kullanma tarihi YYAA-GG formatında
28	Kontrol Basamağı (Son Kullanma Tarihi)	Son kullanım tarihi için kontrol basamağı
29-42	Kişisel Numara	İsteğe bağlı kişisel numara (genellikle ulusal kimlik numarası)
43	Kontrol Basamağı (Kişisel Numara)	Kişisel numara için kontrol basamağı
44	Kontrol Basamağı (Bileşik)	Genel kontrol basamağı

---

Pasaport Çıkarma Sonuçlarını Nasıl Hata Ayıklayabilir ve Doğrulayabilirim?

IronOCR'dan geçirilen pasaport görüntüsünden çıkarılan ham metni ve güven seviyesini alarak sonuçları doğrulayabiliriz. Yukarıdaki örneği kullanarak, OcrPassportResult nesnesinin Confidence ve Text özelliklerine erişebiliriz.

Hata ayıklama amaçları için, hangi bölgelerin tanındığını görsel olarak doğrulamak için metin bölgelerini vurgulamak isteyebilirsiniz. Bu özellik, özellikle çıkarım sorunlarını giderirken veya tarama bölgelerini optimize ederken faydalıdır.

: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: Confidence'deki OcrPassportResult özelliği, her karakterin ortalaması olarak OCR istatistiksel doğruluk güvenini gösteren bir float değeridir. Bu float düşükse, pasaport görüntüsü bulanık veya başka bilgiler içeriyordur. Bir en yüksek ve en güvenilir olanıdır ve sıfır en düşük ve en az güvenilir olanıdır. Üretim uygulamaları için, veri kalitesini sağlamak için sonuç güveni eşik değerleri uygulamayı düşünün.
• Text: Text'daki OcrPassportResult özelliği, pasaport görüntüsünden çıkarılan işlenmemiş, ayrıştırılmamış metni içerir. Geliştiriciler, pasaport görüntüsünün çıkarılan metnini doğrulamak için bunu birim testlerinde kullanabilirler. İleri düzey senaryolar için, daha fazla analiz için sonuçları hOCR formatında dışa aktarabilirsiniz.

Pasaport Tarama Uygulamaları İçin En İyi Uygulamalar

Üretim ortamlarında pasaport tarama uygularken, aşağıdaki ek faktörleri göz önünde bulundurun:

1. Görüntü Kalitesi: Giriş görüntülerinin minimum kalite standartlarını karşıladığından emin olun. Filter Wizard daha iyi tanıma için görüntüleri optimize etmeye yardımcı olabilir.

2. Performans: Yüksek hacimli işlem için, eşzamanlılık desteği uygulayın ve birden fazla pasaportun toplu işlenmesini düşünün.

3. Güvenlik: Pasaport verileri hassas olduğundan, doğru veri işleme sağlamak ve güvenli belge yönetim sistemleri ile entegrasyonu düşünün.

4. Doğrulama: Çıkarılan MRZ verilerinin doğruluğunu sağlamak için kontrol basamağı doğrulaması uygulayın. MRZ formatı, çıkarılan bilgilerin bütünlüğünü doğrulamak için kullanılabilecek birçok kontrol basamağı içerir.

5. Hata Yönetimi: Pasaport görüntüleri hasarlı, kötü aydınlatılmış veya standart dışı formatlar içeriği durumlar için sağlam hata yönetimi uygulayın.