VehicleJourneySegment

Rappresenta il segmento di viaggio di un veicolo, dalla fermata precedente a quella corrente. Se è la prima fermata attiva, significa che si tratta dalla posizione attuale del veicolo a questa fermata.

Rappresentazione JSON
{
  "stop": {
    object (VehicleStop)
  },
  "drivingDistanceMeters": integer,
  "drivingDuration": string,
  "path": [
    {
      object (LatLng)
    }
  ]
}
Campi
stop

object (VehicleStop)

Specifica la posizione della fermata, insieme ai Task associati alla fermata. Alcuni campi di VehicleStop potrebbero non essere presenti se questo tratto di viaggio fa parte di JourneySharingInfo.

drivingDistanceMeters

integer

Solo output. La distanza da percorrere dalla fermata precedente a questa fermata. Se la fermata corrente è la prima fermata nell'elenco dei segmenti del viaggio, il punto di partenza è la posizione del veicolo registrata al momento in cui la fermata è stata aggiunta all'elenco. Questo campo potrebbe non essere presente se questo tratto del percorso fa parte di JourneySharingInfo.

drivingDuration

string (Duration format)

Solo output. Il tempo di percorrenza dalla fermata precedente a questa fermata. Se la fermata corrente è la prima fermata nell'elenco dei segmenti del viaggio, il punto di partenza è la posizione del veicolo registrata nel momento in cui la fermata è stata aggiunta all'elenco.

Se questo campo viene definito nel percorso Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) o Task.remainingVehicleJourneySegments[0].drivingDuration (REST), è possibile inserire il valore di DeliveryVehicle.remaining_duration (gRPC) o DeliveryVehicle.remainingDuration (REST). Fornisce la durata di guida rimanente dall'ultima posizione nota dell'app del conducente anziché il tempo di guida dalla fermata precedente.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

path[]

object (LatLng)

Solo output. Il percorso dalla fermata precedente a questa fermata. Se la fermata corrente è la prima fermata nell'elenco dei segmenti del viaggio, questo è il percorso dalla posizione corrente del veicolo a questa fermata nel momento in cui la fermata è stata aggiunta all'elenco. Questo campo potrebbe non essere presente se questo tratto del percorso fa parte di JourneySharingInfo.

Se questo campo viene definito nel percorso Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) o Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST), è possibile che venga compilato con i LatLng decodificati da DeliveryVehicle.current_route_segment (gRPC) o DeliveryVehicle.currentRouteSegment (REST). In questo modo viene fornito il percorso in auto dall'ultima posizione nota dell'app del conducente anziché il percorso della fermata precedente.

VehicleStop

Descrive un punto in cui un veicolo si ferma per eseguire uno o più Task.

Rappresentazione JSON
{
  "plannedLocation": {
    object (LocationInfo)
  },
  "tasks": [
    {
      object (TaskInfo)
    }
  ],
  "state": enum (State)
}
Campi
plannedLocation

object (LocationInfo)

Obbligatoria. La posizione della fermata. Tieni presente che le località negli Task potrebbero non corrispondere esattamente a questa località, ma saranno a breve distanza dalla località. Questo campo non verrà compilato nella risposta a una chiamata tasks.get.

tasks[]

object (TaskInfo)

Elenco di Task da eseguire in questa fermata. Questo campo non verrà compilato nella risposta a una chiamata tasks.get.

state

enum (State)

Lo stato del VehicleStop. Questo campo non verrà compilato nella risposta a una chiamata tasks.get.

TaskInfo

Informazioni aggiuntive sull'attività eseguita in questa fermata.

Rappresentazione JSON
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
Campi
taskId

string

L'ID attività. Questo campo non verrà compilato nella risposta a una chiamata tasks.get. Gli ID attività sono soggetti alle seguenti limitazioni:

  • Deve essere una stringa Unicode valida.
  • Lunghezza massima: 64 caratteri.
  • Normalizzata secondo lo standard Unicode Normalization Form C.
  • Non può contenere nessuno dei seguenti caratteri ASCII: "/", ":", "?", "," o "#".
taskDuration

string (Duration format)

Solo output. Il tempo necessario per eseguire l'attività.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

targetTimeWindow

object (TimeWindow)

Solo output. La finestra temporale durante la quale deve essere completata l'attività. Questo valore è impostato solo nella risposta a deliveryVehicles.get.

Stato

Lo stato attuale di un oggetto VehicleStop.

Enum
STATE_UNSPECIFIED Sconosciuto.
NEW L'elemento è stato creato, ma il routing non è attivo.
ENROUTE Assegnati e routing attivo.
ARRIVED Arrivato alla fermata. Presuppone che, quando il veicolo sta passando alla fermata successiva, che tutte le fermate precedenti siano state completate.