Oracle Cloud Infrastructureドキュメント

キー値抽出(パスポート)

キー値抽出を使用して、MRZでサポートされているパスポート内の事前定義済キーの値を識別できます。たとえば、パスポートに国籍および発行日が含まれている場合、Document Understandingはこれらの値を識別し、それらをキー値ペアとして返すことができます。

サポートされる機能は、次のとおりです。

  • 事前定義済キー値ペアの値の抽出
  • 信頼度スコア
サポートされるフィールドは次のとおりです。
サポートされているフィールド
フィールド Description APIレスポンス値
FirstName ドキュメントにリストされている名(指定された名前)。 抽出されたテキスト
LastName ドキュメントにリストされている姓。 抽出されたテキスト
国コード ドキュメントにリストされている国。 抽出されたISO 3166-1国コード
国籍 文書所有者の国籍。 抽出されたISO 3166-1国コード
BirthDate 誕生日
  • YYYY/MM/DD書式の日付
  • Else: <
ExpiryDate 文書にリストされている失効日。
  • YYYY/MM/DD書式の日付
  • Else: <
性別 文書にリストされた性別。 抽出されたテキスト
DocumentType ドキュメント・タイプ。パスポートの場合は「P」、Visaの場合は「V」など、1文字としてリストされることがよくあります。 抽出されたテキスト
DocumentNumber ドキュメント識別番号です。 抽出されたテキスト

キー値抽出(パスポート)の例

Document Understandingでのパスポートからのキー値抽出の使用例。

入力ドキュメント
キー値抽出(パスポート)入力架空のパスポート APIリクエスト:
{ 
       "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": "" 
       }
       }
出力:
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": "*.*.*("
}