Oracle Cloud Infrastructure-Dokumentation

Schlüsselwertextraktion (Pass)

Die Schlüsselwertextraktion kann verwendet werden, um Werte für vordefinierte Schlüssel in einem MRZ-unterstützten Reisepass zu identifizieren. Beispiel: Wenn ein Reisepass Staatsangehörigkeit und Ausstellungsdatum enthält, kann Document Understanding diese Werte identifizieren und als Schlüssel/Wert-Paar zurückgeben.

Die unterstützten Features sind:

  • Extrahieren Sie Werte für vordefinierte Schlüsselwertpaare
  • Sicherheitsscore
Folgende Felder werden unterstützt:
Unterstützte Felder
Field Beschreibung API-Antwortwert
FirstName Der im Dokument aufgeführte Vorname. Extrahierter Text
LastName Nachname (Familienname), der im Dokument aufgeführt ist. Extrahierter Text
Land Das im Dokument aufgeführte Land. Extrahierter ISO 3166-1-Ländercode
Nationalität Nationalität des Dokumenteigentümers. Extrahierter ISO 3166-1-Ländercode
BirthDate Geburtsdatum.
  • Datum im Format JJJJ/MM/TT
  • Else: <
ExpiryDate Das im Dokument aufgeführte Ablaufdatum.
  • Datum im Format JJJJ/MM/TT
  • Else: <
Gender Das im Dokument aufgeführte Geschlecht. Extrahierter Text
DocumentType Dokumenttyp, der oft als Einzelzeichen aufgeführt wird, z. B. "P" für Reisepass oder "V" für Visa. Extrahierter Text
DocumentNumber Dokument-ID-Nummer. Extrahierter Text

Schlüsselwertextraktion (Pass) - Beispiel

Ein Beispiel für die Verwendung der Schlüsselwertextraktion aus einem Reisepass in Document Understanding.

Eingabedokument
API-Anforderung für Schlüsselwertextraktion (Reisepass) - Eingabe Ein fiktiver Pass.:
{ 
       "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": "" 
       }
       }
Ausgabe:
API-Antwort:
{
  "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": "*.*.*("
}