Mapa de Rastreamento e Marcadores de Motorista

Ao abrir a tela de Rastreio, o mapa mostra um marcador para cada motorista vinculado que tenha alguma posição de localização registrada — motoristas sem posição não aparecem no mapa, mas continuam disponíveis no campo de busca. A cor e o ícone do marcador variam conforme o status atual do motorista, com o rótulo (apelido, ou o primeiro nome quando não há apelido cadastrado) impresso ao lado. Ao passar o mouse sobre um marcador, um balão exibe: nome e apelido do motorista, situação atual, documento formatado, telefone formatado (ou “Não definido”), placa do veículo, carga e número de entrega mais recentes (com o complemento “mais recente” quando não há carga em aberto no momento) e a data/hora da última atualização de posição. Clicar no marcador abre o cartão de informações desse motorista.

Filtro por Status de Entrega (abas)

A tela oferece oito abas de filtro acima do mapa: Todos, Nenhuma entrega, Aguardando, A caminho, Entregando, Finalizado, Não entregue e Cancelado. Selecionar uma aba mantém visíveis apenas os marcadores de motoristas cujo status atual corresponda ao filtro (a aba “Todos” reexibe todos com posição registrada); os demais marcadores são apenas ocultados, não removidos. Trocar de aba também reseta a seleção do campo de busca de motorista para “Todos”, desativa o acompanhamento em tempo real se estivesse ativo e fecha o cartão de informações de motorista que estivesse aberto.

Seleção e Acompanhamento em Tempo Real de um Motorista Específico

Como alternativa aos filtros por status, um campo de busca permite selecionar um motorista específico entre os vinculados à transportadora. Ao selecionar um motorista com posição registrada, a tela abre o cartão de informações dele e centraliza/aproxima o mapa na sua posição atual; ao selecionar um motorista sem posição registrada, o cartão de informações também é aberto, mas a tela avisa que não há posição registrada para ele. Selecionar novamente a opção “Todos” desativa o acompanhamento em tempo real, fecha o cartão de informações e recentraliza o mapa na posição inicial.

Junto ao campo de busca, uma chave “Monitorar motorista” só produz efeito quando um motorista específico está selecionado — ativá-la com “Todos” selecionado a desliga automaticamente. Quando ativa, o mapa acompanha continuamente a posição do motorista monitorado a cada atualização.

Cartão de Informações do Motorista

Ao abrir o cartão de um motorista (pelo clique no marcador ou pela seleção no campo de busca), a tela exibe: foto de perfil (ou uma imagem padrão quando não há foto cadastrada), nome, apelido, documento e telefone formatados, situação atual, veículo, carga, peso total e número de entrega mais recentes, contadores de entregas em aberto e finalizadas (com o total combinado dos dois), data de cadastro do motorista e data da última atualização de posição. Sempre que não há nenhuma entrega em aberto no momento, os rótulos de veículo, carga e número de entrega recebem o complemento “mais recente”, indicando que os dados mostrados são da última execução concluída, não de uma execução em andamento. O cartão traz dois atalhos: um leva à tela Entregas já filtrada pelo documento e pela carga desse motorista; o outro abre o mapa detalhado da rota executada por ele (ou avisa que não há posição registrada, quando for o caso).

Tour Guiado da Tela Rastreio

A tela conta com um botão TOUR que destaca em sequência as principais áreas (seção, tutorial, abas de status, mapa e campo de busca de motorista) e um atalho “ABRIR TUTORIAL” que abre, em nova aba, a página correspondente do manual em PDF do Painel.

Mapa Detalhado da Rota de um Motorista

Ao acionar o atalho de rota a partir do cartão de informações, a tela busca as entregas e as posições de GPS da execução mais recente do motorista e abre um mapa dedicado, em tela cheia, com: um marcador de início da rota, um marcador da última posição do motorista (ícone de caminhão), um marcador para cada entrega (colorido pelo status, numerado na sequência de execução quando há mais de uma entrega na rota) e uma linha ligando as posições de GPS registradas ao longo do trajeto. No topo do mapa, a tela exibe nome/apelido do motorista, placa do veículo, carga, peso total das entregas da rota e a distância total percorrida.

Um painel lateral lista as informações da rota em duas abas:

• Entregas — uma linha por entrega, com número do documento, data de embarque, situação, sequência prevista, sequência de entrega (regra descrita em Regras de Negócio), cliente, endereço, peso, quantidade de itens e os horários de início, pausa, reinício e fim da entrega.
• Regiões de maior permanência — pontos onde o motorista permaneceu parado por mais tempo que o limite configurado, dentro de um raio de agrupamento configurável (regra descrita em Geolocalização e Rastreamento), cada um com centro, início, fim e tempo total de permanência.

Clicar em qualquer entrega ou região da lista centraliza e aproxima o mapa na coordenada correspondente. Dois botões flutuantes recentralizam o mapa na posição de início da rota ou na última posição do motorista. Enquanto a rota está sendo carregada, o botão de fechar o mapa fica desabilitado.

Cálculo do status atual do motorista

O status atual exibido para cada motorista na tela Rastreio é calculado assim:

• O sistema busca a entrega mais recente do motorista entre os status aguardando, a caminho, finalizada, não entregue e cancelada — priorizando entregas que ainda não têm data de início registrada e, entre as demais, a mais recentemente iniciada.
• Se essa busca encontra uma entrega:
• Se não há nenhuma entrega em aberto (aguardando ou a caminho) para a mesma carga do motorista: o status é “Nenhuma entrega” — indica que a carga mais recente já foi totalmente concluída.
• Caso contrário: se a entrega está “a caminho” e já tem o check-in do motorista registrado, o status é “Entregando”; nos demais casos, o status é o da própria entrega encontrada (Aguardando, A caminho, Finalizado, Não entregue ou Cancelado).
• Se essa busca não encontra nenhuma entrega (motorista sem entregas nesses status), o sistema busca a entrega “aguardando” mais recente do motorista. Encontrando-a, o status é “Aguardando”, sem nenhum número de entrega associado.
• Se nem essa segunda busca encontra nada, o status é “Nenhuma entrega” e todos os totais (entregas abertas, entregas fechadas, peso total) ficam zerados.

O status atual pode assumir sete valores nesta tela: Nenhuma entrega, Aguardando, A caminho, Entregando, Finalizado, Não entregue e Cancelado.

Filtro de tipo de entrega configurado pela transportadora

Quando a transportadora tem configurado um tipo específico de entrega considerado no aplicativo (diferente da opção “ambos”), somente entregas desse tipo entram nas contagens de entregas abertas, entregas fechadas, peso total e na lista de entregas da rota do motorista. Sem essa configuração, ou com ela definida como “ambos”, nenhum filtro de tipo é aplicado.

Contagens de entregas e peso associadas ao motorista

Quando o motorista tem uma entrega em andamento ou concluída recentemente: as entregas “abertas” são as da mesma carga com status aguardando ou a caminho; as “fechadas” são as com status finalizada, não entregue ou cancelada; o peso total soma todas as entregas dessa carga, exceto as desvinculadas. Quando o motorista só tem uma entrega “aguardando” (sem carga ainda formada): as entregas abertas contam todas as dessa combinação exceto as desvinculadas, o total fechado é sempre zero e o peso total soma da mesma forma.

Período e carga considerados na rota

Quando a carga não é informada, o mapa de rota considera apenas entregas recentes (do último dia) que ainda não foram atribuídas a uma carga fechada; informando uma carga específica, somente as entregas dessa carga entram na rota.

Ordenação das entregas na rota e sequência de entrega exibida

As entregas de uma rota são ordenadas com as já concluídas (com data/hora de fim já registrada) primeiro, da conclusão mais antiga para a mais recente, seguidas pelas entregas ainda em aberto, ordenadas pela sequência prevista de entrega. A coluna “sequência de entrega” do painel lateral do mapa de rota reflete essa ordenação: exibe a posição da entrega na lista (contada a partir de 1) quando o status é finalizada, não entregue ou cancelada, ou quando é aguardando com uma pausa de entrega já registrada; nos demais casos, exibe “-“.

Formatos de exibição

• Documento (CPF): exibido como XXX.XXX.XXX-XX.
• Telefone: exibido como +XX (XX) XXXXX-XXXX quando informado; “Não definido” quando ausente.
• CEP: exibido como XXXXX-XXX.
• Endereço: exibido como rua, número – bairro, cidade – UF, CEP, com rua/número/bairro/cidade em minúsculas e a UF em maiúsculas.
• Peso: valores abaixo de 1000 kg são exibidos em quilos com duas casas decimais (ex.: “850,00 kg”); valores a partir de 1000 kg são convertidos para toneladas com duas casas decimais (ex.: “1,25 t”); em ambos os casos o separador decimal exibido é a vírgula.
• Tempo de permanência de uma região de parada: exibido no formato HH:MM:SS.

Um motorista não aparece na tela Rastreio

Cenário: o usuário procura um motorista que sabe existir, mas ele não aparece nem no mapa nem no campo de busca.

Mensagem exibida: Nenhuma — o motorista simplesmente não consta na lista.

O que fazer: confirmar, na tela Motoristas, se o cadastro dele está ativo e se o vínculo com a transportadora está ativo; motoristas inativos ou desvinculados não entram na tela Rastreio.

Motorista aparece no campo de busca, mas não tem marcador no mapa

Cenário: o usuário seleciona um motorista pelo campo de busca e recebe o aviso de posição não registrada.

Mensagem exibida: “Não foi registrado a posição deste motorista.”

O que fazer: aguardar o motorista iniciar sua rota no aplicativo (a posição só é registrada a partir daí); não há ação manual para forçar o registro de posição pelo Painel.

Erro ao carregar as posições dos motoristas

Cenário: ao abrir ou atualizar automaticamente a tela Rastreio, a requisição falha.

Mensagem exibida: “Não foi possível obter as localizações dos motoristas.”

O que fazer: verificar a conexão com a internet e tentar recarregar a tela; se persistir, contatar o suporte.

Sessão expira durante o uso da tela Rastreio

Cenário: a sessão do usuário no Painel expira enquanto a tela Rastreio está aberta (inclusive durante uma atualização automática em segundo plano).

Mensagem exibida: “Desculpe, sua sessão expirou.”

O que fazer: realizar login novamente; o sistema encerra a sessão automaticamente alguns segundos após o aviso.

Erro ao abrir a rota de um motorista

Cenário: o usuário aciona o atalho de rota a partir do cartão de informações e a requisição falha.

Mensagem exibida: “Não foi possível obter a rota.”

O que fazer: verificar a conexão com a internet e tentar novamente.

Motorista tem posição registrada, mas nunca teve nenhuma carga ou entrega

Cenário: o usuário abre o mapa de rota de um motorista com posição registrada, mas sem histórico de entregas elegível.

Mensagem exibida: “Nenhuma rota disponível neste momento.”

O que fazer: confirmar, na tela Entregas, se há alguma entrega recente associada a esse motorista.

Mapa de rota abre vazio, sem nenhuma entrega nem aviso

Cenário: o usuário abre a rota de um motorista com posição registrada, mas sem nenhuma entrega elegível dentro dos critérios de busca — no lugar do aviso descrito em T-06, o mapa simplesmente abre sem marcadores de entrega, sem trajeto e sem nenhuma indicação do motivo.

Mensagem exibida: Nenhuma — o mapa abre vazio, com a aba “Entregas (0)” e sem trajeto marcado.

O que fazer: considerar que não há entregas registradas para esse motorista no período elegível; confirmar diretamente na tela Entregas.

Distância total exibida no mapa de rota aparece como “NaN km”

Cenário: o usuário abre o mapa detalhado da rota de qualquer motorista.

Mensagem exibida: Nenhuma — o campo de distância total no topo do mapa mostra “NaN km” em vez de um valor numérico.

O que fazer: desconsiderar o valor de distância total exibido nessa tela; ele não reflete a distância real percorrida pelo motorista.

Usuário é redirecionado para a tela Início ao tentar acessar Rastreio

Cenário: um usuário sem a permissão de área “Rastreio” ativa em seu perfil tenta acessar a tela diretamente pela URL (o item de menu não aparece para ele).

Mensagem exibida: Nenhuma — o usuário é enviado automaticamente para a tela Início, sem nenhum aviso do motivo.

O que fazer: solicitar a um administrador da conta a ativação da permissão “Rastreio” no perfil do usuário.

Mapa de Rastreio abre centralizado de forma inesperada na primeira utilização

Cenário: ao abrir a tela Rastreio pela primeira vez num navegador, o mapa não centraliza corretamente na região da transportadora.

Mensagem exibida: Nenhuma — o mapa apenas abre com o centro e o zoom padrão, sem nenhum aviso de falha na localização automática.

O que fazer: usar os filtros e o campo de busca de motorista para navegar até a região desejada; uma vez obtida com sucesso, a localização fica guardada nesse navegador e é reaproveitada nas próximas aberturas para o mesmo endereço de transportadora.

Caso 1 — Acompanhamento geral da frota em tempo real

Um gestor abre a tela Rastreio pela manhã para ver a situação de todos os motoristas da transportadora. Com o filtro “Todos” selecionado, o mapa mostra todos os motoristas com posição registrada, coloridos por status: alguns ainda “Aguardando” o início da rota, outros “A caminho” das primeiras entregas. A cada 30 segundos, as posições e status se atualizam sozinhos, sem que o gestor precise recarregar a tela.

Caso 2 — Monitorando um motorista específico durante a execução

O gestor quer acompanhar de perto um motorista que está atrasando uma entrega. Ele seleciona o motorista pelo campo de busca, o mapa centraliza na posição atual dele e o cartão de informações mostra a carga e a entrega em execução. Ativando a chave “Monitorar motorista”, o mapa passa a seguir a posição dele automaticamente a cada atualização, sem precisar recentralizar manualmente.

Caso 3 — Consultando a rota concluída e identificando uma parada longa

Após o motorista finalizar a carga do dia, o gestor abre o cartão dele e aciona o atalho de rota. O mapa detalhado mostra o trajeto completo percorrido, as 8 entregas realizadas numeradas na ordem de execução e a distância total (sujeita à limitação descrita em T-08). Na aba “Regiões de maior permanência”, o gestor identifica uma parada de 45 minutos num mesmo local durante a tarde, fora dos pontos de entrega esperados.

Caso 4 — Filtrando por status para identificar quem já encerrou o dia

No fim da tarde, o gestor usa a aba “Finalizado” para ver rapidamente, sem precisar abrir cada motorista individualmente, quais já concluíram toda a carga do dia — só os marcadores desses motoristas permanecem visíveis no mapa, os demais ficam ocultos até o gestor voltar para o filtro “Todos”.