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 R$ 0,05 por placa identificada quando só precisa da leitura, e R$ 0,15 por placa quando também pede os dados do veículo e a placa é consultada, com ou sem dados retornados. Se nenhuma placa for lida, não há cobrança. 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, PNG ou WebP)

Passo 1: Obtenha sua API Key

Após criar sua conta, acesse o dashboard e copie sua API Key. Você recebe R$ 5 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. A imagem vai em base64 no campo image de um corpo JSON (com ou sem o prefixo data:image/jpeg;base64,):

curl-X POST "https://api.simplesapi.com.br/v1/ocr/plate"\-H"Authorization: Bearer SUA_API_KEY"\-H"Content-Type: application/json"\-d'{"image": "<imagem_em_base64>"}'

A API retorna as placas detectadas na imagem:

{"plates":[{"plate":"BRA2E19","confidence":0.987,"plate_type":"mercosul","bbox":{"x1":120,"y1":80,"x2":320,"y2":140},"vehicle_info":null}],"detection_method":"yolo"}

Se a imagem contiver mais de uma placa, todas são retornadas no array plates, e cada placa lida custa R$ 0,05. Se nenhuma placa for lida, nada é cobrado.

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

Se você precisa dos dados completos do veículo — marca, modelo, ano, cor e mais — envie também "include_vehicle_info": true:

curl-X POST "https://api.simplesapi.com.br/v1/ocr/plate"\-H"Authorization: Bearer SUA_API_KEY"\-H"Content-Type: application/json"\-d'{"image": "<imagem_em_base64>", "include_vehicle_info": true}'

Os R$ 0,15 (R$ 0,05 da leitura + R$ 0,10 da consulta) valem para toda placa consultada, venham ou não os dados do veículo: placa sem dados vem com "vehicle_info": null e também paga a consulta. Se a confiança da leitura ficar abaixo de 90% (a placa não é consultada) ou a consulta estiver indisponível, a placa vem com "vehicle_info": null e custa só R$ 0,05.

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

{"plates":[{"plate":"BRA2E19","confidence":0.987,"plate_type":"mercosul","bbox":{"x1":120,"y1":80,"x2":320,"y2":140},"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,"engine_cc":2000,"max_traction_capacity":null,"axles":2,"assembly_type":"Completa","gross_weight":null,"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:

const fs =require("fs");asyncfunctionlerPlaca(imagePath, vehicleDetails =false){const image = fs.readFileSync(imagePath).toString("base64");const response =awaitfetch("https://api.simplesapi.com.br/v1/ocr/plate",{method:"POST",headers:{Authorization:`Bearer ${process.env.SIMPLES_API_KEY}`,"Content-Type":"application/json",},body:JSON.stringify({ image,include_vehicle_info: vehicleDetails }),});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 por placa identificada)awaitlerPlaca("foto_veiculo.jpg");// Leitura da placa + dados do veículo (R$ 0,15 por placa consultada, com ou sem dados; R$ 0,05 se não for consultada)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, PNG e WebP
• 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:

• Dados do veículo: Envie include_vehicle_info: true para receber marca, modelo, ano e cor junto com a placa
• Consulta de Veículo por Placa: Já tem a placa? Envie {"plate": "ABC1D23"} para POST /v1/vehicle/plate e receba os dados do veículo sem imagem, por R$ 0,10 por consulta, com ou sem dados retornados
• 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? A maioria das respostas chega em poucos segundos. O tempo depende do tamanho da imagem e, quando você pede os dados do veículo, da base consultada.

Quanto custa cada consulta? A leitura da placa custa R$ 0,05 por placa identificada. Se você pedir os dados do veículo, soma mais R$ 0,10 por placa consultada, com ou sem dados retornados (R$ 0,15 no total). Imagem sem placa lida, placa com confiança abaixo de 90% (não consultada) ou erro não geram cobrança. Ao criar sua conta, você recebe R$ 5 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.