VehicleJourneySegment

Representa o segmento de viagem de um veículo, da parada anterior até a parada atual. Se for a primeira parada ativa, ele vai do local atual do veículo até essa parada.

Representação JSON
{
  "stop": {
    object (VehicleStop)
  },
  "drivingDistanceMeters": integer,
  "drivingDuration": string,
  "path": [
    {
      object (LatLng)
    }
  ]
}
Campos
stop

object (VehicleStop)

Especifica o local da parada, além dos Tasks associados a ela. Alguns campos do VehicleStop podem não estar presentes se esse trecho da viagem fizer parte de JourneySharingInfo.

drivingDistanceMeters

integer

Apenas saída. A distância de viagem da parada anterior até esta parada. Se a parada atual for a primeira parada na lista de trechos da viagem, o ponto de partida será o local do veículo registrado no momento em que a parada foi adicionada à lista. Talvez este campo não esteja presente se o trecho da jornada fizer parte de JourneySharingInfo.

drivingDuration

string (Duration format)

Apenas saída. O tempo de viagem da parada anterior até essa parada. Se a parada atual for a primeira na lista de trechos da viagem, o ponto de partida vai ser o local do veículo registrado no momento em que a parada foi adicionada à lista.

Se esse campo for definido no caminho Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) ou Task.remainingVehicleJourneySegments[0].drivingDuration (REST), ele poderá ser preenchido com o valor de DeliveryVehicle.remaining_duration (gRPC) ou DeliveryVehicle.remainingDuration (REST). Essa métrica informa o tempo restante de condução do local mais recente conhecido do app do motorista em vez do tempo de percurso da parada anterior.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

path[]

object (LatLng)

Apenas saída. O caminho da parada anterior até esta parada. Se a parada atual for a primeira parada na lista de trechos da viagem, esse vai ser o caminho entre a localização atual do veículo e essa parada no momento em que ela foi adicionada à lista. Talvez este campo não esteja presente se o trecho da jornada fizer parte de JourneySharingInfo.

Se esse campo for definido no caminho Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST), ele poderá ser preenchido com os LatLngs decodificados de DeliveryVehicle.current_route_segment (gRPC) ou DeliveryVehicle.currentRouteSegment (REST). Isso fornece o caminho de carro do local mais recente conhecido do app do motorista em vez do caminho da parada anterior.

VehicleStop

Descreve um ponto em que um veículo para para executar um ou mais Tasks.

Representação JSON
{
  "plannedLocation": {
    object (LocationInfo)
  },
  "tasks": [
    {
      object (TaskInfo)
    }
  ],
  "state": enum (State)
}
Campos
plannedLocation

object (LocationInfo)

Obrigatório. O local da parada. Os locais nos Tasks podem não corresponder exatamente a esse local, mas estão a uma curta distância dele. Esse campo não será preenchido na resposta de uma chamada tasks.get ou tasks.search.

tasks[]

object (TaskInfo)

A lista de Tasks a serem realizadas nessa parada. Esse campo não será preenchido na resposta de uma chamada tasks.get ou tasks.search.

state

enum (State)

O estado da VehicleStop. Esse campo não será preenchido na resposta de uma chamada tasks.get ou tasks.search.

TaskInfo

Informações adicionais sobre a tarefa realizada nessa parada.

Representação JSON
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
Campos
taskId

string

O ID da tarefa. Esse campo não será preenchido na resposta de uma chamada tasks.get ou tasks.search. Os IDs de tarefas estão sujeitos às seguintes restrições:

  • Precisa ser uma string Unicode válida.
  • Limitado a um tamanho máximo de 64 caracteres.
  • Normalizado de acordo com o Formulário C de normalização Unicode.
  • Não pode conter os seguintes caracteres ASCII: "/", ':', '?', ", ou '#'.
taskDuration

string (Duration format)

Apenas saída. O tempo necessário para executar a Tarefa.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

targetTimeWindow

object (TimeWindow)

Apenas saída. A janela de tempo em que a tarefa deve ser concluída. Isso é definido apenas na resposta a deliveryVehicles.get.

Estado

O estado atual de uma VehicleStop.

Enums
STATE_UNSPECIFIED Desconhecido.
NEW Criada, mas não roteando ativamente.
ENROUTE Atribuído e fazendo o roteamento ativo.
ARRIVED Chegou à parada. Pressupõe que, quando o veículo está se deslocando para a próxima parada, todas as paradas anteriores foram concluídas.