Documentazione di Oracle Cloud Infrastructure

Estrazione valore chiave (passaporto)

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

Le funzioni supportate sono:

  • Estrai valori per coppie chiave-valore 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 del valore chiave (passaporto)

Un esempio dell'uso dell'estrazione del valore chiave da un passaporto in Document Understanding.

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