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 kullanılarak görüntüyü yükledikten sonra, pasaporttan bilgi tanımlamak ve çıkarmak için ReadPassport metodunu kullanabilirsiniz. Bu metod, GivenNames, Country, PassportNumber, Surname, DateOfBirth, DateOfExpiry, Gender, DocumentType, Milliyet, MilliyetCode, IssuingCountryCode, PersonalNumber ve DateOfIssue gibi özellikleri içeren bir OcrPassportResult nesnesi döndürür.

ReadPassport metodu, plaka okuma, MICR çekleri ve diğer yapılandırılmış belgeler için metotları da içeren IronOCR'nin uzmanlaşmış belge okuma yeteneklerinin bir parçasıdı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 lütfen ReadPassport metodunun şu anda girişi otomatik olarak döndürmediğini 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ı tüm çıkarılmış bilgilere kapsamlı erişim sağlar.

Sonrasında OcrPassportResult nesnesinden elde edilen PassportInfo veri üyesine erişiyoruz. Çı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 bir özelliği, pasaport girişinin 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 bir özelliği, pasaport girişinin ülkesini 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 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 bir özelliği, pasaport girişinin 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 bir özelliği, pasaport girişinin doğum tarihini YYYY-AA-GG formatında 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 bir özellik üyeliği, pasaport girişinin son kullanma tarihini YYYY-AA-GG formatında bir dize olarak döndürür. Bu, ikinci MRZ veri satırına karşılık gelir, pozisyonlar 22 ila 27.
• Gender: MRZ pozisyonu 21'den cinsiyeti Gender.Male, Gender.Female veya Gender.Unspecified olarak döndürür.
• DocumentType: MRZ pozisyonları 1-2'den belge türünü döndürür, pasaport için "P", hizmet için "PS" veya diplomatik için "PD" gibi.
• Milliyet: MRZ pozisyonları 11-13'ten türetilen tam İngilizce ülke adını döndürür.
• MilliyetCode: MRZ pozisyonları 11-13'ten ham ISO 3166-1 alfa-3 kodunu döndürür.
• IssuingCountryCode: MRZ pozisyonları 3-5'ten veren devlet için ham ISO 3166-1 alfa-3 kodunu döndürür.
• PersonalNumber: MRZ pozisyonları 29-42'den isteğe bağlı ulusal kimlik numarasını döndürür.
• DateOfIssue: 27 dil arasında en iyi çaba etiket eşlemesiyle Görsel İnceleme Bölgesi'nden (VIZ) çıkarılan düzenleme 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, Confidence ve Text özelliklerine OcrPassportResult nesnesi aracılığıyla 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: OcrPassportResult'dan Confidence özelliği, her bir karakterin ortalamasına göre OCR istatistiksel doğruluk güvenini gösteren bir float değerdir. 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: OcrPassportResult'dan Text özelliği, pasaport görüntüsünden çıkarılan ham, işlenmemiş 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.