Documentation sur Oracle Cloud Infrastructure

Extraction de valeur de clé (passeport)

L'extraction de la valeur 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 comprend la nationalité et la date d'émission, le service de compréhension de documents peut identifier ces valeurs et les retourner en tant que paire de valeurs clés.

Les fonctionnalités prises en charge sont les suivantes :

  • Extraire les valeurs des paires clé-valeur prédéfinies
  • Note de fiabilité
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 figurant sur le document. Code de pays ISO 3166-1 extrait
Nationalité Nationalité du responsable du document. Code de pays ISO 3166-1 extrait
BirthDate Date de naissance.
  • Date au format YYYY/MM/DD
  • Else : <
ExpiryDate Date d'expiration indiquée sur le document.
  • Date au format YYYY/MM/DD
  • Else : <
Sexe Sexe indiqué dans le document. Texte extrait
DocumentType Type de document, souvent répertorié comme un caractère unique, 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 valeurs de clé (passeport)

Exemple d'utilisation de l'extraction de valeur clé à partir d'un passeport dans le service de compréhension de documents.

Document d'entrée
Demande d'API Passeport fictif. d'entrée d'extraction de valeurs 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": "*.*.*("
}