PROC.ENG.SIS.881/2025 - Como visualizar pontos bloqueados no mapa online?

No sistema Triyax, pontos bloqueados são registros de localização recebidos pelo servidor fora de ordem cronológica devido a problemas de comunicação, sobrecarga de dados ou configuração inadequada do equipamento. Esses pontos são temporariamente armazenados em um buffer e processados posteriormente. A melhoria implementada permite que esses pontos bloqueados sejam visualizados no mapa online, proporcionando uma visão mais completa e atualizada da operação 

Este procedimento abordará três etapas principais:

• Configuração no Servidor do Equipamento: Como ajustar os parâmetros que definem o comportamento do buffer e a forma como os dados são armazenados e processados.
• Configuração no Sistema Gestor: Como habilitar a visualização dos pontos bloqueados através do sistema Gestor.
• Utilização da Funcionalidade no Mapa Online: Como visualizar e interpretar os pontos bloqueados na árvore de veículos e mapa online, incluindo como acessar informações específicas de cada ponto.

        IMPORTANTE:

Vale ressaltar que essa melhoria, a principio, está disponível apenas para equipamentos da Jmak e BWS, uma vez que eles não apresentam descarregamento de memória interna do tipo "FIFO".

A seguir, você encontrará um passo a passo detalhado para cada uma dessas configurações, garantindo que a funcionalidade seja devidamente utilizada e interpretada.

1. Configuração do Buffer

O comando de configuração do buffer de mensagens serve para ajustar as regras de armazenamento temporário de mensagens que não são processadas imediatamente pelo servidor. Este comando não é enviado diretamente para o módulo, mas sim configurado no servidor, que será responsável por processar e ordenar as mensagens conforme os parâmetros definidos.

       IMPORTANTE:

Atualmente, o comando está disponível apenas para os módulos E3+, da BWS.

Abaixo, são apresentados os parâmetros que devem ser enviados:

Segue as descrições:

• CMD: SERVIDOR

  • Todo comando de configuração do buffer deve iniciar com o parâmetro acima, como é possível visualizar na imagem acima.

• SET_BUFFER_MAX_NUMBER_ALLOWED_SKIP (Ignição Ligada)

  • Define o intervalo máximo permitido entre mensagens sequenciais com ignição ligada.

  • Se o intervalo entre duas mensagens consecutivas exceder o valor configurado, a mensagem será armazenada no buffer.

  • Tipo de dado: Número inteiro (minutos).

• SET_BUFFER_MAX_NUMBER_ALLOWED_SKIP_IGN_OFF (Ignição Desligada)

  • Define o intervalo máximo permitido entre mensagens sequenciais com ignição desligada.

  • Se o intervalo entre duas mensagens consecutivas exceder o valor configurado, a mensagem será armazenada no buffer.

  • Tipo de dado: Número inteiro (minutos).

• SET_BUFFER_SIZE

  • Determina a capacidade máxima do buffer.

  • Se o limite for atingido (padrão: 5.000 mensagens), todas as mensagens armazenadas serão descarregadas conforme a regra de maxNumberAllowedSkip.

  • Tipo de dado: Número inteiro.

• SET_BUFFER_MAX_TIMES_WITHOUT_INDEX_UPDATE

  • Define o número máximo de mensagens consecutivas que podem ser armazenadas no buffer antes de forçar o descarregamento.

  • Se exceder esse número, o buffer será descarregado imediatamente.

  • Tipo de dado: Número inteiro (Padrão: 20 mensagens).

Para visualizar como foi realizada a última configuração de buffer para o módulo em específico, basta buscar o serial na ferramenta "Analisador de módulos", para visualizar o JSON do último ponto processado. Segue um exemplo:

2. Configuração no Gestor

Para que o sistema Triyax possa exibir os pontos bloqueados no mapa online, é necessário configurar a opção correspondente no Sistema Gestor. Esta configuração permite que o usuário visualize dados armazenados no buffer, ou seja, mensagens que foram recebidas pelo servidor, mas ainda não processadas ou consolidadas.

Para isso, entre no sistema Gestor e navegue até o módulo de configurações iniciais  do sistema Triyax seguindo o fluxo “Configurações Triyax > Configurações Iniciais > Selecionar Conta”. 

Dentro das configurações da conta selecionada, localize a opção denominada “Habilitar árvore de veículos com últimos pontos bloqueados (exceto módulos Maxtrack)”. Por padrão, essa configuração estará desativada com o valor “Não”. Altere a configuração para “Sim”.

Essa modificação permitirá que o sistema consulte os pontos armazenados no buffer e exiba essas informações no mapa online.  Após realizar a alteração, certifique-se de salvar as configurações para que a modificação tenha efeito.

Com esta configuração habilitada, o sistema Triyax será capaz de exibir veículos que possuem dados em buffer no mapa online, incluindo informações como localização, status de ignição, velocidade, e data do registro mais recente. Este recurso é especialmente útil para identificar veículos que perderam comunicação momentaneamente e que estão em processo de descarregamento de dados pendentes.

3. Visualização no Mapa Online

Após habilitar a configuração no sistema gestor, a visualização dos veículos no mapa online será impactada de maneira significativa. A principal mudança é que o sistema Triyax passará a considerar os dados armazenados no buffer como fontes válidas de informação, exibindo-os no mapa caso sejam mais recentes do que os dados consolidados. 

Quando um veículo apresenta pontos bloqueados no buffer, o sistema compara o horário do último ponto consolidado com o horário do último ponto armazenado no buffer. Se o ponto do buffer é mais recente, ele é exibido no mapa em substituição ao último ponto consolidado. Caso contrário, o sistema continua exibindo o ponto consolidado mais recente, mantendo o fluxo padrão de funcionamento.

Além disso, os ícones dos veículos na árvore de monitoramento serão atualizados. A cor do ícone do veículo será ajustada de acordo com o status atual do veículo levando em consideração o ponto bloqueado, seguindo o padrão já estabelecido no sistema, que inclui as cores verde, vermelho, amarelo, cinza e preto. 

Ao clicar sobre o ícone de um veículo no mapa, será exibido um balão de informações com dados limitados, considerando que ainda não foram totalmente consolidados. Os parâmetros exibidos são fixos e não podem ser personalizados pelo usuário. Os dados disponíveis são:

• Endereço: Coordenadas do veículo (Latitude e Longitude).

• Data e Hora do Registro: Momento em que o ponto foi recebido.

• Ignição: Indica se o veículo está com o motor ligado ou desligado.

• Velocidade: Velocidade atual registrada pelo veículo.

• RPM: Rpm atual do veículo.

• Bateria: Tensão de alimentação do equipamento.

• Pânico: Status do pânico do equipamento.

Segue um exemplo para visualização.

Atualmente, essa funcionalidade está disponível apenas para os módulos E3+ da BWS e equipamentos da Jmak. Outros dispositivos que utilizam o sistema FIFO para descarregamento de memória interna não são compatíveis com essa funcionalidade.

É importante ressaltar que os pontos exibidos provenientes do buffer são considerados dados não consolidados. Isso significa que podem ser alterados ou removidos após o processamento completo pelo servidor.

Val lembrar que a configuração correta dos parâmetros do buffer no servidor é fundamental para que os dados sejam processados de maneira eficiente e exibidos no mapa quando necessário. 

Por fim, em caso de dúvidas ou dificuldades na utilização dessa funcionalidade, é recomendável que o usuário entre em contato com o suporte técnico da DDMX para obter orientação adequada.