VehicleJourneySegment

Rappresenta il segmento di viaggio di un veicolo, dalla fermata precedente a quella corrente. 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 questo tratto di viaggio 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), è possibile che venga compilato con il valore di DeliveryVehicle.remaining_duration (gRPC) o DeliveryVehicle.remainingDuration (REST). In questo modo viene indicata la durata di guida rimanente in base all'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 fermata nell'elenco dei tratti di viaggio, si tratta del percorso dalla posizione attuale del veicolo a questa fermata nel momento in cui la fermata è 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 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 si troveranno a breve distanza da quest'ultima. Questo campo non verrà compilato nella risposta a una chiamata tasks.get.

tasks[]

object (TaskInfo)

L'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 di VehicleStop. Questo campo non verrà compilato nella risposta a 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 restrizioni:

  • 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à.

Durata in secondi con un massimo di nove cifre frazionarie e 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 L'operazione è stata creata, ma il routing non è attivo.
ENROUTE Assegnato e routing attivo.
ARRIVED Sei arrivato alla fermata. Presuppone che, quando il Veicolo instrada verso la fermata successiva, tutte le fermate precedenti siano state completate.