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

Es el nombre único de este vehículo de entrega. El formato es providers/{provider}/deliveryVehicles/{vehicle}.

object (DeliveryVehicleLocation)

Es la última ubicación informada del vehículo de entrega.

enum (DeliveryVehicleNavigationStatus)

Es el estado de navegación del vehículo de entrega.

string (bytes format)

Es la polilínea codificada que especifica la ruta que la navegación recomienda tomar hasta el siguiente punto de referencia. La app del conductor actualiza esta información cuando se llega a una parada o se pasa por ella, y cuando la navegación cambia de ruta. Estos LatLng se muestran en Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) o Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) para todas las tareas activas asignadas al vehículo.

Hay algunos casos en los que es posible que este campo no se use para propagar Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) o Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

• El extremo de currentRouteSegment no coincide con DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) ni DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST).

• La app del conductor no actualizó su ubicación recientemente, por lo que el valor actualizado más reciente de este campo podría estar desactualizado.

• La app del conductor actualizó su ubicación recientemente, pero el currentRouteSegment está inactivo y apunta a una parada anterior del vehículo.

En estos casos, Fleet Engine completa este campo con una ruta desde la VehicleStop más reciente hasta la próxima VehicleStop para garantizar que el consumidor de este campo tenga la mejor información disponible sobre la ruta actual del vehículo de entrega.

String codificada en base64.

object (LatLng)

Es la ubicación donde termina currentRouteSegment. Actualmente, la app del conductor no propaga este valor, pero puedes proporcionarlo en las llamadas a deliveryVehicles.patch. Es el LatLng de la próxima parada del vehículo o el último LatLng del currentRouteSegment. Luego, Fleet Engine hará todo lo posible para interpolar a un VehicleStop real.

Este campo se ignora en las llamadas a deliveryVehicles.patch si el campo currentRouteSegment está vacío.

integer

Es la distancia de conducción restante para el currentRouteSegment. Por lo general, la app de Driver proporciona este campo, pero hay algunas circunstancias en las que Fleet Engine anula el valor que envía la app. Para obtener más información, consulta DeliveryVehicle.current_route_segment. Este campo se muestra en Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) o Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) para todos los Task activos asignados al vehículo de entrega.

Fleet Engine ignora este campo en UpdateDeliveryVehicleRequest si el campo currentRouteSegment está vacío.

string (Duration format)

Es el tiempo de conducción restante para el currentRouteSegment. Por lo general, la app de Driver proporciona este campo, pero hay algunas circunstancias en las que Fleet Engine anula el valor que envía la app. Para obtener más información, consulta DeliveryVehicle.current_route_segment. Este campo se muestra en Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) o Task.remainingVehicleJourneySegments[0].drivingDuration (REST) para todas las tareas activas asignadas al vehículo de publicación.

Fleet Engine ignora este campo en UpdateDeliveryVehicleRequest si el campo currentRouteSegment está vacío.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

object (VehicleJourneySegment)

Los segmentos de recorrido asignados a este vehículo de entrega, a partir de la ubicación informada más reciente del vehículo. Este campo no se propagará en la respuesta de deliveryVehicles.list.

object (DeliveryVehicleAttribute)

Es una lista de atributos personalizados de vehículos de entrega. Un vehículo de entrega puede tener 100 atributos como máximo, y cada atributo debe tener una clave única.

enum (DeliveryVehicleType)

Es el tipo de vehículo de entrega. Si no se configura, el valor predeterminado es 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

La clave del atributo.

string

Es el valor del atributo.

string

Valor del atributo escrito como cadena.

Nota: Es idéntico al campo value, que eventualmente dejará de estar disponible. Para los métodos de creación o actualización, se puede usar cualquiera de los campos, pero se recomienda usar stringValue. Si se configuran stringValue y value, deben ser idénticos o se arrojará un error. Ambos campos se propagan en las respuestas.

boolean

Valor de atributo escrito en formato booleano.

number

Valor de atributo escrito dos veces.