Распознавание скана ВУ

• Описание
• Параметры запроса
• Структура отчёта

P.0066.DRL.SCN

Распознавание водительских удостоверений Российской Федерации.

Распознаются все поля лицевой и обратной сторон водительского удостоверения в зависимости от образца (2011, 2014 гг.). По каждому полю в ответе выдаётся распознанное значение и точность в процентах. Точность распознавания зависит от качества изображения и составляет 95 % для рукописных полей и 99 % для машинопечатных при высоком качестве изображения.

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

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

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

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

• 50-й перцентиль — 2 с;
• 95-й перцентиль — 4 с.

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

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

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

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

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

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

Обратная сторона ВУ образца 2014 года

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

Лицевая сторона ВУ образца 2011 года

Обратная сторона ВУ образца 2011 года

Лицевая сторона пластикового ВУ образца 1999 года

Лицевая сторона бумажного ВУ образца 1999 года

Обратная сторона бумажного ВУ образца 1999 года

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

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

Пример данных отчёта по лицевой стороне ВУ образца 2011 года

{
  "data": [
    {
      "report_type_uid": "P.0066.DRL.SCN_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/recognition_doc_by_type_driver_license",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "recognition_doc_by_type": {
            "status": "OK",
            "status_desc": "Документ успешно распознан",
            "document_type": "driver_license_2011_front",
            "driver_license_2011_front": {
              "surname": {
                "text": "СИДОРОВ",
                "confidence": 0.8403598070144653
              },
              "name": {
                "text": "СИДОР",
                "confidence": 0.9760236740112305
              },
              "patronymic": {
                "text": "СИДОРОВИЧ",
                "confidence": 0.9760236740112305
              },
              "date_of_birth": {
                "text": "15.01.1988",
                "confidence": 0.9706380367279053
              },
              "place_of_birth": {
                "text": "г.москва",
                "confidence": 0.9784156680107117
              },
              "number": {
                "text": "0220111111",
                "confidence": 0.9893730282783508
              },
              "date_from": {
                "text": "01.01.2015",
                "confidence": 0.5499846935272217
              },
              "date_end": {
                "text": "01.01.2025",
                "confidence": 0.6016921401023865
              },
              "issuer": {
                "text": "ГИБДД 0007",
                "confidence": 0.9369502067565918
              },
              "place_of_issue": {
                "text": "г.москва",
                "confidence": 0.9937742948532104
              },
              "category": {
                "text": "в в1",
                "confidence": 0.9569002985954285
              }
            }
          }
        }
      }
    }
  ]
}

Пример данных отчёта по обратной стороне ВУ образца 2014 года

{
  "data": [
    {
      "report_type_uid": "P.0066.DRL.SCN_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/recognition_doc_by_type_driver_license",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "recognition_doc_by_type": {
            "status": "OK",
            "status_desc": "Документ успешно распознан",
            "document_type": "driver_license_2014_back",
            "driver_license_2014_back": {
              "category_a1_begin": {
                "text": "",
                "confidence": 0
              },
              "category_a1_end": {
                "text": "",
                "confidence": 0
              },
              "category_a_begin": {
                "text": "",
                "confidence": 0
              },
              "category_a_end": {
                "text": "",
                "confidence": 0
              },
              "category_b1_begin": {
                "text": "01.01.2017",
                "confidence": 0.8960819244384766
              },
              "category_b1_end": {
                "text": "01.01.2027",
                "confidence": 0.9767715930938721
              },
              "category_b_begin": {
                "text": "01.01.2007",
                "confidence": 0.5054647922515869
              },
              "category_b_end": {
                "text": "01.01.2027",
                "confidence": 0.9512788653373718
              },
              "category_be_begin": {
                "text": "",
                "confidence": 0
              },
              "category_be_end": {
                "text": "",
                "confidence": 0
              },
              "category_c1_begin": {
                "text": "01.01.2017",
                "confidence": 0.5409528017044067
              },
              "category_c1_end": {
                "text": "01.01.2027",
                "confidence": 0.6326353549957275
              },
              "category_c1e_begin": {
                "text": "",
                "confidence": 0
              },
              "category_c1e_end": {
                "text": "",
                "confidence": 0
              },
              "category_c_begin": {
                "text": "01.01.1999",
                "confidence": 0.776997447013855
              },
              "category_c_end": {
                "text": "01.01.2027",
                "confidence": 0.8815849423408508
              },
              "category_ce_begin": {
                "text": "",
                "confidence": 0
              },
              "category_ce_end": {
                "text": "",
                "confidence": 0
              },
              "category_d1_begin": {
                "text": "",
                "confidence": 0
              },
              "category_d1_end": {
                "text": "",
                "confidence": 0
              },
              "category_d1e_begin": {
                "text": "",
                "confidence": 0
              },
              "category_d1e_end": {
                "text": "",
                "confidence": 0
              },
              "category_d_begin": {
                "text": "",
                "confidence": 0
              },
              "category_d_end": {
                "text": "",
                "confidence": 0
              },
              "category_de_begin": {
                "text": "",
                "confidence": 0
              },
              "category_de_end": {
                "text": "",
                "confidence": 0
              },
              "category_m_begin": {
                "text": "01.01.2017",
                "confidence": 0.9784398674964905
              },
              "category_m_end": {
                "text": "01.01.2027",
                "confidence": 0.9857434630393982
              },
              "category_tb_begin": {
                "text": "",
                "confidence": 0
              },
              "category_tb_end": {
                "text": "",
                "confidence": 0
              },
              "category_tm_begin": {
                "text": "",
                "confidence": 0
              },
              "category_tm_end": {
                "text": "",
                "confidence": 0
              },
              "series_number": {
                "text": "01 01 222222",
                "confidence": 0.9843643307685852
              },
              "special_marks": {
                "text": "стаж с 1999",
                "confidence": 0.9878154993057251
              }
            }
          }
        }
      }
    }
  ]
}

Пример данных отчёта по лицевой стороне пластикового ВУ образца 1999 года

{
  "data": [
    {
      "report_type_uid": "P.0066.DRL.SCN_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/recognition_doc_by_type_driver_license",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "recognition_doc_by_type": {
            "status": "OK",
            "status_desc": "Документ успешно распознан",
            "document_type": "driver_license_1999_plastic_front",
            "driver_license_1999_plastic_front": {
              "surname": {
                "text": "ПЕТРОВ",
                "confidence": 0.8600428700447083
              },
              "name": {
                "text": "ПEТР",
                "confidence": 0.9927849769592285
              },
              "patronymic": {
                "text": "ПЕТРОВИЧ",
                "confidence": 0.9968787431716919
              },
              "date_of_birth": {
                "text": "01.02.1960",
                "confidence": 0.9245286583900452
              },
              "doc_series": {
                "text": "11НО",
                "confidence": 0.98593670129776
              },
              "doc_number": {
                "text": "111362",
                "confidence": 0.9884968996047974
              },
              "date_from": {
                "text": "01.01.2008",
                "confidence": 0.7916498184204102
              },
              "date_end": {
                "text": "01.01.2018",
                "confidence": 0.8408740162849426
              },
              "issuer": {
                "text": "0100",
                "confidence": 0.9953267574310303
              },
              "place_of_birth": {
                "text": "Г. МОСКВА",
                "confidence": 0.9298922419548035
              },
              "category": {
                "text": "a d e",
                "confidence": 0.6571398973464966
              }
            }
          }
        }
      }
    }
  ]
}

Пример данных отчёта по обратной стороне бумажного ВУ образца 1999 года

{
  "data": [
    {
      "report_type_uid": "P.0066.DRL.SCN_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/recognition_doc_by_type_driver_license",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "recognition_doc_by_type": {
            "status": "OK",
            "status_desc": "Документ успешно распознан",
            "document_type": "driver_license_1999_paper_back",
            "driver_license_1999_paper_back": {
              "category_a": {
                "text": "no",
                "confidence": 0.9703798890113831
              },
              "category_b": {
                "text": "yes",
                "confidence": 0.9801980257034302
              },
              "category_c": {
                "text": "yes",
                "confidence": 0.9440327286720276
              },
              "category_d": {
                "text": "yes",
                "confidence": 0.9840387105941772
              },
              "category_e": {
                "text": "no",
                "confidence": 0.9759968519210815
              },
              "special_marks": {
                "text": "очки",
                "confidence": 0.5326180934907777
              },
              "series_top": {
                "text": "77ОК",
                "confidence": 0.7326180934906006
              },
              "series_bottom": {
                "text": "77ОК",
                "confidence": 0.7326180934111222
              },
              "number_top": {
                "text": "111222",
                "confidence": 0.7326180934906006
              },
              "number_bottom": {
                "text": "111222",
                "confidence": 0.7111180934111222
              }
            }
          }
        }
      }
    }
  ]
}

Пример данных отчёта по лицевой стороне бумажного ВУ образца 1999 года

{
  "data": [
    {
      "report_type_uid": "P.0066.DRL.SCN_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/recognition_doc_by_type_driver_license",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "recognition_doc_by_type": {
            "status": "OK",
            "status_desc": "Документ успешно распознан",
            "document_type": "driver_license_1999_paper_front",
            "driver_license_1999_paper_front": {
              "surname": {
                "text": "ИВАНОВА",
                "confidence": 0.9952244758605957
              },
              "name": {
                "text": "ИВАНА",
                "confidence": 0.9973216652870178
              },
              "third_name": {
                "text": "ИВАНОВНА",
                "confidence": 0.9912676215171814
              },
              "date_of_birth": {
                "text": "01.01.1988",
                "confidence": 0.9149746298789978
              },
              "series_top": {
                "text": "44АУ",
                "confidence": 0.512452980632782
              },
              "series_bottom": {
                "text": "44АУ",
                "confidence": 0.884004533290863
              },
              "number_top": {
                "text": "25111",
                "confidence": 0.445552980632782
              },
              "number_bottom": {
                "text": "25111",
                "confidence": 0.884004533290863
              },
              "date_of_issue": {
                "text": "01.01.2014",
                "confidence": 0.985602080821991
              },
              "valid_before": {
                "text": "01.01.2024",
                "confidence": 0.569832980632782
              }
            }
          }
        }
      }
    }
  ]
}

Пример ответа при низком качестве фото

{
  "data": [
    {
      "report_type_uid": "P.0066.DRL.SCN_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/recognition_doc_by_type_driver_license",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "recognition_doc_by_type": {
            "status": "LOW_IMAGE_QUALITY",
            "status_desc": "low image resolution: 450x277 (min is 512x512).",
            "document_type": "none"
          }
        }
      }
    }
  ]
}