VehicleJourneySegment

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

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

object (VehicleStop)

Especifica o local da parada e as Tasks associadas a ela. Alguns campos do VehicleStop podem não estar presentes se esse trecho da jornada 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 da lista de segmentos da viagem, o ponto de partida será o local do veículo registrado no momento em que essa parada foi adicionada à lista. Este campo pode não estar presente se o segmento 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 segmentos da jornada, o ponto de partida será a localização do veículo registrada no momento em que essa 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). Com isso, você informa o tempo restante de percurso usando o último local conhecido do app do motorista em vez do tempo 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é essa parada. Se a parada atual for a primeira da lista de segmentos da viagem, esse será o caminho desde o local atual do veículo até essa parada no momento em que ela foi adicionada à lista. Este campo pode não estar presente se o segmento 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). Ele fornece o caminho usando o local conhecido mais recente do app do motorista em vez do caminho da parada anterior.

VehicleStop

Descreve um ponto em que um veículo para para realizar uma 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 estarão a uma curta distância dele. Esse campo não será preenchido na resposta de uma chamada de tasks.get.

tasks[]

object (TaskInfo)

Lista de Tasks a serem executados nessa parada. Esse campo não será preenchido na resposta de uma chamada de tasks.get.

state

enum (State)

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

TaskInfo

Informações adicionais sobre a Tarefa realizada nesta 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 de tasks.get. 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 nenhum dos seguintes caracteres ASCII: '/', ':', '?', ',' ou '#'.
taskDuration

string (Duration format)

Apenas saída. O tempo necessário para realizar 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 um VehicleStop.

Enums
STATE_UNSPECIFIED Desconhecido.
NEW Criado, mas sem roteamento ativo.
ENROUTE Atribuído e roteamento ativo.
ARRIVED Chegou ao ponto. Assume que, quando o veículo está roteando para a próxima parada, todas as paradas anteriores foram concluídas.