Documentazione di Oracle Cloud Infrastructure

Estrazione valore chiave (passaporto)

L'estrazione dei valori chiave può essere utilizzata per identificare i valori per le chiavi predefinite in un passaporto supportato da MRZ. Ad esempio, se un passaporto include la nazionalità e la data di rilascio, Document Understanding è in grado di identificare questi valori e restituirli come coppia di valori chiave.

Le funzioni supportate sono:

  • Estrai valori per coppie di valori chiave predefinite
  • Punteggio affidabilità
Di seguito sono riportati i campi supportati.
Campi supportati
Campo descrizione; Valore risposta API
FirstName Nome (nome) elencato nel documento. Testo estratto
LastName Cognome (nome di famiglia) elencato nel documento. Testo estratto
Paese Paese elencato nel documento. Codice paese ISO 3166-1 estratto
Nazionalità Nazionalità del proprietario del documento. Codice paese ISO 3166-1 estratto
BirthDate Data di nascita.
  • Data nel formato AAAA/MM/GG
  • Else: <
ExpiryDate Data di scadenza indicata nel documento.
  • Data nel formato AAAA/MM/GG
  • Else: <
Sesso Sesso elencato nel documento. Testo estratto
DocumentType Tipo di documento, spesso elencato come carattere singolo, ad esempio "P" per il passaporto o "V" per il visto. Testo estratto
DocumentNumber Numero identificativo del documento. Testo estratto

Esempio di estrazione valore chiave (passaporto)

Esempio di utilizzo dell'estrazione di valori chiave da un passaporto in Document Understanding.

Documento di input
Richiesta API input estrazione valore chiave (passaporto): Passaporto fittizio.
{ 
       "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": "" 
       }
       }
output:
Risposta 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": "*.*.*("
}