Распознавание СТС

A.0200.STS.SCN

Используется для распознавания свидетельств о регистрации транспортного средства.

Распознаются все поля лицевой и обратной сторон СТС. По каждому полю в ответе выдаётся распознанное значение и точность в процентах. Точность распознавания зависит от качества изображения и составляет 99 % при высоком качестве изображения.

Требования к фото: максимальный размер — 15 Мбайт, разрешение — не ниже 512×512 пикселей.

Идентификаторы объекта: ссылка на фото или скан документа.

Иcпользуемые источники: check_person/recognition_doc_by_type_vrc.

Время генерации отчёта:

  • 50-й перцентиль — 0,5 с;
  • 95-й перцентиль — 0,8 с.

Параметры запроса

При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:

Параметр Тип Обязательность Описание
queryType string Обязательный Тип запроса.
Фиксированное значение: MULTIPART
query string Обязательный Значение простого запроса.
Фиксированное значение:  
data object Обязательный Идентификаторы объекта поиска
Параметры объекта data
image_url string Обязательный URL изображения
document_type string Обязательный Тип документа.
Возможные значения:
VEHICLE_REGISTRATION_CERTIFICATE_FRONT — лицевая сторона СТС,
VEHICLE_REGISTRATION_CERTIFICATE_BACK — обратная сторона СТС

Пример тела запроса

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "image_url": "https://some.domain/image_1.png",
    "document_type": "VEHICLE_REGISTRATION_CERTIFICATE_FRONT"
  }
}

Структура отчёта

Данные отчёта находятся в объекте data[].content.check_person.recognition_doc_by_type тела ответа.

Поле Тип Описание
status string Статус распознавания документа.
Справочник значений
status_desc string Описание статуса распознавания документа
validation_errors object Ошибки валидации
document_type string Тип документа.
Справочник значений
vehicle_registration_certificate_front object Лицевая сторона СТС
vehicle_registration_certificate_back object Обратная сторона СТС

Лицевая сторона СТС

Поле Тип Описание
reg_number object Регистрационный знак
vin object Идентификационный номер (VIN)
brand_rus object Марка (рус.)
brand_eng object Марка (лат.)
model_rus object Модель (рус.)
model_eng object Модель (лат.)
vehicle_type object Тип ТС
vehicle_category object Категория ТС
release_year object Год выпуска ТС
engine_model object Модель двигателя
engine_number object Двигатель №
vehicle_chassis object Шасси (рама) №
vehicle_body object Кузов (коляска) №
color object Цвет
engine_kw object Мощность двигателя, кВт
engine_hp object Мощность двигателя, л. с.
ecologic_class object Экологический класс
engine_volume object Рабочий объем двигателя, см³
passport_series object Паспорт ТС серия
passport_number object Паспорт ТС №
max_mass object Разрешенная max масса, кг
mass object Масса без нагрузки, кг
temporary_registration_term object Срок временной регистрации
series_bottom object Серия СТС (нижняя часть)
number_bottom object Номер СТС (нижняя часть)
document_number object Серия и номер СТС

Поле документа

Поле Тип Описание
text string Значение поля
confidence number Точность распознавания поля

Обратная сторона СТС

Поле Тип Описание
series_top object Серия СТС (верхняя часть)
number_top object Номер СТС (верхняя часть)
surname_rus object Фамилия собственника (рус.)
surname object Фамилия собственника (лат.)
name_rus object Имя собственника (рус.)
name object Имя собственника (лат.)
patronymic_rus object Отчество собственника (рус.)
legal_name_rus object Название ЮЛ-владельца (рус.)
legal_name object Название ЮЛ-владельца (лат.)
province_rus object Республика, край, область (рус.)
province object Республика, край, область (лат.)
region object Район
city object Нас. пункт
street object Улица
house_number object Дом
building_number object Корпус
apartment_number object Квартира
special_marks object Особые отметки
police_unit_code object Выдано ГИБДД
date object Дата выдачи
series_bottom object Серия СТС (нижняя часть)
number_bottom object Номер СТС (нижняя часть)

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

Значение Описание
OK Документ успешно распознан
DOCUMENT_TYPE_IS_NOT_ALLOWED Данный тип документа не входит в число разрешенных
LOW_IMAGE_QUALITY Низкое качество фото
DOCUMENT_TYPE_NOT_MATCH Загруженное фото не соответствует выбранному типу документа
VALIDATION_FAIL Ошибка валидации
PAYLOAD_TOO_LARGE Файл слишком большой
DOWNLOAD_FAIL Ошибка при загрузке файла
CLASSIFY_FAIL Ошибка при классификации
RECOGNITION_FAIL Ошибка при распознавании
NONE Ошибка

Справочник Тип документа

Значение Описание
vehicle_registration_certificate_front Лицевая сторона свидетельства о регистрации ТС
vehicle_registration_certificate_back Обратная сторона свидетельства о регистрации ТС
none Не установлен

Пример данных отчёта по лицевой стороне СТС

{
  "data": [
    {
      "report_type_uid": "A.0200.STS.SCN_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/recognition_doc_by_type_vrc",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "recognition_doc_by_type": {
            "status": "OK",
            "status_desc": "Документ успешно распознан",
            "document_type": "vehicle_registration_certificate_front",
            "vehicle_registration_certificate_front": {
              "brand_eng": {
                "text": "dyes benz",
                "confidence": 0.9994248747825623
              },
              "brand_rus": {
                "text": "мерседес benz",
                "confidence": 0.998415619134903
              },
              "color": {
                "text": "Синий",
                "confidence": 0.11873934417963028
              },
              "ecologic_class": {
                "text": "",
                "confidence": 0.0
              },
              "engine_model": {
                "text": "",
                "confidence": 0.0
              },
              "engine_number": {
                "text": "12345678901234",
                "confidence": 0.9945482611656189
              },
              "engine_volume": {
                "text": "3199",
                "confidence": 0.9981810450553894
              },
              "mass": {
                "text": "1780",
                "confidence": 0.9936210513114929
              },
              "max_mass": {
                "text": "2380",
                "confidence": 0.993195116519928
              },
              "model_eng": {
                "text": "9320",
                "confidence": 0.6997422575950623
              },
              "model_rus": {
                "text": "8320",
                "confidence": 0.7744458913803101
              },
              "reg_number": {
                "text": "А111АА00",
                "confidence": 0.9933617115020752
              },
              "release_year": {
                "text": "1995",
                "confidence": 0.9975956678390503
              },
              "temporary_registration_term": {
                "text": "",
                "confidence": 0.0
              },
              "vehicle_category": {
                "text": "B",
                "confidence": 0.9860054850578308
              },
              "vehicle_chassis": {
                "text": "",
                "confidence": 0.0
              },
              "vehicle_type": {
                "text": "",
                "confidence": 0.0
              },
              "engine_kw": {
                "text": "161",
                "confidence": 0.9328411817550659
              },
              "engine_hp": {
                "text": "212",
                "confidence": 0.9328411817550659
              },
              "passport_series": {
                "text": "10АА",
                "confidence": 0.9772066473960876
              },
              "passport_number": {
                "text": "100000",
                "confidence": 0.9772066473960876
              },
              "document_number": {
                "text": "",
                "confidence": 0.9230936765670776
              },
              "series_bottom": {
                "text": "",
                "confidence": 0.9230936765670776
              },
              "number_bottom": {
                "text": "100000",
                "confidence": 0.9230936765670776
              },
              "vin": {
                "text": "EXAMPL0V1N1000000",
                "confidence": 0.9889141321182251
              },
              "vehicle_body": {
                "text": "EXPLBD-1000000",
                "confidence": 0.9889141321182251
              }
            }
          }
        }
      }
    }
  ]
}

Пример данных отчёта по обратной стороне СТС

{
  "data": [
    {
      "report_type_uid": "A.0200.STS.SCN_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/recognition_doc_by_type_vrc",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "recognition_doc_by_type": {
            "status": "OK",
            "status_desc": "Документ успешно распознан",
            "document_type": "vehicle_registration_certificate_back",
            "vehicle_registration_certificate_back": {
              "apartment_number": {
                "text": "",
                "confidence": 0.0
              },
              "building_number": {
                "text": "",
                "confidence": 0.0
              },
              "city": {
                "text": "ВСЕВОЛОЖСК УФМС ЛОДНСК",
                "confidence": 0.2761100232601166
              },
              "house_number": {
                "text": "12",
                "confidence": 0.9997313022613525
              },
              "name": {
                "text": "ALEKSANDR",
                "confidence": 0.9999895691871643
              },
              "name_rus": {
                "text": "АЛЕКСАНДР",
                "confidence": 0.9998015761375427
              },
              "number_bottom": {
                "text": "100000",
                "confidence": 0.9991455674171448
              },
              "number_top": {
                "text": "12100000",
                "confidence": 0.3968217670917511
              },
              "patronymic_rus": {
                "text": "СЕРГЕЕВИЧ",
                "confidence": 0.981269359588623
              },
              "police_unit_code": {
                "text": "Р30 ГИБДД ИБАА ГУВА С. -ПЕТЕРБУРГА ПОАТ",
                "confidence": 0.4793885350227356
              },
              "region": {
                "text": "ВСЕВОЛОЖСКИЙ (СЕМО) ЛО7НЕКТУ",
                "confidence": 0.18886211514472961
              },
              "series_bottom": {
                "text": "10AA",
                "confidence": 0.9752761721611023
              },
              "series_top": {
                "text": "10AА",
                "confidence": 0.914313018321991
              },
              "special_marks": {
                "text": "СОФЫЕ ОТДЕЛКИ В ТРАДИЦИОННС 14.",
                "confidence": 0.29118651151657104
              },
              "street": {
                "text": "ДОРОЖНЫЙ ПЕР. /DOROZHNY ГУ PER",
                "confidence": 0.4626966118812561
              },
              "date": {
                "text": "",
                "confidence": 0.0
              },
              "surname_rus": {
                "text": "НАЛИВАЙКО",
                "confidence": 0.8869436979293823
              },
              "legal_name_rus": {
                "text": "",
                "confidence": 0.8869436979293823
              },
              "surname": {
                "text": "NAL IVAIKO",
                "confidence": 0.8869436979293823
              },
              "legal_name": {
                "text": "",
                "confidence": 0.8869436979293823
              },
              "province": {
                "text": "РОССИЯ ROSSIYA ЛЕНИНГР ОБЛ",
                "confidence": 0.7194730639457703
              },
              "province_rus": {
                "text": "РОССИЯ ROSSIYA ЛЕНИНГР ОБЛ",
                "confidence": 0.7194730639457703
              }
            }
          }
        }
      }
    }
  ]
}

Пример ответа, если загруженное фото не соответствует выбранному типу документа

{
  "data": [
    {
      "report_type_uid": "A.0200.STS.SCN_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/recognition_doc_by_type_vrc",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "recognition_doc_by_type": {
            "status": "DOCUMENT_TYPE_NOT_MATCH",
            "status_desc": "Загруженное фото не соответствует типу документа VEHICLE_REGISTRATION_CERTIFICATE_FRONT",
            "document_type": "none"
          }
        }
      }
    }
  ]
}