O trajeto de um veículo pode ser decomposto ao longo do eixo de tempo, da seguinte forma (consideramos que há n visitas):
| | | | | T[2], | | |
| Transition | Visit #0 | | | V[2], | | |
| #0 | aka | T[1] | V[1] | ... | V[n-1] | T[n] |
| aka T[0] | V[0] | | | V[n-2],| | |
| | | | | T[n-1] | | |
^ ^ ^ ^ ^ ^ ^ ^
vehicle V[0].start V[0].end V[1]. V[1]. V[n]. V[n]. vehicle
start (arrival) (departure) start end start end end
Observe que fazemos uma diferença entre:
- "eventos pontuais", como o início e o término do veículo e o início e fim de cada visita (também conhecido como chegada e partida). Acontecem em um determinado segundo.
- "intervalos de tempo", como as próprias visitas e a transição entre as visitas. Embora os intervalos às vezes possam ter duração zero, ou seja, começam e terminam no mesmo segundo, eles geralmente têm uma duração positiva.
Invariantes:
- Se houver n visitas, haverá n+1 transições.
- Uma visita é sempre cercada por uma transição antes dela (mesmo índice) e por uma transição depois dela (índice + 1).
- A partida do veículo é sempre seguida pela transição 0.
- O fim do veículo é sempre precedido pela transição #n.
Ao aumentar o zoom, veja o que acontece durante uma Transition
e uma Visit
:
---+-------------------------------------+-----------------------------+-->
| TRANSITION[i] | VISIT[i] |
| | |
| * TRAVEL: the vehicle moves from | PERFORM the visit: |
| VISIT[i-1].departure_location to | |
| VISIT[i].arrival_location, which | * Spend some time: |
| takes a given travel duration | the "visit duration". |
| and distance | |
| | * Load or unload |
| * BREAKS: the driver may have | some quantities from the |
| breaks (e.g. lunch break). | vehicle: the "demand". |
| | |
| * WAIT: the driver/vehicle does | |
| nothing. This can happen for | |
| many reasons, for example when | |
| the vehicle reaches the next | |
| event's destination before the | |
| start of its time window | |
| | |
| * DELAY: *right before* the next | |
| arrival. E.g. the vehicle and/or | |
| driver spends time unloading. | |
| | |
---+-------------------------------------+-----------------------------+-->
^ ^ ^
V[i-1].end V[i].start V[i].end
Por fim, veja como VIAGENS, QUEBRAS, ATRASO e ESPERA podem ser organizadas durante uma transição.
- Eles não se sobrepõem.
- O atraso é exclusivo e precisa ser um período contíguo antes da próxima visita (ou do fim do veículo). Portanto, é suficiente conhecer a duração do atraso para saber os horários de início e término.
- As BREAKS são períodos contíguos e não sobrepostos. A resposta especifica o horário de início e a duração de cada intervalo.
- VIAGENS e ESPERA são "preveníveis": elas podem ser interrompidas várias vezes durante essa transição. Os clientes podem presumir que a viagem acontece "o mais rápido possível" e que "espera" preenche o tempo restante.
Um exemplo (complexo):
TRANSITION[i]
--++-----+-----------------------------------------------------------++-->
|| | | | | | | ||
|| T | B | T | | B | | D ||
|| r | r | r | W | r | W | e ||
|| a | e | a | a | e | a | l ||
|| v | a | v | i | a | i | a ||
|| e | k | e | t | k | t | y ||
|| l | | l | | | | ||
|| | | | | | | ||
--++-----------------------------------------------------------------++-->
Representação JSON |
---|
{ "vehicleIndex": integer, "vehicleLabel": string, "vehicleStartTime": string, "vehicleEndTime": string, "visits": [ { object ( |
Campos | |
---|---|
vehicleIndex |
Veículo que realiza o trajeto, identificado pelo índice na origem |
vehicleLabel |
Etiqueta do veículo que faz este trajeto, igual a |
vehicleStartTime |
Horário em que o veículo inicia seu trajeto. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
vehicleEndTime |
Horário em que o veículo termina seu trajeto. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
visits[] |
Sequência ordenada de visitas que representam um trajeto. Visitas [i] é a i-ésima visita no trajeto. Se este campo estiver vazio, o veículo será considerado não utilizado. |
transitions[] |
Lista ordenada de transições para a rota. |
hasTrafficInfeasibilities |
Quando
A chegada em next_visit provavelmente acontecerá depois do período atual devido à estimativa elevada do tempo de viagem |
routePolyline |
A representação de polilinha codificada do trajeto. Esse campo só será preenchido se |
breaks[] |
Pausas programadas para o veículo que está executando este trajeto. A sequência |
metrics |
Métricas de duração, distância e carregamento para este trajeto. Os campos de |
routeCosts |
Custo do trajeto detalhado por campos de solicitação relacionados ao custo. As chaves são caminhos proto em relação à entrada OptimizeToursRequest, por exemplo, "model.shipments.pickups.cost", e os valores são o custo total gerado pelo campo de custo correspondente, agregado em todo o trajeto. Em outras palavras, os custos["model.shipments.pickups.cost"] são a soma de todos os custos de embarque no trajeto. Todos os custos definidos no modelo são informados em detalhes aqui, com exceção dos custos relacionados a TransitionAttributes que só são informados de forma agregada a partir de 2022/01. Um objeto com uma lista de pares |
routeTotalCost |
Custo total do trajeto. A soma de todos os custos no mapa de custos. |
Acessar
Uma visita realizada durante um trajeto. Essa visita corresponde à retirada ou entrega de um Shipment
.
Representação JSON |
---|
{
"shipmentIndex": integer,
"isPickup": boolean,
"visitRequestIndex": integer,
"startTime": string,
"loadDemands": {
string: {
object ( |
Campos | |
---|---|
shipmentIndex |
Índice do campo |
isPickup |
Se verdadeiro, a visita corresponde ao embarque de um |
visitRequestIndex |
Índice de |
startTime |
Horário em que a visita começa. O veículo pode chegar antes desse horário no local da visita. Os horários são consistentes com o Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
loadDemands |
Demanda total de carga da visita como a soma do frete e da solicitação de visita Um objeto com uma lista de pares |
detour |
Tempo de desvio extra devido às encomendas visitadas no trajeto antes da visita e ao tempo de espera em potencial induzido pelas janelas de tempo. Se a visita for uma entrega, o desvio será calculado a partir da visita de retirada correspondente e será igual a:
Caso contrário, ele será calculado a partir do
Uma duração em segundos com até nove dígitos fracionários, terminando em " |
shipmentLabel |
Cópia do |
visitLabel |
Cópia do |
Transição
Transição entre dois eventos no trajeto. Veja a descrição de ShipmentRoute
.
Se o veículo não tiver um startLocation
e/ou endLocation
, as métricas de viagem correspondentes serão 0.
Representação JSON |
---|
{ "travelDuration": string, "travelDistanceMeters": number, "trafficInfoUnavailable": boolean, "delayDuration": string, "breakDuration": string, "waitDuration": string, "totalDuration": string, "startTime": string, "routePolyline": { object ( |
Campos | |
---|---|
travelDuration |
Duração da viagem durante essa transição. Uma duração em segundos com até nove dígitos fracionários, terminando em " |
travelDistanceMeters |
Distância percorrida durante a transição. |
trafficInfoUnavailable |
Quando o tráfego é solicitado pelo |
delayDuration |
Soma das durações de atraso aplicadas a essa transição. Se for o caso, o atraso começará exatamente Uma duração em segundos com até nove dígitos fracionários, terminando em " |
breakDuration |
Soma da duração das pausas que ocorrem durante essa transição, se houver. Os detalhes sobre o horário de início e a duração de cada intervalo são armazenados em Uma duração em segundos com até nove dígitos fracionários, terminando em " |
waitDuration |
Tempo gasto esperando durante a transição. A duração da espera corresponde ao tempo de inatividade e não inclui o intervalo. Além disso, esse tempo de espera pode ser dividido em vários intervalos não contíguos. Uma duração em segundos com até nove dígitos fracionários, terminando em " |
totalDuration |
Duração total da transição, fornecida por conveniência. Ele é igual a:
Uma duração em segundos com até nove dígitos fracionários, terminando em " |
startTime |
Horário de início dessa transição. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
routePolyline |
A representação de polilinha codificada do trajeto seguido durante a transição. Esse campo só será preenchido se |
vehicleLoads |
Cargas de veículos durante essa transição, para cada tipo que aparece no As cargas durante a primeira transição são as cargas iniciais do trajeto do veículo. Após cada visita, os Um objeto com uma lista de pares |
EncodedPolyline
A representação codificada de uma polilinha. Mais informações sobre codificação de polilinhas podem ser encontradas aqui: https://developers.google.com/maps/documentation/utilities/polylinealgorithm https://developers.google.com/maps/documentation/javascript/reference/geometry#encoding.
Representação JSON |
---|
{ "points": string } |
Campos | |
---|---|
points |
String que representa pontos codificados da polilinha. |
Intervalo
Dados que representam a execução de uma pausa.
Representação JSON |
---|
{ "startTime": string, "duration": string } |
Campos | |
---|---|
startTime |
Horário de início de uma pausa. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
duration |
Duração de uma pausa. Uma duração em segundos com até nove dígitos fracionários, terminando em " |