Documentation Oracle Cloud Infrastructure

Extraction de valeur de clé (passeport)

L'extraction des valeurs de clé peut être utilisée pour identifier les valeurs des clés prédéfinies dans un passeport pris en charge par MRZ. Par exemple, si un passeport inclut la nationalité et la date d'émission, Document Understanding peut identifier ces valeurs et les renvoyer en tant que paire de valeurs clés.

Les fonctionnalités prises en charge sont les suivantes :

  • Extraire les valeurs pour les paires clé-valeur prédéfinies
  • Score de confiance
Les champs pris en charge sont les suivants :
Champs pris en charge
Champ Description : Valeur de réponse d'API
FirstName Prénom (prénom) figurant sur le document. Texte extrait
LastName Nom (nom de la famille) figurant sur le document. Texte extrait
Pays Pays indiqué sur le document. Code pays ISO 3166-1 extrait
Nationalité Nationalité du propriétaire du document. Code pays ISO 3166-1 extrait
BirthDate Date de naissance.
  • Date au format AAAA/MM/JJ
  • Else : <
ExpiryDate Date d'expiration indiquée sur le document.
  • Date au format AAAA/MM/JJ
  • Else : <
Sexe Sexe indiqué dans le document. Texte extrait
DocumentType Type de document, souvent répertorié comme un seul caractère, tel que "P"pour le passeport ou"V" pour Visa. Texte extrait
DocumentNumber Numéro d'identification du document. Texte extrait

Exemple d'extraction de valeur de clé (passeport)

Exemple d'utilisation de l'extraction de la valeur clé à partir d'un passeport dans Document Understanding.

Document d'entrée
Demande d'API Passeport fictif. d'entrée d'extraction de valeur de clé (passeport) :
{ 
       "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": "" 
       }
       }
Sortie :
Réponse d'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": "*.*.*("
}