Extraer datos de pasaporte en C# con IronOCR
El método ReadPassport de IronOCR extrae datos estructurados de imágenes de pasaportes, incluyendo nombres, números de pasaporte, fechas de nacimiento y fechas de vencimiento en una sola línea de código C#, lo que lo hace ideal para aplicaciones de inmigración y seguridad.
En aplicaciones y sistemas como mostradores de facturación y control de inmigración en aeropuertos, donde los agentes manejan grandes volúmenes de pasaportes diariamente, tener un sistema confiable que extraiga con precisión información crítica del viajero es crucial para asegurar un proceso de inmigración eficiente y confiable. La biblioteca IronOCR proporciona capacidades avanzadas de OCR específicamente optimizadas para la lectura de pasaportes, aprovechando Tesseract 5 con mejoras de aprendizaje automático.
Guía de inicio rápido: Extraer la información MRZ del pasaporte en una sola líneaEste ejemplo muestra cómo cargar una imagen de pasaporte usando OcrInput, utilizar ReadPassport() para extraer datos y acceder a campos estructurados como nombres, número y fechas del PassportInfo devuelto. No se requiere una configuración compleja, solo una línea directa. A diferencia de las implementaciones tradicionales de Tesseract, IronOCR proporciona una API simplificada específicamente diseñada para la extracción de documentos.
-
1Instalar IronOCR con NuGet Package Manager
-
2Copie y ejecute este fragmento de código.
var input = new IronOcr.OcrInput(); input.LoadImage("passport.jpg"); var passportInfo = new IronOcr.IronTesseract().ReadPassport(input).PassportInfo;Dim input As New IronOcr.OcrInput() input.LoadImage("passport.jpg") Dim passportInfo = (New IronOcr.IronTesseract()).ReadPassport(input).PassportInfoDim input As New IronOcr.OcrInput() input.LoadImage("passport.jpg") Dim passportInfo = (New IronOcr.IronTesseract()).ReadPassport(input).PassportInfo -
3Despliegue para probar en su entorno real
Empiece a usar IronOCR en su proyecto hoy con una prueba gratuita
Flujo de trabajo mínimo (5 pasos)
- Descarga una biblioteca de C# para leer pasaportes
- Importe la imagen del pasaporte para su lectura
- Asegúrese de que el documento contiene solo la imagen del pasaporte, sin encabezados ni pies de página
- Utilice el método
ReadPassportpara extraer datos de la imagen - Acceda a la propiedad OcrPassportResult para ver y manipular aún más los datos del pasaporte extraídos
¿Cómo extraer datos de pasaporte en C#?
Como ejemplo, utilizaremos una imagen de pasaporte como entrada para mostrar la funcionalidad de IronOCR. Después de cargar la imagen utilizando OcrInput, puedes utilizar el método ReadPassport para identificar y extraer la información del pasaporte. Este método devuelve un objeto OcrPassportResult, que contiene propiedades como GivenNames, Country, PassportNumber, Surname, DateOfBirth, DateOfExpiry, Gender, DocumentType, Nationality, NationalityCode, IssuingCountryCode, PersonalNumber, y DateOfIssue.
El método ReadPassport es parte de las capacidades especializadas de lectura de documentos de IronOCR, que también incluye métodos para leer matrículas, cheques MICR, y otros documentos estructurados. El método utiliza técnicas avanzadas de visión por computadora para localizar y extraer automáticamente el área MRZ (Zona de Lectura Mecánica).
ReadPassport no rota automáticamente la entrada actualmente. Al usar la entrada, asegúrese de que el MRZ esté siempre en la parte inferior del archivo; de lo contrario, el proceso fallará.¿Qué formato de imagen de pasaporte debo usar?
IronOCR soporta varios formatos de imagen incluyendo JPG, PNG, TIFF y BMP. Para obtener resultados óptimos, asegúrese de que su imagen de pasaporte tenga una resolución adecuada (al menos 300 DPI) e iluminación adecuada. Las configuraciones DPI se pueden ajustar si se trabaja con escaneos de menor calidad.

¿Qué código necesito para extraer los datos del pasaporte?
El siguiente ejemplo muestra el proceso completo de extracción de datos de pasaportes. Para aplicaciones que procesan múltiples pasaportes, considere implementar soporte de multihilo para mejorar el rendimiento. También puedes rastrear el progreso del OCR para operaciones de larga duración.
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);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
' 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 UsingImports IronOcr
' 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¿Qué resultados puedo esperar de ReadPassport?
Los datos extraídos se devuelven en un formato estructurado que facilita la integración con los sistemas existentes. La clase OcrResult proporciona acceso integral a toda la información extraída.

Luego accedemos al miembro de datos PassportInfo obtenido del objeto OcrPassportResult. El proceso de extracción maneja automáticamente varios diseños y formatos de pasaporte, proporcionando resultados coherentes en los distintos países emisores.
GivenNames: Una propiedad dePassportInfodevuelve los nombres dados de la entrada del pasaporte como una cadena. Esto corresponde a la primera fila de datos MRZ, posiciones 4 a 44.Country: Una propiedad dePassportInfodevuelve el país de la entrada del pasaporte como una cadena. Esto corresponde a la primera fila de datos MRZ, posiciones 2 a 3. La cadena devuelta indica el nombre completo del país emisor en lugar de la abreviatura. En nuestro ejemplo, USA significa "Estados Unidos de América".PassportNumber: Una propiedad dePassportInfodevuelve el número de pasaporte de la entrada del pasaporte como una cadena. Esto corresponde a la segunda fila de datos MRZ, posiciones 1 a 9.Surname: Una propiedad dePassportInfodevuelve el apellido de la entrada del pasaporte como una cadena. Esto corresponde a la primera fila de datos MRZ, posiciones 4 a 44.DateOfBirth: Una propiedad dePassportInfodevuelve la fecha de nacimiento de la entrada del pasaporte como una cadena en el formato YYYY-MM-DD. Esto corresponde a la segunda fila de datos MRZ, posiciones 14 a 19.DateOfExpiry: Un miembro propiedad dePassportInfodevuelve la fecha de vencimiento de la entrada del pasaporte como una cadena en el formato YYYY-MM-DD. Esto corresponde a la segunda fila de datos MRZ, posiciones 22 a 27.Gender: Devuelve el género de la posición 21 del MRZ comoGender.Male,Gender.Female, oGender.Unspecified.DocumentType: Devuelve el tipo de documento de las posiciones 1-2 del MRZ, como "P" para pasaporte, "PS" para servicio, o "PD" para diplomático.Nationality: Devuelve el nombre completo del país en inglés derivado de las posiciones 11-13 del MRZ.NationalityCode: Devuelve el código ISO 3166-1 alfa-3 en bruto de las posiciones 11-13 del MRZ.IssuingCountryCode: Devuelve el código ISO 3166-1 alfa-3 en bruto para el estado emisor de las posiciones 3-5 del MRZ.PersonalNumber: Devuelve el número de identificación nacional opcional de las posiciones 29-42 del MRZ.DateOfIssue: Devuelve la fecha de emisión extraída de la Zona de Inspección Visual (VIZ) mediante coincidencia de etiquetas de mejor esfuerzo en 27 idiomas.
¿Qué información MRZ puedo extraer de los pasaportes?
IronOCR lee la información del MRZ contenida en las dos filas inferiores de cualquier pasaporte que siga el estándar de la (Organización de Aviación Civil Internacional) ICAO. Los datos de MRZ constan de dos filas de datos, y cada conjunto de posiciones contiene información única. He aquí una breve tabla que muestra qué información corresponde al índice de la fila.
La funcionalidad de análisis del MRZ en IronOCR está diseñada para manejar variaciones en la calidad de impresión y orientación de la imagen. Para documentos desafiantes, puedes aplicar filtros de corrección de imagen para mejorar la precisión del reconocimiento.
¿Cómo es la sección MRZ?
El MRZ se encuentra normalmente en la parte inferior de la página del pasaporte y consta de dos líneas de texto normalizado. La comprensión de la estructura MRZ ayuda a resolver problemas de extracción y a validar los resultados.

Primera fila
| Posición | Campo | Descripción |
|---|---|---|
| 1 | Tipo de documento | Normalmente 'P' de pasaporte |
| 2-3 | País emisor | Código de país de tres letras (ISO 3166-1 alfa-3) |
| 4-44 | Apellido y nombres de pila | Surname followed by '<<' and then given names separated by '<' |
Segunda fila
| Posición | Campo | Descripción |
|---|---|---|
| 1-9 | Número de pasaporte | Número de pasaporte único |
| 10 | Dígito de control (Número de pasaporte) | Dígito de control del número de pasaporte |
| 11-13 | Nacionalidad | Código de nacionalidad de tres letras (ISO 3166-1 alfa-3) |
| 14-19 | Fecha de nacimiento | Fecha de nacimiento en formato AAMMDD |
| 20 | Dígito de control (Fecha de nacimiento) | Dígito de control para la fecha de nacimiento |
| 21 | Sexo | Género ('M' para masculino, 'F' para femenino, 'X' para no especificado) |
| 22-27 | Fecha de vencimiento | Fecha de vencimiento en formato AAMMDD |
| 28 | Dígito de control (fecha de vencimiento) | Dígito de control para la fecha de caducidad |
| 29-42 | Número personal | Número personal opcional (normalmente el número de identificación nacional) |
| 43 | Dígito de control (Número personal) | Dígito de control del número personal |
| 44 | Dígito de control (compuesto) | Dígito de control general |
¿Cómo puedo depurar y verificar los resultados de la extracción de pasaportes?
También podemos verificar los resultados de IronOCR obteniendo el texto en bruto extraído de la imagen del pasaporte y el nivel de confianza para confirmar si la información extraída es precisa. Usando el ejemplo anterior, podemos acceder a las propiedades Confidence y Text del objeto OcrPassportResult.
Para fines de depuración, podrías querer resaltar regiones de texto para verificar visualmente qué áreas fueron reconocidas. Esta función es especialmente útil para solucionar problemas de extracción u optimizar regiones de escaneado.
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);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)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: La propiedadConfidencedeOcrPassportResultes un flotante que indica la confianza de precisión estadística del OCR como un promedio de cada carácter. Esta flotación es menor si la imagen del pasaporte es borrosa o contiene otra información. El uno es la puntuación más alta y de mayor confianza, y el cero es la más baja y de menor confianza. Para aplicaciones de producción, considere implementar umbrales de confianza en los resultados para asegurar la calidad de los datos.Text: La propiedadTextdeOcrPassportResultcontiene el texto bruto, sin procesar, extraído de la imagen del pasaporte. Los desarrolladores pueden utilizarlo en pruebas unitarias para verificar el texto extraído de la imagen del pasaporte. Para escenarios avanzados, puedes exportar resultados en formato hOCR para un análisis más detallado.
Prácticas recomendadas para aplicaciones de escaneado de pasaportes
Al aplicar el escaneado de pasaportes en entornos de producción, tenga en cuenta estos factores adicionales:
- Calidad de Imagen: Asegúrese de que las imágenes de entrada cumplan con los estándares mínimos de calidad. El Asistente de Filtros puede ayudar a optimizar imágenes para un mejor reconocimiento.
- Rendimiento: Para procesamiento de alto volumen, implemente soporte asincrónico y considere el procesamiento por lotes de múltiples pasaportes.
- Seguridad: Dado que los datos de pasaportes son sensibles, asegure el manejo adecuado de los datos y considere integrarse con sistemas seguros de gestión de documentos.
- Validación: Implemente validación del dígito de control para los datos extraídos del MRZ para asegurar la precisión. El formato MRZ incluye varios dígitos de control que pueden utilizarse para verificar la integridad de la información extraída.
- Manejo de Errores: Implemente un manejo de errores confiable para casos donde las imágenes de los pasaportes puedan estar dañadas, mal iluminadas o contengan formatos no estándar.
Preguntas frecuentes
¿Para qué se utiliza el método ReadPassport de IronOCR?
El método ReadPassport de IronOCR se utiliza para extraer datos estructurados de imágenes de pasaportes, como nombres, números de pasaporte, fechas de nacimiento y fechas de caducidad, lo que lo hace ideal para aplicaciones de inmigración y seguridad.
¿Cómo puede IronOCR ayudar con la extracción de datos de pasaportes en C#?
IronOCR simplifica la extracción de datos de pasaportes utilizando el método ReadPassport, que proporciona una API sencilla para extraer datos MRZ, nombres, números de pasaporte y fechas en una sola línea de código C#.
¿Qué tipo de información se puede extraer de un pasaporte utilizando IronOCR?
Usando IronOCR, puede extraer información como nombres de pila, número de pasaporte, país, fecha de nacimiento, código de nacionalidad y otros campos de datos MRZ de un pasaporte.
¿Está IronOCR específicamente destinado a algún idioma de pasaporte?
Actualmente, el método ReadPassport de IronOCR está optimizado para pasaportes en inglés, pero incluye técnicas avanzadas de visión por computadora para manejar variaciones en la calidad de impresión y orientación de la imagen.
¿Cuáles son algunas de las mejores prácticas al usar IronOCR para escaneo de pasaportes?
Las mejores prácticas incluyen asegurar imágenes de alta calidad (300 DPI), validar los datos MRZ extraídos con dígitos de control, implementar un manejo confiable de errores y usar una gestión de datos segura para datos sensibles de pasaportes.
¿Cuáles son los requisitos para usar el método ReadPassport en un Mac?
Al usar ReadPassport en un Mac, asegúrese de que el MRZ esté en la parte inferior de la imagen de entrada, ya que la rotación automática no es compatible, y el proyecto necesita ejecutarse en arquitectura x64 en un avanzado .NET Framework.
¿Qué formatos de imagen son compatibles con IronOCR para OCR de pasaportes?
IronOCR admite varios formatos de imagen, incluidos JPG, PNG, TIFF y BMP, para OCR de pasaportes y recomienda imágenes con una resolución de al menos 300 DPI.
¿Puede IronOCR manejar formatos de pasaporte no estándar?
El análisis MRZ de IronOCR está diseñado para manejar variaciones en la calidad de impresión de pasaportes y la orientación de la imagen, lo que lo hace adaptable a diferentes diseños y formatos de pasaportes.
¿Cómo asegura IronOCR la precisión de los datos de pasaporte extraídos?
IronOCR proporciona la propiedad Confidence en el OcrPassportResult, que indica la precisión estadística del proceso OCR, y los desarrolladores pueden implementar umbrales para asegurar la calidad.
¿Qué características adicionales ofrece IronOCR para la validación de extracción de MRZ?
IronOCR incluye características como la validación de dígitos de control para los campos de datos MRZ, asegurando la precisión e integridad de la información extraída.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.