VehicleJourneySegment

Rappresenta il tratto percorso da un veicolo, dalla fermata precedente a quella attuale. Se è la prima fermata attiva, significa che si trova 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. Alcuni campi di VehicleStop potrebbero non essere presenti se questo tratto di corsa 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 tratti di viaggio, il punto di partenza è la posizione del veicolo registrata nel momento in cui questa fermata è stata aggiunta all'elenco. Questo campo potrebbe non essere presente se il segmento di 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 nell'elenco dei segmenti di viaggio, il punto di partenza è la posizione del veicolo registrata al momento dell'aggiunta della fermata all'elenco.

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

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

path[]

object (LatLng)

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

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

VehicleStop

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

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

object (LocationInfo)

Obbligatorio. La posizione della fermata. Tieni presente che le località negli Task potrebbero non corrispondere esattamente a questa località, ma si troveranno a breve distanza da quest'ultima. Questo campo non verrà compilato nella risposta di una chiamata tasks.get.

tasks[]

object (TaskInfo)

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

state

enum (State)

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

TaskInfo

Ulteriori informazioni 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 di 64 caratteri.
  • Normalizzato in base al formato di normalizzazione Unicode 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. L'intervallo di tempo durante il quale deve essere completata l'attività. Viene impostato solo nella risposta a deliveryVehicles.get.

Stato

Lo stato attuale di un VehicleStop.

Enum
STATE_UNSPECIFIED Sconosciuto.
NEW Creata, ma non instradata attivamente.
ENROUTE Assegnato e routing attivo.
ARRIVED Arrivato alla fermata. Presuppone che, quando il Veicolo instrada verso la fermata successiva, tutte le fermate precedenti siano state completate.