REST Resource: providers.deliveryVehicles

{
  "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)
}

string

O nome exclusivo desse veículo de entrega. O formato é providers/{provider}/deliveryVehicles/{vehicle}.

object (DeliveryVehicleLocation)

O último local informado do veículo de entrega.

enum (DeliveryVehicleNavigationStatus)

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

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 essa informação quando uma parada é alcançada ou ultrapassada e quando a navegação é redirecionada. 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.

Há alguns casos em que esse campo pode não 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 valor da última atualização desse campo pode estar desatualizado.

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

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.

object (LatLng)

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

Esse campo é ignorado em chamadas deliveryVehicles.patch se o campo currentRouteSegment estiver vazio.

integer

A distância de carro restante do percurso currentRouteSegment. O app Driver geralmente fornece esse campo, mas há algumas circunstâncias em que o Fleet Engine substitui o valor enviado pelo app. 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.

string (Duration format)

O tempo restante de percurso do veículo currentRouteSegment. O app Driver geralmente fornece esse campo, mas há algumas circunstâncias em que o Fleet Engine substitui o valor enviado pelo app. 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".

object (VehicleJourneySegment)

Os segmentos de viagem atribuídos a esse veículo de entrega, começando pelo local mais recente informado. Esse campo não será preenchido na resposta de deliveryVehicles.list.

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 atributo precisa ter uma chave exclusiva.

enum (DeliveryVehicleType)

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

{
  "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.
}

string

A chave do atributo.

string

O valor do atributo.

string

Valor de atributo digitado em string.

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

boolean

Valor de atributo do tipo booleano.

number

Valor do atributo com digitação dupla.