DEV Community

Cover image for Automate identity document processing with Document AI
Laurent Picard for Google Cloud

Posted on • Originally published at cloud.google.com

Automate identity document processing with Document AI

How many times have you filled out forms requesting personal information? It's probably too many times to count. When online and signed in, you can save a lot of time thanks to your browser’s autofill feature. In other cases, you often have to provide the same data manually, again and again. The first Document AI identity processors are now generally available and can help you solve this problem.

In this post, you’ll see how to…

  • Process identity documents with Document AI
  • Create your own identity form autofiller

Use cases

Here are a few situations that you've probably encountered:

  • Financial accounts: Companies need to validate the identity of individuals. When creating a customer account, you need to present a government-issued ID for manual validation.
  • Transportation networks: To handle subscriptions, operators often manage fleets of custom identity-like cards. These cards are used for in-person validation, and they require an ID photo.
  • Identity gates: When crossing a border (or even when flying domestically), you need to pass an identity check. The main gates have streamlined processes and are generally well equipped to scale with the traffic. On the contrary, smaller gates along borders can have manual processes – sometimes on the way in and the way out – which can lead to long lines and delays.
  • Hotels: When traveling abroad and checking in, you often need to show your passport for a scan. Sometimes, you also need to fill out a longer paper form and write down the same data.
  • Customer benefits: For benefit certificates or loyalty cards, you generally have to provide personal info, which can include a portrait photo.

In these examples, the requested info – including the portrait photo – is already on your identity document. Moreover, an official authority has already validated it. Checking or retrieving the data directly from this source of truth would not only make processes faster and more effective, but also remove a lot of friction for end users.

Identity processors

Processor types

Each Document AI identity processor is a machine learning model trained to extract information from a standard ID document such as:

  • Driver license
  • National ID
  • Passport

examples of ID documents

Note: an ID can have information on both sides, so identity processors support up to two pages per document.

Availability

Generally available as of June 2022, you can use two US identity processors in production:

Processor API type
US Driver License Parser US_DRIVER_LICENSE_PROCESSOR
US Passport Parser US_PASSPORT_PROCESSOR

Currently available in Preview:

  • The Identity Doc Fraud Detector, to check whether an ID document has been tampered with
  • Three French identity processors
Processor API type
Identity Doc Fraud Detector ID_FRAUD_DETECTION_PROCESSOR
France Driver License Parser FR_DRIVER_LICENSE_PROCESSOR
France National ID Parser FR_NATIONAL_ID_PROCESSOR
France Passport Parser FR_PASSPORT_PROCESSOR

Notes:

  • More identity processors are in the pipe.
  • To request access to processors in Preview, please fill out the Access Request Form.

Processor creation

You can create a processor:

  • Manually from Cloud Console (web admin UI)
  • Programmatically with the API

Processors are location-based. This helps guarantee where processing will occur for each processor.

Here are the current multi-region locations:

Location API location
United States us
European Union eu

Once you've created a processor, you reference it with its ID (PROCESSOR_ID hereafter).

processor creation screencast

Note: To manage processors programmatically, see the codelab Managing Document AI processors with Python.

Document processing

You can process documents in two ways:

  • Synchronously with an online request, to analyze a single document and directly use the results
  • Asynchronously with a batch request, to launch a batch processing operation on multiple or larger documents

Online requests

Example of a REST online request:

  • The method is named process.
  • The input document here is a PNG image (base64 encoded).
  • This request is processed in the European Union.
  • The response is returned synchronously.
POST https://eu-documentai.googleapis.com
     /v1/projects/PROJECT_ID/locations/eu/processors/PROCESSOR_ID
     :process
Enter fullscreen mode Exit fullscreen mode
{
  "rawDocument": {
    "content": "iVBORw0KGg…",
    "mimeType": "image/png"
  },
  "skipHumanReview": true
}
Enter fullscreen mode Exit fullscreen mode

Batch requests

Example of a REST batch request:

  • The method is named batchProcess.
  • The batchProcess method launches the batch processing of multiple documents.
  • This request is processed in the United States.
  • The response is returned asynchronously; output files will be stored under my-storage-bucket/output/.
POST https://us-documentai.googleapis.com
     /v1/projects/PROJECT_ID/locations/us/processors/PROCESSOR_ID
     :batchProcess
Enter fullscreen mode Exit fullscreen mode
{
  "inputDocuments": {
    "gcsDocuments": {
      "documents": [
        {
          "gcsUri": "gs://my-storage-bucket/input/id-doc-1.pdf",
          "mimeType": "application/pdf"
        },
        {
          "gcsUri": "gs://my-storage-bucket/input/id-doc-2.tiff",
          "mimeType": "image/tiff"
        },
        {
          "gcsUri": "gs://my-storage-bucket/input/id-doc-3.png",
          "mimeType": "image/png"
        },
        {
          "gcsUri": "gs://my-storage-bucket/input/id-doc-4.gif",
          "mimeType": "image/gif"
        }
      ]
    }
  },
  "documentOutputConfig": {
    "gcsOutputConfig": {
      "gcsUri": "gs://my-storage-bucket/output/"
    }
  },
  "skipHumanReview": true
}
Enter fullscreen mode Exit fullscreen mode

Interfaces

Document AI is available through the usual Google Cloud interfaces:

  • The RPC API (low-latency gRPC)
  • The REST API (JSON requests and responses)
  • Client libraries (gRPC wrappers, currently available for Python, Node.js, and Java)
  • Cloud Console (web admin UI)

Note: With the client libraries, you can develop in your preferred programming language. You'll see an example later in this post.

Identity fields

A typical REST response looks like the following:

  • The text and pages fields include the OCR data detected by the underlying ML models. This part is common to all Document AI processors.
  • The entities list contains the fields specifically detected by the identity processor.
{
  "text": "…",
  "pages": [],
  "entities": [
    {
      "textAnchor": {},
      "type": "Family Name",
      "mentionText": "PICHAI",
      "confidence": 0.999945,
      "pageAnchor": {},
      "id": "4"
    },
    {
      "textAnchor": {},
      "type": "Given Names",
      "mentionText": "Sundar",
      "confidence": 0.9999612,
      "pageAnchor": {},
      "id": "5"
    }
    ,
  ]
}
Enter fullscreen mode Exit fullscreen mode

Here are the detectable identity fields:

Entity type Comment
Portrait Bounding box (portrait photo)
Family Name String
Given Names String
Document Id String
Expiration Date Date (+ normalization)
Date Of Birth Date (+ normalization)
Issue Date Date (+ normalization)
Address String
MRZ Code String (Machine Readable Zone)

Please note that Address and MRZ Code are optional fields. For example, a US passport contains an MRZ but no address.

Fraud detection

Available in preview, the Identity Doc Fraud Detector helps detect tampering attempts. Typically, when an identity document does not "pass" the fraud detector, your automated process can block the attempt or trigger a human validation.

Here is an example of signals returned:

Entity type Example
fraud-signals/is-identity-document "NOT_AN_ID"
fraud-signals/suspicious-words "PASS"
fraud-signals/image-manipulation "POSSIBLE_IMAGE_MANIPULATION"

Sample demo

You can process a document live with just a few lines of code.

Here is a Python example:

import google.cloud.documentai_v1 as docai


def process_document(
    file: typing.BinaryIO,
    mime_type: str,
    project_id: str,
    location: str,
    processor_id: str,
) -> docai.Document:
    api_endpoint = {"api_endpoint": f"{location}-documentai.googleapis.com"}
    client = docai.DocumentProcessorServiceClient(client_options=api_endpoint)

    raw_document = docai.RawDocument(content=file.read(), mime_type=mime_type)
    name = client.processor_path(project_id, location, processor_id)

    request = docai.ProcessRequest(
        raw_document=raw_document,
        name=name,
        skip_human_review=True,
    )
    response = client.process_document(request)

    return docai.Document(response.document)
Enter fullscreen mode Exit fullscreen mode

This function uses the Python client library:

  • The input is a file (any format supported by the processor).
  • client is an API wrapper (configured for processing to take place in the desired location).
  • process_document calls the API process method, which returns results in seconds.
  • The output is a structured Document.

You can collect the detected fields by parsing the document entities:

def id_data_from_document(document: docai.Document) -> dict:
    id_data = defaultdict(dict)

    for entity in document.entities:
        key = entity.type_
        page_index = 0
        value = entity.mention_text
        confidence, normalized = None, None

        if entity.page_anchor:
            page_index = entity.page_anchor.page_refs[0].page
        if not value:  # Send the detected portrait image instead
            image = crop_entity(document, entity)
            value = data_url_from_image(image)
        if entity.confidence != 0.0:
            confidence = int(entity.confidence * 100 + 0.5)
        if entity.normalized_value:
            normalized = entity.normalized_value.text

        id_data[key][page_index] = dict(
            value=value,
            confidence=confidence,
            normalized=normalized,
        )

    return id_data
Enter fullscreen mode Exit fullscreen mode

Note: This function builds a mapping ready to be sent to a frontend. A similar function can be used for other specialized processors.

Finalize your app:

  • Define your user experience and architecture
  • Implement your backend and its API
  • Implement your frontend with a mix of HTML + CSS + JS
  • Add a couple of features: file uploads, document samples, or webcam captures
  • That's it; you've built an identity form autofiller

Here is a sample web app in action:

demo animation

Here is the processing of a French national ID, dropping images from the client:

demo animation

Note: For documents with multiple pages, you can use a PDF or TIFF container. In this example, the two uploaded PNG images are merged by the backend and processed as a TIFF file.

And this is the processing of a US driver license, captured with a laptop 720p webcam:

demo animation

Notes:

  • Did you notice that the webcam capture is skewed and the detected portrait image straight? That's because Document AI automatically deskews the input at the page level. Documents can even be upside down.
  • Some fields (such as the dates) are returned with their normalized values. This can make storing and processing these values a lot easier – and less error-prone – for developers.

The source code for this demo is available in our Document AI sample repository.

More

Stay tuned; the family of Document AI processors keeps growing and growing.

Top comments (0)