INRODUÇÃO

A API Cognitiva DS DEVELOP foi desenvolvida com o propósito de fornecer ao mercado e desenvolvedores serviços de visão computacional com padrão de qualidade que utilizam frameworks com potencial opensource como dlib++, opencv, tesseract e openface de uma forma mais simplificada. A API cuida do desenvolvimento, integração e dos treinos dos classificadores customizados como a comunicação com cada framework de acordo com as suas especificações, oferecendo ao usuário um acesso a esse conjunto de tecnologias através ambiente amigável de webservice padrão REST.

CONCEITO

Para iniciar o acesso aos recursos da API o usuário deve fazer seu cadastro no site www.dsdevelop.com.br/apicognitiva/cadastro, após a confirmação do cadastro o usuário recebera um email com um chave de acesso e uma lista de acesso para as chamadas no WebService da API.

A api irá fazer cadastros e relacionamento internamente com token criados por ela mesmo e vai retorná los para o usuário para que ele possa registrar esse token em sua base e assim ter um relacionamento de que pessoa representa cada token.

Obs: No plano gratuito para testes existe o limite de chamadas diárias e o tempo de resposta da API pode ser um pouco maior.

SERVIÇOS COGNITIVOS PARA VEICULOS

Métodos e explanações

  • Anpr V1 find

Este método processa a imagem do veículo e extrai dados como a existência da placa, identificação da marca, identificação da cor(quando imagem colorida).

Requerimentos de imagem

Formato: JPG
Tamanho: entre de 748*480 a 1024*1024 (pixels)
Obs: A imagem deve ter visão para a frente ou traseira inteira do veículo e a resolução da placa estar entre 80 e 150 pixels de largura para obter melhores resultados.

Request URL
httpss://api.dsdevelop.com.br/api/anpr/v1/find

Request Method
POST / JSON (application/json)

Obrigatório

Nome

Tipo

Descrição

Sim

id

String

Referência sistema terceiro, enviar String vazia se não for utilizar

Sim token String String token recebido por email na validação do cadastro
Sim retImage Boolean true = retorna Strings base64 dos objetos encontrados na imagem na resposta do request.
Sim analise Boolean

true = tenta identificar a marca do veículo pela imagem.

Sim base64Image String String encode padrão base 64 da imagem jpg

 

Valor de retorno

Campos

Tipo

Descrição

Plate

Object

O objeto Plate é composto pelos valores:

  • plate                                 = Boolean (encontro placa na images)
  • factory                              = Boolean (encontro fabricante na imagem)
  • size_plate                        = Quantidade de placas encontradas
  • size_factory                     = Quantidade de fabricantes encontrados
  • codeRet                           = Integer condigo retorno da chamada
  • message                          = String mensagem status da chamada
  • Lista com os seguinte atributos:
    • id                          = String id referencia enviado da chamada
    • region                   = Coordenadas do objeto identificado
      • Width
      • Top
      • Left
      • Heigth
    • type                     = tipo de objeto = plate ou factory
    • imgObj                = String base64 do objeto encontrado recortado
    • value                   = marca do veículo ou valor da placa
    • confidence       = nível de qualidade do reconhecimento 0.0 a 1
Exemplo resposta com objetos encontrados:

                            

{
      “plate”: true,
      “factory”: true,
      “size_plate”: 1,
      “size_Factory”: 1,
      “list”: [
                    {
                           “id”: “01”,
                            “region”: {
                                   “Width”: 78,
                                   “Top”: 133,
                                   “Left”: 66,
                                   “Heigth”: 27
                             },
                             “type”: “Plate”,
                             “imgObj”: “/9j/4AAQSkZJRgABAQAAAQABA…..”,
                             “value”: “QHZ2344”,
                             “confidence”: 67
                     },
                     {
                             “id”: “01”,
                             “region”: {
                                   “Width”: 49,
                                   “Top”: 103,
                                   “Left”: 78,
                                   “Heigth”: 24
                             },
                             “type”: “Factory”,
                             “imgObj”: “krk+hPAHt/LpXN/wBuTxOzm1iZ……”,
                             “value”: “HYUNDAI”
                    }

              ],
              “codeRet”: 1,
              “message”: “SUCCESS”
}

Sem objetos encontrados
{
"plate": false,
"factory": false,
"size_plate": 0,
"size_Factory": 0,
"list": [],
"codeRet": 1,
"message": "SUCCESS"
}
Mensagens de erros
Campos Tipo Descrição
codeRet int código de retorno da mensagem. Código possível para esta chamada:
7 = INVALID KEY
message String Descrição da mensagem de erro.