REST Resource: providers.deliveryVehicles

Recurso: DeliveryVehicle

A mensagem DeliveryVehicle. Um veículo de entrega transporta remessas de um depósito para um local de entrega e de um local de retirada para o depósito. Em alguns casos, os veículos de entrega também transportam as remessas diretamente do local de retirada para o local de entrega.

Observação: as APIs REST e gRPC usam convenções de nomenclatura de campo diferentes. Por exemplo, o campo DeliveryVehicle.current_route_segment na API gRPC e o campo DeliveryVehicle.currentRouteSegment na API REST se referem ao mesmo campo.

Representação JSON 
{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}
Campos
name

string

O nome exclusivo do Veículo de entrega. O formato é providers/{provider}/deliveryVehicles/{vehicle}.
lastLocation

object (DeliveryVehicleLocation)

O último local relatado do veículo de entrega.
navigationStatus

enum (DeliveryVehicleNavigationStatus)

O status de navegação do Veículo de entrega.
currentRouteSegment

string (bytes format)

A polilinha codificada que especifica o trajeto que a navegação recomenda seguir para o próximo waypoint. O app do motorista atualiza isso quando uma parada é atingida ou ultrapassada e quando o trajeto traça o novo trajeto. Esses LatLngs são retornados em Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) para todas as tarefas ativas atribuídas ao veículo.

Em alguns casos, esse campo não pode ser usado para preencher Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) ou Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

  • O endpoint do currentRouteSegment não corresponde a DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) ou DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST).

  • O app do motorista não atualizou a localização recentemente. Por isso, o último valor atualizado desse campo pode estar desatualizado.

  • O app do motorista atualizou a localização recentemente, mas o currentRouteSegment está desatualizado e aponta para uma parada de veículo anterior.

Nesses casos, o Fleet Engine preenche esse campo com um trajeto desde o VehicleStop enviado mais recentemente até o próximo VehicleStop para garantir que o consumidor desse campo tenha as melhores informações disponíveis sobre o caminho atual do veículo de entrega.

Uma string codificada em base64.
currentRouteSegmentEndPoint

object (LatLng)

O local em que a currentRouteSegment termina. No momento, ele não é preenchido pelo app do motorista, mas é possível fornecê-lo em chamadas deliveryVehicles.patch. É o LatLng da próxima parada de veículo ou o último LatLng da currentRouteSegment. O Fleet Engine vai fazer o possível para interpolar para um VehicleStop real.

Esse campo será ignorado em chamadas deliveryVehicles.patch se o campo currentRouteSegment estiver vazio.
remainingDistanceMeters

integer

A distância de carro restante do currentRouteSegment. O app Driver normalmente fornece esse campo, mas há algumas circunstâncias em que o Fleet Engine substitui o valor enviado pelo aplicativo. Para mais informações, consulte DeliveryVehicle.current_route_segment. Esse campo é retornado em Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) ou Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) para todos os Tasks ativos atribuídos ao veículo de entrega.

O Fleet Engine vai ignorar esse campo em UpdateDeliveryVehicleRequest se o campo currentRouteSegment estiver vazio.
remainingDuration

string (Duration format)

O tempo restante do percurso do veículo currentRouteSegment. O app Driver normalmente fornece esse campo, mas há algumas circunstâncias em que o Fleet Engine substitui o valor enviado pelo aplicativo. Para mais informações, consulte DeliveryVehicle.current_route_segment. Esse campo é retornado em Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) ou Task.remainingVehicleJourneySegments[0].drivingDuration (REST) para todas as tarefas ativas atribuídas ao veículo de entrega.

O Fleet Engine vai ignorar esse campo em UpdateDeliveryVehicleRequest se o campo currentRouteSegment estiver vazio.

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

object (VehicleJourneySegment)

Os trechos de viagem atribuídos a esse veículo de entrega, começando no local informado mais recentemente. Este campo não será preenchido na resposta de deliveryVehicles.list.
attributes[]

object (DeliveryVehicleAttribute)

Uma lista de atributos personalizados do veículo de entrega. Um veículo de entrega pode ter no máximo 100 atributos, e cada um deles precisa ter uma chave exclusiva.
type

enum (DeliveryVehicleType)

O tipo deste veículo de entrega. Se não for definido, o padrão será AUTO.

DeliveryVehicleNavigationStatus

O status de navegação do veículo.

Enums
UNKNOWN_NAVIGATION_STATUS Status de navegação não especificado.
NO_GUIDANCE A navegação do app Driver está no modo FREE_NAV.
ENROUTE_TO_DESTINATION A navegação guiada está disponível, e a navegação do app do motorista entrou no modo GUIDED_NAV.
OFF_ROUTE O veículo saiu do trajeto sugerido.
ARRIVED_AT_DESTINATION O veículo está a aproximadamente 50 m do destino.

DeliveryVehicleAttribute

Descreve um atributo de veículo como um par de chave-valor. "key:value" não pode ter mais de 256 caracteres.

Representação JSON 
{
  "key": string,
  "value": string,

  // Union field delivery_vehicle_attribute_value can be only one of the
  // following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field
  // delivery_vehicle_attribute_value.
}
Campos
key

string

A chave do atributo.
value

string

O valor do atributo.
Campo de união delivery_vehicle_attribute_value. O valor do atributo pode ser string, booleano ou duplo. delivery_vehicle_attribute_value pode ser apenas de um dos tipos a seguir:
stringValue

string

Valor do atributo tipado de string.

Observação: ele é idêntico ao campo value, que será descontinuado. Para os métodos de criação ou atualização, qualquer um dos campos pode ser usado, mas é altamente recomendável usar stringValue. Se stringValue e value forem definidos, precisarão ser idênticos. Caso contrário, um erro será gerado. Ambos os campos são preenchidos nas respostas.
boolValue

boolean

Valor do atributo tipado booleano.
numberValue

number

Valor de atributo com dois tipos.

DeliveryVehicleType

O tipo de veículo de entrega.

Enums
DELIVERY_VEHICLE_TYPE_UNSPECIFIED O valor não é usado.
AUTO Um automóvel.
TWO_WHEELER Uma moto, ciclomoto ou outro veículo de duas rodas
BICYCLE Transporte impulsionado por humanos.
PEDESTRIAN Um transportador humano, normalmente caminhando ou correndo, viajando ao longo de vias para pedestres.

Métodos

create

 Cria e retorna um novo DeliveryVehicle.

get

 Retorna a instância de DeliveryVehicle especificada.

list

 Recebe todos os DeliveryVehicles que atendem aos critérios de filtragem especificados.

patch

 Grava dados atualizados de DeliveryVehicle no Fleet Engine e atribui Tasks ao DeliveryVehicle.