Configuração de Zonas de Limite de Velocidade

As zonas de limite de velocidade permitem restringir automaticamente a velocidade do veículo em áreas designadas. Quando um veículo entra em uma zona de velocidade durante uma viagem ativa, o sistema envia comandos IoT ao veículo para limitar sua velocidade máxima. Quando o veículo sai da zona, a velocidade é restaurada ao normal.

Principais Recursos

Casos de Uso Comuns

Hierarquia de Limite de Velocidade

Entender como os limites de velocidade são determinados é crucial para a configuração adequada. O Levy Fleets usa uma hierarquia de configurações.

A Fórmula do Limite de Velocidade

Velocidade Efetiva = min(
  Limite de Velocidade da Zona,           // Da zona speed_limit
  Limite de Zona de Velocidade Lenta,     // Das configurações da subconta
  Velocidade Máxima do Modelo do Veículo  // Da tabela vehicle_models
)

O sistema sempre aplica o limite mais baixo aplicável para garantir a segurança.

Ordem de Prioridade

1. Limite de velocidade específico da zona - O valor speed_limit_kph definido na zona
2. Limite de velocidade lenta da subconta - A configuração slow_speed_zone_limit_kph (padrão: 10 km/h)
3. Máximo do modelo do veículo - O max_speed_kmh do modelo do veículo

Exemplos de Cenários

Criando Zonas de Limite de Velocidade

Diretrizes de Limite de Velocidade

Faixa de Velocidade Válida

• Mínimo: 1 km/h
• Máximo: 80 km/h (restrição do banco de dados)
• Recomendado: 5-20 km/h para a maioria das zonas de segurança

Configurações de Velocidade da Subconta

Cada subconta tem um limite global de zona de velocidade lenta que age como um teto para todas as zonas de velocidade.

Acessando a Configuração

1. Vá para Painel -> Configurações
2. Navegue até a seção Veículos
3. Encontre Limite de Zona de Velocidade Lenta

Comportamento

Esta configuração define:

• A velocidade máxima que qualquer zona de velocidade pode aplicar
• A velocidade padrão quando uma zona não tem um limite específico definido
• Um limite de segurança global para toda a sua frota naquele local

Recomendações

Configurações de Velocidade do Modelo do Veículo

Cada modelo de veículo pode ter uma velocidade máxima configurada, que é usada ao restaurar a velocidade após sair das zonas.

Configuração

A velocidade do modelo do veículo é definida na seção Modelos de Veículos:

1. Navegue até Painel -> Modelos de Veículos
2. Selecione um modelo
3. Defina o campo Velocidade Máxima (km/h)

Comportamento de Fallback

Se um veículo não tem um modelo atribuído ou o modelo não tem velocidade máxima:

1. Verifica o próprio campo max_speed_kmh do veículo
2. Recorre ao padrão do sistema: 25 km/h

Por Que Isso Importa

Quando um veículo sai de uma zona de velocidade, o sistema precisa saber qual velocidade restaurar. O comando de restauração usa:

Velocidade Restaurada = vehicle_model.max_speed_kmh OU vehicle.max_speed_kmh OU 25 km/h

Como a Aplicação de Velocidade Funciona

Acionamento da Aplicação

A aplicação de velocidade executa em cada atualização de telemetria GPS quando:

1. O veículo está em uma viagem ativa (ride_status = 'in_progress')
2. O veículo tem um IMEI IoT válido
3. Coordenadas GPS válidas são recebidas

Etapas de Aplicação

1. Carregar todas as zonas speed_limit para a subconta do veículo
2. Verificar se a localização do veículo está dentro de qualquer polígono de zona
3. Se estiver em alguma zona(s) de velocidade:
   • Calcular limite efetivo (o mais baixo entre zona + limite da subconta)
   • Se o limite diferir do atual, enviar comando IoT de velocidade
   • Atualizar estado do veículo
   • Registrar evento de entrada na zona
   • Enviar notificação ao cliente
4. Se estava em zona de velocidade, mas não está mais:
   • Enviar comando de restaurar velocidade
   • Limpar estado do veículo
   • Registrar evento de saída da zona
   • Enviar notificação ao cliente

Deduplicação de Comandos

Para evitar tráfego IoT desnecessário:

• Comandos só são enviados quando o limite realmente muda
• O estado atual da zona do veículo é rastreado no banco de dados
• Atualizações repetidas para a mesma zona/limite são ignoradas

Campos de rastreamento do veículo:

• current_speed_limit_zone_id - ID da zona de velocidade ativa
• current_speed_limit_kph - Limite de velocidade atualmente aplicado
• speed_limit_enforced_at - Timestamp da última aplicação

Latência

Latência típica de aplicação:

• Chegada da telemetria: 1-5 segundos (depende do intervalo de relatório do dispositivo)
• Avaliação da zona: < 100ms
• Despacho de comando IoT: 200-500ms
• Resposta do veículo: 1-3 segundos (depende do dispositivo/rede)

Total: 3-10 segundos desde a entrada na zona até a mudança de velocidade

Comandos de Protocolo IoT

Diferentes dispositivos IoT requerem formatos de comando diferentes. O Levy Fleets detecta automaticamente o protocolo e formata os comandos apropriadamente.

Protocolos Suportados

Detecção de Protocolo

O sistema determina o protocolo consultando o tipo de dispositivo IoT. O protocolo é determinado pelos campos iot_type ou iot_model (correspondência sem distinção de maiúsculas/minúsculas).

Restauração de Velocidade

Quando um veículo sai de todas as zonas de velocidade, o sistema restaura a velocidade operacional normal.

Processo de Restauração

1. Detectar saída da zona - Veículo não está mais em nenhuma zona de velocidade
2. Calcular velocidade alvo do modelo do veículo ou padrão (25 km/h)
3. Enviar comando de restauração - Mesmo formato do comando de limite, com valor mais alto
4. Limpar estado do veículo - Remover campos de rastreamento de zona
5. Registrar evento de saída
6. Enviar notificação:

   Título: "Zona lenta liberada"
   Corpo: "Você saiu da {nome_da_zona}. Sua velocidade máxima foi restaurada."
   

Tempo de Restauração

A velocidade é restaurada:

• Imediatamente após a primeira leitura GPS fora de todas as zonas de velocidade
• Sem atraso de histerese (diferente das zonas proibidas)
• Comando enviado independentemente da duração na zona

Zonas de Velocidade Sobrepostas

Quando um veículo está dentro de múltiplas zonas de velocidade simultaneamente, regras especiais se aplicam.

Comportamento

1. Encontrar todas as zonas aplicáveis que contêm o veículo
2. Calcular limite efetivo para cada zona (limite da zona ou limite da subconta, o que for menor)
3. Aplicar o limite mais baixo entre todas as zonas sobrepostas

Exemplo

Veículo entra em uma área com:

• Zona A: limite de 15 km/h
• Zona B: limite de 8 km/h
• Limite da subconta: 10 km/h

Avaliação:

• Zona A efetiva: min(15, 10) = 10 km/h
• Zona B efetiva: min(8, 10) = 8 km/h
• Limite aplicado: 8 km/h (mais baixo)

Rastreamento de Zona

Apenas a zona "ativa" (aquela com o limite mais baixo) é rastreada no estado do veículo.

Comportamento de Transição

Ao mover entre zonas sobrepostas:

• Novo comando de limite só é enviado se o limite efetivo mudar
• Transições com mesmo limite são deduplicadas (sem tráfego IoT)
• Evento de saída registrado para a zona anterior, evento de entrada para a nova zona

Melhores Práticas

Design de Zonas

1. Dimensione apropriadamente

   • Mínimo: 20-30 metros de diâmetro (buffer de precisão GPS)
   • Máximo: Prático para a área (quarteirão, não cidade inteira)

2. Polígonos simples

   • Use menos vértices (5-8 tipicamente suficientes)
   • Evite formas complexas com muitas seções côncavas
   • Formas mais simples = avaliação mais rápida

3. Limites claros

   • Alinhe com recursos físicos (ruas, edifícios)
   • Use visão de satélite para precisão
   • Adicione buffer de 5-10m para variação do GPS

4. Posicionamento estratégico

   • Foque em áreas de alto fluxo de pedestres
   • Cubra zonas inteiras, não apenas pontos quentes
   • Considere pontos de entrada/saída

Seleção de Velocidade

1. Combine com o ambiente

   • Apenas pedestres: 5-8 km/h
   • Pedestres/veículos mistos: 10-12 km/h
   • Tráfego leve: 12-15 km/h

2. Considere a experiência do cliente

   • Muito lento = clientes frustrados
   • Muito rápido = preocupações de segurança
   • Teste limites em condições reais

3. Conformidade regulatória

   • Verifique regulamentações locais para velocidades de patinetes elétricos
   • Muitas cidades exigem limites específicos em certas zonas
   • Documente propósitos das zonas para auditorias

Convenções de Nomenclatura

Use nomes descritivos que incluam:

• Identificador de local
• Propósito/tipo
• Limite de velocidade (opcional)

Exemplos:

• "Centro - 10 kph"
• "Zona Escolar Escola Lincoln"
• "Trilha Compartilhada Parque Central"
• "Praça Prefeitura Pedestres"

Testes

Antes de implantar zonas críticas:

1. Crie zona com veículo de teste
2. Passe pelo limite da zona várias vezes
3. Verifique redução de velocidade no veículo
4. Verifique eventos de zona no histórico de viagens
5. Teste saída e restauração de velocidade
6. Confirme que notificações aos clientes funcionam

Monitoramento e Depuração

Visibilidade no Painel

Visualização de Detalhes da Viagem:

• Navegue até Painel -> Viagens -> [selecione viagem]
• Clique na aba "Zonas"
• Veja eventos de entrada/saída de zona com:
  • Nome e tipo da zona
  • Horários de entrada/saída
  • Limites de velocidade aplicados
  • Sucesso/falha do comando IoT

Encontrando Restrições de Velocidade Ativas

No painel, você pode ver quais veículos atualmente têm restrições de velocidade aplicadas verificando a página de detalhes do veículo.

Logs do Servidor

Ative o registro detalhado de zonas verificando os logs do servidor para entradas com:

• Aplicação de zona iniciada/concluída
• Verificações de ponto-no-polígono
• Despacho de comando IoT
• Status de sucesso/erro

Prefixos de log:

• [Zones] - Todos os logs de aplicação de zona
• Indicadores de detecção de zona de velocidade
• Despacho de comando IoT
• Marcadores de Sucesso/Erro

Solução de Problemas

Velocidade Não Limitando

Sintomas: Veículo não desacelera na zona de velocidade

Verificações:

1. Configuração da zona:

   • O tipo da zona é "speed_limit"?
   • O polígono da zona está desenhado corretamente?
   • O speed_limit_kph está definido?
   • A zona não está excluída?

2. Configuração do veículo:

   • O veículo tem um IMEI IoT?
   • O dispositivo IoT está online?
   • O protocolo é suportado (Segway, OKAI, etc.)?

3. Estado da viagem:

   • Há uma viagem ativa neste veículo?
   • O status da viagem é "in_progress"?

4. Variáveis de ambiente:

   • A configuração da API IoT está correta?
   • A URL do proxy IoT está correta?

5. Logs:

   • Verifique logs do servidor para entradas de zona
   • Procure erros de despacho de comando

Velocidade Não Restaurando

Sintomas: Veículo permanece em velocidade baixa após sair da zona

Verificações:

1. Precisão do GPS:

   • O veículo está realmente fora da zona?
   • Verifique as últimas coordenadas conhecidas do veículo
   • Compare com o limite da zona

2. Estado do banco de dados:

   • Verifique current_speed_limit_zone_id - deve ser NULL
   • Se não for NULL, a aplicação ainda pode pensar que o veículo está na zona

3. Comando IoT:

   • O comando de restauração foi enviado?
   • Ele teve sucesso?
   • Verifique eventos de zona da viagem para evento de saída

4. Hardware do veículo:

   • Alguns dispositivos requerem reinício manual após comando
   • Verifique documentação do dispositivo para peculiaridades

Velocidade Errada Aplicada

Sintomas: Limite de velocidade é diferente do configurado

Verificações:

1. Limite de velocidade lenta:

   • Verifique Configurações -> Veículos -> Limite de Zona de Velocidade Lenta
   • Isso limita todos os limites de zona

2. Zonas sobrepostas:

   • O veículo está em múltiplas zonas de velocidade?
   • O limite mais baixo é aplicado

3. Confusão de unidades:

   • Velocidades estão em km/h, não mph
   • 10 km/h é aproximadamente 6 mph

Comandos Não Sendo Enviados

Sintomas: Eventos de zona registrados, mas sem comandos IoT

Verificações:

1. Detecção de protocolo:

   • Verifique tabela de dispositivos IoT para o IMEI
   • Verifique se o tipo IoT é reconhecido

2. Conectividade da API:

   • Teste o proxy IoT manualmente
   • Verifique problemas de firewall

3. Validade do IMEI:

   • Formato de 15 dígitos necessário
   • Deve corresponder ao registro do dispositivo

Perguntas Frequentes

Quão rapidamente o limite de velocidade entra em vigor?

Tipicamente 3-10 segundos após entrar em uma zona, dependendo de:

• Intervalo de relatório GPS do veículo (1-10 segundos)
• Latência de rede
• Tempo de resposta do dispositivo IoT

Posso definir velocidades diferentes para diferentes horários do dia?

Não diretamente através da configuração de zona. Opções atuais:

• Criar múltiplas zonas e ativar/desativar via API
• Ajustar o limite de velocidade lenta da subconta (afeta todas as zonas)
• Futuro: Regras de zona baseadas em tempo estão no roadmap

O que acontece se a comunicação IoT falhar?

• O evento de zona ainda é registrado com iot_command_success = false
• O erro é registrado
• O veículo continua em sua velocidade atual
• Próxima atualização de telemetria tentará o comando novamente
• Considere implementar alertas para comandos com falha

As zonas de velocidade afetam todos os veículos?

Apenas veículos:

• Com uma viagem ativa
• Pertencentes à subconta da zona
• Com um dispositivo IoT compatível

Veículos sem viagens ativas não são afetados.

Os clientes podem ver as zonas de velocidade no aplicativo?

Sim, as zonas de velocidade são visíveis no mapa do cliente:

• Exibidas como zonas de cor amarela/dourada
• Nome da zona mostrado ao tocar
• Limite de velocidade exibido nas informações da zona

Qual é o tamanho mínimo recomendado de zona?

• Mínimo: ~30 metros de diâmetro
• Razão: Variação de precisão do GPS (5-15m)
• Zonas muito pequenas podem causar oscilação

Como desativo uma zona de velocidade temporariamente?

Opções:

1. Excluir a zona - Removê-la completamente (exclusão suave)
2. Mudar tipo de zona - Mudar para "estacionamento" ou outro tipo temporariamente
3. Via banco de dados - Definir deleted_at para o timestamp atual

Os limites de velocidade são aplicados para viagens de teste?

Sim, todas as viagens com status "in_progress" estão sujeitas à aplicação de zona, incluindo viagens de teste iniciadas pela equipe.

O Que Vem a Seguir?

• Criando e Gerenciando Zonas - Guia completo de gerenciamento de zonas
• Como as Zonas Funcionam - Mergulho técnico profundo na aplicação de zonas
• Telemetria de Veículos - Entendendo dados dos veículos