Documentación de Oracle Cloud Infrastructure

Extracción de clave-valor (pasaporte)

La extracción de valores clave se puede utilizar para identificar valores para claves predefinidas en un pasaporte admitido por MRZ. Por ejemplo, si un pasaporte incluye nacionalidad y fecha de expedición, Document Understanding puede identificar estos valores y devolverlos como un par clave-valor.

Las funciones soportadas son:

  • Extraer valores para pares clave-valor predefinidos
  • Puntuación de confianza
Los campos soportados son:
Campos soportados
Campo Descripción Valor de respuesta de API
FirstName Nombre que aparece en el documento. Texto extraído
LastName Apellidos (nombre de familia) enumerados en el documento. Texto extraído
País País que figura en el documento. Código de país ISO 3166-1 extraído
Nacionalidad Nacionalidad del propietario del documento. Código de país ISO 3166-1 extraído
BirthDate Fecha de Nacimiento.
  • Fecha en formato YYYY/MM/DD
  • Else: <
ExpiryDate Fecha de caducidad que se muestra en el documento.
  • Fecha en formato YYYY/MM/DD
  • Else: <
Género Género indicado en el documento. Texto extraído
DocumentType Tipo de documento, a menudo incluido como un carácter único, como "P" para pasaporte o "V" para visa. Texto extraído
DocumentNumber Número de identificación del documento. Texto extraído

Ejemplo de extracción de clave-valor (pasaporte)

Ejemplo del uso de la extracción de valores clave de un pasaporte en Document Understanding.

Documento de Entrada
Solicitud de API Pasaporte ficticio. de entrada de extracción de clave-valor (pasaporte):
{ 
       "processorConfig": {  
       "processorType": "GENERAL",  
       "features": [   
       {    
       "featureType": "KEY_VALUE_EXTRACTION"   
       },  
       "documentType": "PASSPORT" 
       }, 
       "inputLocation": {  
       "sourceType": "OBJECT_STORAGE_LOCATIONS",  
       "objectLocations": [   
       {    
       "source": "OBJECT_STORAGE",    
       "namespaceName": "",    
       "bucketName": "",    
       "objectName": ""   
       }  
       ] 
       }, 
       "compartmentId": "", 
       "outputLocation": {  
       "namespaceName": "",  
       "bucketName": "",  
       "prefix": "" 
       }
       }
Salida:
Respuesta de API:
{
  "documentMetadata": {
    "pageCount": 1,
    "mimeType": "image/png"
  },
  "pages": [
    {
      "pageNumber": 1,
      "detectedDocumentTypes": [
        {
          "documentType": "PASSPORT",
          "confidence": 0.99412346
        },
        {
          "documentType": "INVOICE",
          "confidence": 0.0010955964
        },
        {
          "documentType": "RECEIPT",
          "confidence": 0.0009931799
        },
        {
          "documentType": "CHECK",
          "confidence": 0.0008127898
        },
        {
          "documentType": "DRIVER_LICENSE",
          "confidence": 0.00070861256
        }
      ],
      "documentFields": [
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "FirstName",
            "confidence": 0.9979309
          },
          "fieldValue": {
            "valueType": "STRING",
            "value": "HAPPY"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "LastName",
            "confidence": 0.9979309
          },
          "fieldValue": {
            "valueType": "STRING",
            "value": "TRAVELER"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "Country",
            "confidence": 0.9979309
          },
          "fieldValue": {
            "valueType": "STRING",
            "value": "USA"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "Nationality",
            "confidence": 0.9998241
          },
          "fieldValue": {
            "valueType": "STRING",
            "value": "USA"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "BirthDate",
            "confidence": 0.9998241
          },
          "fieldValue": {
            "valueType": "STRING",
            "value": "1965/02/05"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "ExpiryDate",
            "confidence": 0.9998241
          },
          "fieldValue": {
            "valueType": "STRING",
            "value": "2030/10/14"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "Gender",
            "confidence": 0.9998241
          },
          "fieldValue": {
            "valueType": "STRING",
            "value": "F"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "DocumentType",
            "confidence": 0.9979309
          },
          "fieldValue": {
            "valueType": "STRING",
            "value": "P"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "DocumentNumber",
            "confidence": 0.9998241
          },
          "fieldValue": {
            "valueType": "STRING",
            "value": "E00007734"
          }
        }
      ]
    }
  ],
  "detectedDocumentTypes": [
    {
      "documentType": "PASSPORT",
      "confidence": 0.99412346
    }
  ],
  "documentClassificationModelVersion": "*.*.*",
  "keyValueExtractionModelVersion": "*.*.*("
}