Leitura de Placas Veiculares por Imagem via API

Digitar placas manualmente em sistemas de estacionamento, frotas ou logística é lento e gera erros. Com a Simples API, você envia uma foto e recebe a placa lida automaticamente — e, se precisar, também os dados completos do veículo.

Neste tutorial, vamos mostrar como integrar a leitura de placas no seu sistema.

O que a API retorna?

A API de OCR de Placas detecta placas veiculares em imagens e retorna:

• Placa: texto da placa no formato Mercosul ou antigo
• Confiança: nível de certeza da leitura (0 a 1)
• Localização: coordenadas da placa na imagem (bounding box)
• Dados do veículo (opcional): marca, modelo, versão, ano, cor, combustível, tipo, cidade e estado de registro

Você paga apenas pelo que precisa: R$ 0,05 por placa quando só precisa da leitura, e R$ 0,10 por placa quando precisa dos dados do veículo. Funciona com fotos de celular, câmeras de segurança, dashcams e documentos escaneados.

Pré-requisitos

Antes de começar, você precisa de:

• Uma conta na Simples API (crie gratuitamente em simplesapi.com.br/register)
• Sua API Key (disponível no dashboard após o cadastro)
• Uma imagem contendo uma placa veicular (JPEG ou PNG)

Passo 1: Obtenha sua API Key

Após criar sua conta, acesse o dashboard e copie sua API Key. Você recebe R$ 50 em créditos gratuitos para testar — sem necessidade de cartão de crédito.

Passo 2: Leia a placa (R$ 0,05)

Envie uma imagem contendo a placa do veículo para o endpoint /v1/ocr/plate:

curl-X POST "https://api.simplesapi.com.br/v1/ocr/plate"\-H"Authorization: Bearer SUA_API_KEY"\-H"Content-Type: multipart/form-data"\-F"image=@foto_veiculo.jpg"

A API retorna as placas detectadas na imagem:

{"plates":[{"plate":"BRA2E19","confidence":0.987,"bbox":{"x":120,"y":80,"width":200,"height":60}}],"detection_method":"yolo"}

Se a imagem contiver mais de uma placa, todas são retornadas no array plates.

Passo 3: Inclua os dados do veículo (R$ 0,10)

Se você precisa dos dados completos do veículo — marca, modelo, ano, cor e mais — adicione o parâmetro vehicle_details=true:

curl-X POST "https://api.simplesapi.com.br/v1/ocr/plate?vehicle_details=true"\-H"Authorization: Bearer SUA_API_KEY"\-H"Content-Type: multipart/form-data"\-F"image=@foto_veiculo.jpg"

A resposta agora inclui o campo vehicle_info com os dados cadastrais:

{"plates":[{"plate":"BRA2E19","confidence":0.987,"bbox":{"x":120,"y":80,"width":200,"height":60},"vehicle_info":{"brand":"Toyota","model":"Corolla","version":"XEi 2.0","year":2023,"model_year":2024,"color":"Prata","fuel":"Flex","vehicle_type":"Automóvel","species":"Passageiro","passenger_capacity":5,"city":"São Paulo","state":"SP","origin":"Nacional"}}],"detection_method":"yolo"}

Passo 4: Integre no seu sistema

Exemplo completo em JavaScript/Node.js. O parâmetro vehicleDetails controla se você quer apenas a placa ou também os dados do veículo:

constFormData=require("form-data");const fs =require("fs");asyncfunctionlerPlaca(imagePath, vehicleDetails =false){const form =newFormData(); form.append("image", fs.createReadStream(imagePath));const url = vehicleDetails
?"https://api.simplesapi.com.br/v1/ocr/plate?vehicle_details=true":"https://api.simplesapi.com.br/v1/ocr/plate";const response =awaitfetch(url,{method:"POST",headers:{Authorization:`Bearer ${process.env.SIMPLES_API_KEY}`,},body: form,});const result =await response.json();if(result.plates&& result.plates.length>0){const placa = result.plates[0];console.log(`Placa: ${placa.plate} (confiança: ${placa.confidence})`);if(placa.vehicle_info){console.log(`Veículo: ${placa.vehicle_info.brand}${placa.vehicle_info.model}`);console.log(`Ano: ${placa.vehicle_info.year}/${placa.vehicle_info.model_year}`);console.log(`Cor: ${placa.vehicle_info.color}`);console.log(`Registro: ${placa.vehicle_info.city}/${placa.vehicle_info.state}`);}return placa;}thrownewError("Nenhuma placa detectada na imagem");}// Apenas leitura da placa (R$ 0,05)awaitlerPlaca("foto_veiculo.jpg");// Leitura da placa + dados do veículo (R$ 0,10)awaitlerPlaca("foto_veiculo.jpg",true);

Casos de uso

A leitura automática de placas é utilizada em diversos cenários:

• Estacionamentos: controle automático de entrada e saída de veículos
• Gestão de frotas: identificação de veículos em pontos de controle e garagens
• Pedágio e controle de acesso: leitura automática para cobrança e liberação de cancelas
• Segurança e vigilância: identificação de veículos em tempo real com câmeras
• Locadoras de veículos: automatize check-in e check-out com leitura instantânea
• Logística e entregas: rastreie veículos e confirme chegadas em centros de distribuição

Dicas para melhor resultado

• Use imagens com resolução mínima de 640x480 pixels
• Certifique-se de que a placa está visível e legível na imagem
• Funciona com placas no padrão Mercosul e formato antigo
• Formatos aceitos: JPEG e PNG
• Não é necessário recortar a imagem — a IA localiza a placa automaticamente

Próximos passos

Agora que você sabe como ler placas por imagem, explore outros endpoints da Simples API:

• OCR de CNH: Extraia dados da Carteira Nacional de Habilitação automaticamente
• Dashboard: Acompanhe seu consumo e gerencie seus créditos

Consulte a documentação completa para mais detalhes.

FAQ

Quais formatos de placa são reconhecidos? A API reconhece placas no padrão Mercosul (ABC1D23) e no formato antigo (ABC-1234) com alta precisão.

A API detecta múltiplas placas em uma mesma imagem? Sim. O modelo identifica todas as placas presentes na imagem e retorna os dados de cada uma separadamente no array plates.

Quais informações do veículo são retornadas? Além da placa, a API retorna marca, modelo, versão, ano de fabricação, ano modelo, cor, combustível, tipo de veículo, espécie, capacidade de passageiros, cidade e estado de registro.

Preciso recortar a imagem antes de enviar? Não. O modelo de deep learning (YOLO) localiza a placa automaticamente na imagem, mesmo em ângulos e iluminação variados.

Qual o tempo de resposta da consulta? O tempo médio de resposta é inferior a 200ms.

Quanto custa cada consulta? A leitura da placa custa R$ 0,05 por placa identificada. Se você precisar dos dados do veículo, o custo é de R$ 0,10 por placa. Ao criar sua conta, você recebe R$ 50 em créditos gratuitos.

As imagens são armazenadas? Não. As imagens são processadas em memória e descartadas imediatamente. A Simples API é LGPD compliant.