VehicleJourneySegment

Rappresenta il segmento di viaggio di un veicolo, dalla fermata precedente alla fermata corrente. Se è la prima fermata attiva, significa che 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 del valore VehicleStop potrebbero non essere presenti se questo segmento 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 nel momento in cui questa fermata è stata aggiunta all'elenco. Questo campo potrebbe non essere presente se questo segmento 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 attuale è la prima fermata nell'elenco dei segmenti del viaggio, il punto di partenza è la posizione del veicolo registrata nel momento in cui questa 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), può essere compilato con il valore di DeliveryVehicle.remaining_duration (gRPC) o DeliveryVehicle.remainingDuration (REST). In questo modo viene fornita la durata di guida rimanente dall'ultima posizione nota dell'app del conducente anziché il tempo di guida della 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 fermata nell'elenco dei segmenti del viaggio, questo è il percorso che va dalla posizione attuale del veicolo a questa fermata nel momento in cui quest'ultima è stata aggiunta all'elenco. Questo campo potrebbe non essere presente se questo segmento 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), può essere compilato con i LatLng decodificati da DeliveryVehicle.current_route_segment (gRPC) o DeliveryVehicle.currentRouteSegment (REST). Fornisce 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)

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

tasks[]

object (TaskInfo)

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

state

enum (State)

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

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 di una chiamata tasks.get o tasks.search. Gli ID attività sono soggetti alle seguenti limitazioni:

  • Deve essere una stringa Unicode valida.
  • Lunghezza massima: 64 caratteri.
  • Normalizzato secondo lo Unicode Normalization Form C.
  • Non può contenere i 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 VehicleStop.

Enum
STATE_UNSPECIFIED Sconosciuto.
NEW Creata, ma non attiva il routing.
ENROUTE Assegnato e routing attivo.
ARRIVED Arrivato alla fermata. Presuppone che, quando il veicolo passa alla fermata successiva, tutte le fermate precedenti siano state completate.