1) Objetivo
O roteirizador cria rotas otimizadas para ida e volta entre residências dos colaboradores e o depósito (operação), respeitando capacidade do modal, janelas de horário e regras de multi ciclo com encaixe de modais.
2) Bases necessárias
- Pessoas (CSV/Excel): deve conter latitude, longitude e preferencialmente nome. Colunas típicas (não obrigatório usar os mesmos nomes): Nome, Latitude, Longitude, Tipo (FIXO | PART TIME), Ciclo (AM1 | AM2/PM | SD).
- Operações (CSV/Excel): deve conter latitude, longitude e Código Operação. A coluna do código é detectada automaticamente ou selecionável.
3) Parâmetros principais
- Tipo de operação: somente ida (coleta → depósito) ou ida e volta (depósito ↔ casas).
- Velocidade média fallback: usada apenas quando o motor de vias reais não estiver disponível.
- Máx. horas por roteiro (ida e volta): o sistema divide rotas se a soma operacional ida + volta exceder este limite.
- Catálogo de veículos: capacidade (lugares), custo fixo mensal (base) e custo por km (R$).
4) Multi ciclo & encaixe
- Habilite multi ciclo para combinar AM1, AM2/PM e SD quando houver encaixe.
- Regra do encaixe: a entrada do ciclo posterior deve ser 30 min antes da saída do ciclo anterior (AM1→PM, PM→SD, AM1→SD).
- Quando o encaixe existir, os campos de saída do ciclo anterior e entrada do ciclo posterior ficam com fundo verde.
- Sem horário (entrada/saída = 00:00) ⇒ colaborador não é roteirizado.
- PART TIME com horário diferente do FIXO em qualquer ciclo ⇒ cria rotas exclusivas para PART TIME nesse ciclo.
5) Cálculo de custo (resumo)
Por rota, escolhe-se o modal com menor custo final respeitando a capacidade.
- Variável:
custo_por_km × km_dia × dias_úteis
- Fixo (padrão): multiplicador depende do filtro/combinação e se há encaixe.
- AM1 + SD:
- Com encaixe:
(variável + (fixo_modal × 1 × (1 + acréscimo%))) / total_pessoas
- Sem encaixe:
(variável + (fixo_modal × 2)) / total_pessoas
- Para demais combinações, aplica-se o multiplicador de fixo conforme o encaixe e acréscimos definidos.
- Preço final: aplica margem (%) e impostos (%).
6) Lógica de tempo por pessoa
- Ida: tempo do ponto de coleta do colaborador até o depósito seguindo a ordem da rota (primeiros têm maior tempo).
- Volta: tempo do depósito até a residência do colaborador seguindo a ordem da volta.
- Relato: no gráfico Top 10, ao clicar em uma barra, a pessoa é destacada nos mapas, e o tooltip mostra o tempo específico do mapa: ida no mapa de ida e volta no mapa de volta.
7) Pontos de encontro (opcional)
- Informe raios (m) para ida e/ou volta. O sistema busca um ponto que cubra o maior número de pessoas e reencaminha as coordenadas dos cobertos para este ponto.
- Comparativo COM × SEM ponto de encontro é mostrado com km, tempo e custo.
8) Exportação
Clique em Exportar Excel para salvar os indicadores principais do cenário atual.
🛈 Caso deseje consultar as Lat e Lon no Google Maps, basta copiá-las da planilha e colá-las no campo de busca.
9) Boas práticas
- Garanta coordenadas válidas nas bases (latitude/longitude).
- Use a seleção múltipla de operações quando fizer sentido (e o recurso de reatribuição para depósito mais próximo, se habilitado).
- Use o Motor de distância/tempo em “Vias reais — OSRM/OpenStreetMap” para calcular distâncias pela malha viária real. O modo considera ruas, avenidas, estradas, sentidos de via e velocidades médias estimadas do grafo OSM.
- Para operação oficial em escala, use endpoint OSRM interno/contratado. O endpoint público é adequado para protótipo, mas pode ter limite, latência ou bloqueio corporativo.
- Revise a velocidade média apenas como fallback, quando o roteamento por vias reais não estiver disponível.