Распознавание документов
Вы можете извлекать стандартные поля и распознавать текст шаблонов и документов: паспорта, водительского удостоверения, свидетельства о регистрации транспортного средства (СТС), регистрационных номеров автомобилей.
Модели распознавания
Указывайте выбранную модель в параметрах запроса в поле 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.
Важно
Модель license-plates
не поддерживает автоматическое определение языка. Чтобы использовать эту модель, обязательно укажите язык текста, например ru
.
Пример вывода массива 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": "-"
}
]}