Skip to main content
O Routing calcula um preview de rota sobre uma sequência de Points: polyline, distância e duração. O resultado serve para visualizar o traçado e estimar distância/tempo antes de cadastrar rotas ou planejar paradas.
Routing não grava distanceKm/estimatedDuration em uma Route. Esses valores continuam sendo informados pela cooperativa ou pela operação autorizada no cadastro da rota; o preview é apenas uma ferramenta de apoio.

Entrada

Validações

Os Points são carregados e reordenados conforme a ordem de entrada.

Segmentos e status

O preview percorre pares consecutivos de Points e monta segmentos:
  • ROUTED — para um trecho contínuo de Points com coordenadas, devolve polyline, distanceMeters e durationSeconds.
  • GAP — quando um par consecutivo tem algum Point sem coordenadas, registra um buraco com missingPointIds e reason: MISSING_COORDINATES.
O status geral é derivado dos segmentos:

Saída (RoutePreview)

Capacidades

Ambas recebem pointIds e vehicleType.
O preview usa roteamento com tráfego e polyline codificada. O mesmo fluxo de mapas atende a busca de Places.