Get started
Yandex Vision

Recognition of presets

    Recognition of presets is at the Preview stage and is not charged additionally. Its usage is charged according to text recognition pricing policy.

    You can extract standard fields and recognize the text of presets and documents: passports, driver licenses, and license plate numbers.

    To recognize text in your document, use the model parameter of the text_detection_config array to specify one of the following recognition models:

    • passport: Passport, the main double page spread.
    • driver-license-front: Driver's license, the front side.
    • driver-license-back: Driver's license, the reverse side.
    • license-plates: All the license plate numbers in the image.

    Example of a request to recognize the main double page spread of a passport in body.json:

    {
    "analyze_specs": [{
        "content": "....",
        "features": [{
            "type": "TEXT_DETECTION",
            "text_detection_config": {
                "language_codes": ["*"],
                "model": "passport"
            }
        }]
    }]
}

    For the passport, driver-license-front, and driver-license-back models, an entities array is added in the service response.

    For the license-plates model, the response doesn't contain an entities array. This model recognizes all the license plate numbers in the image and doesn't recognize any other text.
    In this case, the completeness and accuracy that license plate numbers are recognized for this model is much higher than for the general OCR model. The recognition results are shown in the standard text_detection response.

    Example of the entities array returned in the service response:

    {         "entities": [
         {
          "name": "name",
          "text": "Sonya"
         },
         {
          "name": "middle_name",
          "text": "Anna"
         },
         {
          "name": "surname",
          "text": "Ray"
         },
         {
          "name": "gender",
          "text": "female"
         },
         {
          "name": "citizenship",
          "text": "usa"
         },
         {
          "name": "birth_date",
          "text": "12.05.1978"
         },
         {
          "name": "birth_place",
          "text": "Ap #762-7228 Dis Rd.Austin KY 50350."
         },
         {
          "name": "number",
          "text": "0702084625"
         },
         {
          "name": "issue_date",
          "text": "10.05.2011"
         },
         {
          "name": "expiration_date",
          "text": "-"
         }
        ]}

    List of fields in the entities array:

    • passport
      • name: First name.
      • middle_name: Middle name.
      • surname: Last name.
      • gender: Gender.
      • citizenship: Citizenship.
      • birth_date: Date of birth.
      • birth_place: Place of birth.
      • number: Passport number.
      • issue_date: Date of issue.
      • subdivision: Department code.
      • expiration_date: Date of expiration.
    • driver-license-front
      • name: First name.
      • middle_name: Middle name.
      • surname: Last name.
      • number: Driver's license number.
      • birth_date: Date of birth.
      • issue_date: Date of issue.
      • expiration_date: Date of expiration.
    • driver-license-back
      • experience_from: Driving experience (year since).
      • number: Driver's license number.
      • issue_date: Date of issue.
      • expiration_date: Date of expiration.
      • prev_number: The previous driver's license number.

    What's next