REST Resource: providers.deliveryVehicles

Risorsa: DeliveryVeicoli

Il messaggio DeliveryVehicle. Un veicolo per la consegna trasporta le spedizioni da un deposito a un punto di consegna e da un punto di prelievo al deposito. In alcuni casi, i mezzi di consegna trasportano anche le spedizioni direttamente dal punto di prelievo a quello di consegna.

Nota: le API gRPC e REST utilizzano convenzioni di denominazione dei campi diverse. Ad esempio, il campo DeliveryVehicle.current_route_segment nell'API gRPC e il campo DeliveryVehicle.currentRouteSegment nell'API REST fanno riferimento allo stesso campo.

Rappresentazione 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)
}
Campi
name

string

Il nome univoco di questo veicolo per la consegna. Il formato è providers/{provider}/deliveryVehicles/{vehicle}.
lastLocation

object (DeliveryVehicleLocation)

L'ultima posizione segnalata del veicolo per la consegna.
navigationStatus

enum (DeliveryVehicleNavigationStatus)

Lo stato di navigazione del veicolo per la consegna.
currentRouteSegment

string (bytes format)

La polilinea codificata che specifica il percorso che la navigazione consiglia di seguire per la tappa successiva. L'app del conducente aggiorna questo dato quando viene raggiunta o superata una fermata e quando la navigazione cambia percorso. Questi LatLng vengono restituiti in Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) o Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) per tutte le attività attive assegnate al veicolo.

In alcuni casi, questo campo potrebbe non essere utilizzato per compilare Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) o Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

  • L'endpoint di currentRouteSegment non corrisponde a DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) o DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST).

  • L'app del conducente non ha aggiornato la sua posizione di recente, pertanto l'ultimo valore aggiornato per questo campo potrebbe essere inattivo.

  • L'app del conducente ha aggiornato di recente la sua posizione, ma il currentRouteSegment è inattivo e rimanda a una fermata del veicolo precedente.

In questi casi, Fleet Engine compila questo campo con un percorso dal VehicleStop passato più di recente al prossimo VehicleStop per garantire che l'utente di questo campo abbia le migliori informazioni disponibili sul percorso attuale del Veicolo di consegna.

Una stringa con codifica base64.
currentRouteSegmentEndPoint

object (LatLng)

La posizione in cui termina l'evento currentRouteSegment. Al momento non è compilato dall'app del conducente, ma puoi fornirlo nelle chiamate deliveryVehicles.patch. Si tratta della LatLng della prossima fermata del veicolo o dell'ultimo LatLng dei currentRouteSegment. Fleet Engine farà del proprio meglio per interpolare in modo da ottenere un valore VehicleStop effettivo.

Questo campo viene ignorato nelle chiamate deliveryVehicles.patch se il campo currentRouteSegment è vuoto.
remainingDistanceMeters

integer

La distanza in auto rimanente per il currentRouteSegment. In genere l'app Driver fornisce questo campo, ma in alcuni casi Fleet Engine sostituirà il valore inviato dall'app. Per ulteriori informazioni, vedi DeliveryVehicle.current_route_segment. Questo campo viene restituito in Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) o Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) per tutti i Task attivi assegnati al veicolo di consegna.

Fleet Engine ignora questo campo in UpdateDeliveryVehicleRequest se il campo currentRouteSegment è vuoto.
remainingDuration

string (Duration format)

Il tempo di guida rimanente per il currentRouteSegment. In genere l'app Driver fornisce questo campo, ma in alcuni casi Fleet Engine sostituirà il valore inviato dall'app. Per ulteriori informazioni, vedi DeliveryVehicle.current_route_segment. Questo campo viene restituito in Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) o Task.remainingVehicleJourneySegments[0].drivingDuration (REST) per tutte le attività attive assegnate al veicolo di consegna.

Fleet Engine ignora questo campo in UpdateDeliveryVehicleRequest se il campo currentRouteSegment è vuoto.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".
remainingVehicleJourneySegments[]

object (VehicleJourneySegment)

I segmenti di viaggio assegnati a questo Veicolo per le consegne, a partire dalla posizione del veicolo segnalata più di recente. Questo campo non verrà compilato nella risposta di deliveryVehicles.list.
attributes[]

object (DeliveryVehicleAttribute)

Un elenco di attributi personalizzati del veicolo per la consegna. Un veicolo per la consegna può avere al massimo 100 attributi, ognuno dei quali deve avere una chiave univoca.
type

enum (DeliveryVehicleType)

Il tipo di questo veicolo per la consegna. Se non viene configurato, il valore predefinito è AUTO.

DeliveryVehicleNavigationStatus

Lo stato di navigazione del veicolo.

Enum
UNKNOWN_NAVIGATION_STATUS Stato di navigazione non specificato.
NO_GUIDANCE La navigazione dell'app Driver è in modalità FREE_NAV.
ENROUTE_TO_DESTINATION La navigazione passo passo è disponibile e la navigazione nell'app Driver è attivata in modalità GUIDED_NAV.
OFF_ROUTE Il veicolo ha abbandonato il percorso suggerito.
ARRIVED_AT_DESTINATION Il veicolo si trova a una distanza di circa 50 m dalla destinazione.

DeliveryVehicleAttribute

Descrive un attributo del veicolo come coppia chiave-valore. La colonna "key:value" la lunghezza della stringa non può superare i 256 caratteri.

Rappresentazione 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.
}
Campi
key

string

La chiave dell'attributo.
value

string

Il valore dell'attributo.
Campo unione delivery_vehicle_attribute_value. Il valore dell'attributo può essere di tipo stringa, bool o doppio. delivery_vehicle_attribute_value può essere solo uno dei seguenti:
stringValue

string

Valore dell'attributo tipo di stringa.

Nota: è identico al campo value che verrà ritirato. Per i metodi di creazione o aggiornamento, entrambi i campi possono essere utilizzati, ma consigliamo vivamente di utilizzare stringValue. Se stringValue e value sono impostati, devono essere identici, altrimenti verrà visualizzato un errore. Entrambi i campi vengono compilati in risposte.
boolValue

boolean

Valore di attributo digitato con valore booleano.
numberValue

number

Valore attributo doppio tipo.

DeliveryVehicleType

Il tipo di veicolo per la consegna.

Enum
DELIVERY_VEHICLE_TYPE_UNSPECIFIED Il valore non è utilizzato.
AUTO Un'automobile.
TWO_WHEELER Una motocicletta, un ciclomotore o un altro veicolo a due ruote
BICYCLE Trasporto a energia umana.
PEDESTRIAN Un trasportatore, di solito cammina o corre, che percorre percorsi pedonali.

Metodi

create

 Crea e restituisce un nuovo DeliveryVehicle.

get

 Restituisce l'istanza DeliveryVehicle specificata.

list

 Restituisce tutti i valori DeliveryVehicle che soddisfano i criteri di filtro specificati.

patch

 Scrive i dati DeliveryVehicle aggiornati su Fleet Engine e assegna Tasks a DeliveryVehicle.