Documentazione di Oracle Cloud Infrastructure

Estrazione valore chiave (ID driver)

L'estrazione dei valori chiave può essere utilizzata per identificare i valori delle chiavi predefinite nella documentazione di un driver negli Stati Uniti o nel Regno Unito. Ad esempio, se un ID driver include una data di emissione, un'area e una data di scadenza, Document Understanding può identificare questi valori e restituirli come coppia chiave-valore.

Le funzioni supportate sono:

  • Estrai valori per coppie chiave-valore predefinite
  • Polighi di delimitazione
  • Punteggio affidabilità
Di seguito sono riportati i campi supportati.
Campi supportati
Campo descrizione; Valore risposta API
FirstName Nome (nome) elencato nel documento. Testo estratto
MiddleName Secondo nome elencato nel documento (se applicabile). Testo estratto
LastName Cognome (nome di famiglia) elencato nel documento. Testo estratto
Paese Paese elencato nel documento. Codice paese ISO 3166-1 estratto
DateofBirth Data di nascita. Data nel formato AAAA/MM/GG
ExpiryDate Data di scadenza indicata nel documento. Data nel formato AAAA/MM/GG
IssueDate Data di emissione indicata nel documento. Data nel formato AAAA/MM/GG
Sesso Sesso elencato nel documento. Testo estratto
DocumentNumber Numero identificativo del documento. Testo estratto
indirizzo Indirizzo indicato nel documento. Testo estratto
Area Area elencata nel documento. Ad esempio, stato o territorio. Testo estratto

Esempio di estrazione del valore chiave (ID driver)

Un esempio dell'uso dell'estrazione del valore chiave dalla documentazione di guida in Document Understanding.

Documento di input
Richiesta API Licenza di guida fittizia di Minnesotan. di input per l'estrazione del valore chiave (ID driver):
{ 
       "processorConfig": {  
       "processorType": "GENERAL", 
       "features": [   
       {    
       "featureType": "KEY_VALUE_EXTRACTION"  
       }, 
       "documentType": "DRIVER_LICENSE" 
       }, 
       "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/jpeg"
  },
  "pages": [
    {
      "pageNumber": 1,
      "detectedDocumentTypes": [
        {
          "documentType": "DRIVER_LICENSE",
          "confidence": 0.9585071
        },
        {
          "documentType": "BANK_STATEMENT",
          "confidence": 0.010580908
        },
        {
          "documentType": "INVOICE",
          "confidence": 0.006787545
        },
        {
          "documentType": "TAX_FORM",
          "confidence": 0.005904464
        },
        {
          "documentType": "CHECK",
          "confidence": 0.0050073466
        }
      ],
      "documentFields": [
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "Region",
            "confidence": 0.89
          },
          "fieldValue": {
            "valueType": "STRING",
            "boundingPolygon": {
              "normalizedVertices": [
                {
                  "x": 0.024051961713598392,
                  "y": 0.07871827327285588
                },
                {
                  "x": 0.5100519525133396,
                  "y": 0.07886743036052006
                },
                {
                  "x": 0.5100430018604494,
                  "y": 0.15142263403432707
                },
                {
                  "x": 0.024043011060708188,
                  "y": 0.15127347694666288
                }
              ]
            },
            "value": "SOUTH CAROLINA"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "DateOfBirth",
            "confidence": 0.9
          },
          "fieldValue": {
            "valueType": "STRING",
            "boundingPolygon": {
              "normalizedVertices": [
                {
                  "x": 0.4519959147410437,
                  "y": 0.5331082961999155
                },
                {
                  "x": 0.6059959118257354,
                  "y": 0.5331555599684346
                },
                {
                  "x": 0.605990463602237,
                  "y": 0.5773195969872736
                },
                {
                  "x": 0.4519904665175453,
                  "y": 0.5772723332187545
                }
              ]
            },
            "value": "07/04/1970"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "IssueDate",
            "confidence": 0.89
          },
          "fieldValue": {
            "valueType": "STRING",
            "boundingPolygon": {
              "normalizedVertices": [
                {
                  "x": 0.4739889094657875,
                  "y": 0.5898973814767827
                },
                {
                  "x": 0.6259889065883404,
                  "y": 0.5899440314301262
                },
                {
                  "x": 0.6259834583648419,
                  "y": 0.6341080684489652
                },
                {
                  "x": 0.4739834612422891,
                  "y": 0.6340614184956217
                }
              ]
            },
            "value": "10/01/2017"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "ExpiryDate",
            "confidence": 0.91
          },
          "fieldValue": {
            "valueType": "STRING",
            "boundingPolygon": {
              "normalizedVertices": [
                {
                  "x": 0.4979834607879553,
                  "y": 0.6340687842777286
                },
                {
                  "x": 0.6539834578347857,
                  "y": 0.6341166618614232
                },
                {
                  "x": 0.6539772312936447,
                  "y": 0.6845898470258107
                },
                {
                  "x": 0.4979772342468143,
                  "y": 0.6845419694421161
                }
              ]
            },
            "value": "07/04/2025"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "Sex",
            "confidence": 0.88
          },
          "fieldValue": {
            "valueType": "STRING",
            "boundingPolygon": {
              "normalizedVertices": [
                {
                  "x": 0.4299752897399868,
                  "y": 0.7002939700900176
                },
                {
                  "x": 0.4519752893235141,
                  "y": 0.7003007220569489
                },
                {
                  "x": 0.45197023025883704,
                  "y": 0.7413101850030137
                },
                {
                  "x": 0.42997023067530965,
                  "y": 0.7413034330360825
                }
              ]
            },
            "value": "F"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "DocumentId",
            "confidence": 0.92
          },
          "fieldValue": {
            "valueType": "STRING",
            "boundingPolygon": {
              "normalizedVertices": [
                {
                  "x": 0.4440297717099426,
                  "y": 0.2586578966078565
                },
                {
                  "x": 0.6340297681131335,
                  "y": 0.2587162090495359
                },
                {
                  "x": 0.6340227632543499,
                  "y": 0.3154985423594718
                },
                {
                  "x": 0.444022766851159,
                  "y": 0.31544022991779236
                }
              ]
            },
            "value": "123456789"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "LastName",
            "confidence": 0.92
          },
          "fieldValue": {
            "valueType": "STRING",
            "boundingPolygon": {
              "normalizedVertices": [
                {
                  "x": 0.35402160107844666,
                  "y": 0.3248763304532142
                },
                {
                  "x": 0.4800215986931944,
                  "y": 0.32491500080927527
                },
                {
                  "x": 0.48001576131087464,
                  "y": 0.3722336119008885
                },
                {
                  "x": 0.354015763696127,
                  "y": 0.3721949415448274
                }
              ]
            },
            "value": "SAMPLE"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "FirstName",
            "confidence": 0.89
          },
          "fieldValue": {
            "valueType": "STRING",
            "boundingPolygon": {
              "normalizedVertices": [
                {
                  "x": 0.35001576377184923,
                  "y": 0.37219371391447625
                },
                {
                  "x": 0.5340157602886237,
                  "y": 0.372250184910629
                },
                {
                  "x": 0.5340091445886613,
                  "y": 0.4258779441477906
                },
                {
                  "x": 0.3500091480718869,
                  "y": 0.42582147315163793
                }
              ]
            },
            "value": "JANE MARIA"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "Address",
            "confidence": 0.9066667
          },
          "fieldValue": {
            "valueType": "STRING",
            "boundingPolygon": {
              "normalizedVertices": [
                {
                  "x": 0.3540099263138073,
                  "y": 0.4195135526364407
                },
                {
                  "x": 0.7260099192716337,
                  "y": 0.4196277222590973
                },
                {
                  "x": 0.7259978553481731,
                  "y": 0.5174195185150979
                },
                {
                  "x": 0.35399786239034653,
                  "y": 0.5173053488924414
                }
              ]
            },
            "value": "123 MAIN STREET ANYTOWN, SC 123451111"
          }
        },
        {
          "fieldType": "KEY_VALUE",
          "fieldLabel": {
            "name": "MiddleName",
            "confidence": 0
          },
          "fieldValue": {
            "valueType": "STRING"
          }
        }
      ]
    }
  ],
  "detectedDocumentTypes": [
    {
      "documentType": "DRIVER_LICENSE",
      "confidence": 0.9585071
    }
  ],
  "documentClassificationModelVersion": "*.*.*",
  "keyValueExtractionModelVersion": "*.*.*"
}