Telemetria de Veiculos
A telemetria fornece dados em tempo real sobre seus veiculos, permitindo monitoramento, analise e gerenciamento eficiente da frota.
Visao Geral
O Que e Telemetria
Telemetria e a coleta automatica de dados de dispositivos IoT instalados nos veiculos:
- Localizacao GPS
- Nivel de bateria
- Status de bloqueio
- Velocidade
- Estado de conexao
Arquitetura
Dispositivo IoT -> Servidor do Fabricante -> Levy Fleets -> Painel
Tipos de Dados
Localizacao
| Dado | Descricao | Frequencia |
|---|---|---|
| Latitude | Coordenada norte/sul | 30s - 5min |
| Longitude | Coordenada leste/oeste | 30s - 5min |
| Precisao | Raio de precisao em metros | Com localizacao |
| Altitude | Altura em metros | Opcional |
Bateria
| Dado | Descricao | Frequencia |
|---|---|---|
| Nivel | Porcentagem de carga | 1 min |
| Voltagem | Tensao da bateria | 1 min |
| Carregando | Se esta conectado | Evento |
Status
| Dado | Descricao | Frequencia |
|---|---|---|
| Bloqueio | Bloqueado/Desbloqueado | Evento |
| Movimento | Parado/Em movimento | Evento |
| Alarme | Alarme ativo | Evento |
| Online | Status de conexao | Continuo |
Velocidade
| Dado | Descricao | Frequencia |
|---|---|---|
| Velocidade atual | km/h | 10s |
| Velocidade maxima | Maior velocidade no periodo | Calculado |
| Distancia | Metros percorridos | Calculado |
Visualizando Telemetria
No Painel
Abrir Veiculo
Navegue ate a pagina de detalhes do veiculo
Aba Telemetria
Clique na aba Telemetria
Ver Dados
Visualize dados atuais e historicos
Elementos da Interface
| Elemento | Descricao |
|---|---|
| Cards de status | Valores atuais em destaque |
| Graficos | Historico ao longo do tempo |
| Mapa | Localizacao e rotas |
| Timeline | Eventos recentes |
Dispositivos IoT Suportados
Fabricantes
| Fabricante | Tipo | Recursos |
|---|---|---|
| Segway | segway | GPS, bateria, bloqueio |
| OKAI | okai | GPS, bateria, bloqueio, alarme |
| Omni | omni | GPS, bateria, bloqueio |
| Teltonika | teltonika | GPS, bateria |
| Personalizado | custom | Configuravel |
Configuracao por Tipo
Cada tipo de IoT tem configuracoes especificas:
// Exemplo de configuracao
{
type: "segway",
commands: ["lock", "unlock", "locate"],
telemetry: ["location", "battery", "speed"],
interval: 60 // segundos
}
Frequencia de Atualizacao
Fatores que Afetam
| Fator | Impacto |
|---|---|
| Tipo de dispositivo | Limites do fabricante |
| Plano de dados | Cobertura e velocidade |
| Bateria | Economia de energia |
| Movimento | Mais frequente em movimento |
Configuracoes Tipicas
| Cenario | Localizacao | Bateria |
|---|---|---|
| Parado | 5 min | 5 min |
| Em movimento | 30s | 1 min |
| Viagem ativa | 10s | 30s |
| Bateria baixa | 10 min | 10 min |
Alertas de Telemetria
Tipos de Alerta
| Alerta | Condicao | Acao |
|---|---|---|
| Bateria baixa | < 20% | Notificacao |
| Bateria critica | < 10% | Veiculo indisponivel |
| Offline | Sem dados > 1h | Notificacao |
| Fora de zona | Veiculo fora da area | Notificacao |
| Velocidade alta | > Limite configurado | Registro |
Configurando Alertas
- Navegue ate Configuracoes > Alertas
- Configure limites para cada tipo
- Escolha metodo de notificacao
- Salve as configuracoes
Historico de Telemetria
Retencao de Dados
| Tipo de Dado | Retencao |
|---|---|
| Localizacao | 90 dias |
| Bateria | 30 dias |
| Eventos | 1 ano |
| Resumos | Indefinido |
Exportando Dados
Selecionar Veiculo
Abra a pagina de detalhes do veiculo
Escolher Periodo
Defina data inicial e final
Exportar
Clique em Exportar Telemetria
Baixar
Baixe o arquivo CSV
Analise de Dados
Metricas Uteis
| Metrica | Calculo | Uso |
|---|---|---|
| Utilizacao | Tempo em uso / Tempo total | Eficiencia |
| Distancia media | Total km / Total viagens | Padrao de uso |
| Ciclos de bateria | Cargas completas | Vida util |
| Tempo offline | Soma de periodos offline | Confiabilidade |
Graficos Disponiveis
- Bateria ao longo do tempo - Historico de carga
- Localizacoes - Mapa de calor de posicoes
- Velocidade - Perfil de velocidade
- Utilizacao - Horas em uso vs parado
Integracao com API
Webhook de Telemetria
Receba dados de telemetria em tempo real:
POST /your-webhook-endpoint
Content-Type: application/json
{
"vehicle_uuid": "...",
"timestamp": "2025-12-25T10:30:00Z",
"data": {
"latitude": 52.5200,
"longitude": 13.4050,
"battery": 85,
"speed": 15.5
}
}
API de Consulta
Consulte telemetria historica:
GET /api/vehicles/{uuid}/telemetry
?start_date=2025-12-01
&end_date=2025-12-25
&type=location,battery
Precisao de GPS
Fatores que Afetam
| Fator | Impacto |
|---|---|
| Ceu aberto | Alta precisao (3-5m) |
| Area urbana | Media precisao (10-20m) |
| Interior | Baixa precisao (50m+) |
| Tunel | Sem sinal |
Indicadores de Qualidade
| Indicador | Significado |
|---|---|
| Verde | Precisao < 10m |
| Amarelo | Precisao 10-50m |
| Vermelho | Precisao > 50m |
| Cinza | Sem dados |
Solucao de Problemas
Telemetria Nao Atualiza
Possiveis causas:
- Dispositivo offline
- Problema de conectividade
- Bateria do IoT descarregada
Solucoes:
- Verifique status do dispositivo
- Aguarde reconexao
- Verifique fisicamente o veiculo
Localizacao Incorreta
Possiveis causas:
- GPS com sinal fraco
- Ultima posicao conhecida
- Problema no dispositivo
Solucoes:
- Aguarde nova atualizacao
- Verifique precisao reportada
- Mova veiculo para area aberta
Bateria Mostra 0%
Possiveis causas:
- Bateria realmente descarregada
- Sensor com defeito
- Dados desatualizados
Solucoes:
- Verifique fisicamente
- Carregue o veiculo
- Reinicie o dispositivo IoT
Dispositivo Offline
Possiveis causas:
- Sem cobertura de rede
- Cartao SIM com problema
- Dispositivo desligado
Solucoes:
- Verifique cobertura da area
- Contate fabricante do IoT
- Substitua cartao SIM
Melhores Praticas
Monitoramento
- Verifique diariamente - Identifique problemas cedo
- Configure alertas - Seja notificado automaticamente
- Analise tendencias - Previna problemas
Manutencao
- Atualize firmware - Mantenha dispositivos atualizados
- Limpe sensores - GPS precisa de visao do ceu
- Verifique conexoes - Cabos e antenas
Seguranca
- Monitore anomalias - Comportamento incomum
- Rastreie offline - Pode indicar roubo
- Use geocercas - Alerte saidas de zona
Proximos Passos
- Gerenciando Veiculos - Gerenciamento completo
- Solucao de Problemas IoT - Resolver problemas
- Alertas - Configurar notificacoes
Telemetria Ativa
Com telemetria funcionando corretamente, voce tem visibilidade completa da sua frota em tempo real, permitindo operacoes eficientes e resposta rapida a problemas.