VehicleJourneySegment

Rappresenta il tratto percorso da un veicolo, dalla fermata precedente a quella attuale. Se si tratta della prima fermata attiva, il percorso va 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 segmento di viaggio fa parte di JourneySharingInfo.

drivingDistanceMeters

integer

Solo output. La distanza percorsa 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 attuale è la prima fermata nell'elenco dei tratti di viaggio, il punto di partenza è la posizione del Veicolo registrato nel momento in cui questa fermata è stata aggiunta all'elenco.

Se questo campo è definito nel percorso Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) o Task.remainingVehicleJourneySegments[0].drivingDuration (REST), può essere 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.

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 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 la fermata è stata aggiunta all'elenco. Questo campo potrebbe non essere presente se il segmento di percorso 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), può essere compilato con i LatLng decodificati da 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é dal percorso dalla 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)

Obbligatorio. La posizione della fermata. Tieni presente che le località nei Task potrebbero non corrispondere esattamente a questa, ma si trovano a breve distanza. 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 del VehicleStop. Questo campo non verrà compilato nella risposta di una chiamata tasks.get.

TaskInfo

Ulteriori informazioni sull'attività svolta 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 di una chiamata tasks.get. Gli ID attività sono soggetti alle seguenti limitazioni:

  • Deve essere una stringa Unicode valida.
  • Lunghezza massima di 64 caratteri.
  • Normalizzato secondo lo 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 l'attività deve essere completata. 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 Assegnati e in routing attivo.
ARRIVED Arrivato alla fermata. Presuppone che, quando il Veicolo instrada verso la fermata successiva, tutte le fermate precedenti siano state completate.