Распознавание документов

Вы можете извлекать стандартные поля и распознавать текст шаблонов и документов: паспорта, водительского удостоверения, свидетельства о регистрации транспортного средства (СТС), регистрационных номеров автомобилей.

Модели распознаванияМодели распознавания

Указывайте выбранную модель в параметрах запроса в поле model.

Модели для распознавания шаблонных документов:

• passport — основной разворот паспорта.
• driver-license-front — водительское удостоверение, лицевая сторона.
• driver-license-back — водительское удостоверение, обратная сторона.
• vehicle-registration-front — свидетельство о регистрации транспортного средства, лицевая сторона.
• vehicle-registration-back — свидетельство о регистрации транспортного средства, обратная сторона.
• license-plates — все регистрационные номера автомобилей на изображении.

Страны, чьи документы доступны для распознаванияСтраны, чьи документы доступны для распознавания

Список возвращаемых полейСписок возвращаемых полей

В зависимости от модели список полей в ответе будет отличаться:

Модель passport:

• name — имя.
• middle_name — отчество.
• surname — фамилия.
• gender — пол.
• citizenship — гражданство.
• birth_date — дата рождения.
• birth_place — место рождения.
• number — номер паспорта.
• issued_by — кем выдан.
• issue_date — дата выдачи.
• subdivision — код подразделения.
• expiration_date — дата окончания срока действия.

Модель driver-license-front:

• name — имя.
• middle_name — отчество.
• surname — фамилия.
• number — номер водительского удостоверения.
• birth_date — дата рождения.
• issue_date — дата выдачи.
• expiration_date — дата окончания срока действия.

Модель driver-license-back:

• experience_from — водительский стаж (с какого года).
• number — номер водительского удостоверения.
• issue_date — дата выдачи.
• expiration_date — дата окончания срока действия.
• prev_number — номер предыдущего водительского удостоверения.

Модель vehicle-registration-front:

• stsfront_car_number — автомобильный номер.
• stsfront_vin_number — VIN-номер транспортного средства.
• stsfront_car_brand — марка транспортного средства.
• stsfront_car_model — модель транспортного средства.
• stsfront_car_year — год выпуска транспортного средства.
• stsfront_car_chassis_number — номер шасси.
• stsfront_car_trailer_number — номер кузова, кабины или прицепа.
• stsfront_car_color — цвет транспортного средства.
• stsfront_sts_number — номер СТС.

Модель vehicle-registration-back:
* stsback_car_owner — ФИО собственника или имя юридического лица.
* stsback_sts_number — номер СТС.

ПримерПример

Запрос на распознаваниеЗапрос на распознавание

Файл body.json:

{
  "mimeType": "<тип_данных>",
  "languageCodes": ["*"],
  "model": "<модель_распознавания>",
  "content": "<изображение_для_распознавания>"
}

Где:

• mimeType — MIME-тип передаваемых данных.
• languageCodes — язык текста. Для автоматического определения языка текста укажите *.
• model — модель распознавания.
• content — изображение, закодированное в Base64.

Ответ на запросОтвет на запрос

В ответе моделей passport, driver-license-front, driver-license-back, vehicle-registration-front и vehicle-registration-back будет массив entities.

Ответ модели license-plates не содержит массив entities. Эта модель распознает все регистрационные номера автомобилей на изображении и не распознает другой текст. При этом полнота и точность распознавания регистрационных номеров автомобилей у этой модели значительно выше, чем у общей модели OCR. Результаты распознавания отображаются в стандартном ответе text_detection.

Пример вывода массива entities для модели passport в ответе сервиса:

{  "entities": [
   {
    "name": "name",
    "text": "елена"
   },
   {
    "name": "middle_name",
    "text": "михайловна"
   },
   {
    "name": "surname",
    "text": "агапова"
   },
   {
    "name": "gender",
    "text": "жен"
   },
   {
    "name": "citizenship",
    "text": "rus"
   },
   {
    "name": "birth_date",
    "text": "12.05.1978"
   },
   {
    "name": "birth_place",
    "text": "гор.пенза пензенского р-на пензенской обл."
   },
   {
    "name": "number",
    "text": "0702084625"
   },
   {
    "name": "issued_by",
    "text": "отделом уфмс россии по пензенской обл. центрального района гор.пенза."
   },
   {
    "name": "issue_date",
    "text": "10.05.2011"
   },
   {
    "name": "expiration_date",
    "text": "-"
   }
  ]}

См. такжеСм. также

• Список поддерживаемых языков и моделей
• Известные ограничения в текущей версии Vision OCR
• Как распознать текст на изображении