TripLog

Il log di una risorsa Viaggio in Fleet Engine.

Rappresentazione JSON
{
  "name": string,
  "status": enum (TripStatusLog),
  "tripType": enum (TripTypeLog),
  "vehicleId": string,
  "lastLocation": {
    object (VehicleLocationLog)
  },
  "currentRouteSegmentEndPoint": {
    object (TripWaypointLog)
  },
  "pickupPoint": {
    object (TerminalLocationLog)
  },
  "actualPickupPoint": {
    object (StopLocationLog)
  },
  "actualPickupArrivalPoint": {
    object (StopLocationLog)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocationLog)
    }
  ],
  "intermediateDestinationIndex": integer,
  "intermediateDestinationsVersion": string,
  "actualIntermediateDestinations": [
    {
      object (StopLocationLog)
    }
  ],
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocationLog)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocationLog)
  },
  "actualDropoffPoint": {
    object (StopLocationLog)
  },
  "dropoffTime": string,
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "numberOfPassengers": integer,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolylineLog)
  },
  "attributes": [
    {
      object (TripAttributeLog)
    }
  ]
}
Campi
name

string

Il nome della risorsa corsa nel formato providers/{providerId}/trips/{tripId}.

status

enum (TripStatusLog)

Lo stato della corsa.

tripType

enum (TripTypeLog)

Il tipo di viaggio.

vehicleId

string

L'ID del veicolo a cui è assegnato il viaggio.

lastLocation

object (VehicleLocationLog)

L'ultima posizione segnalata del veicolo lungo il percorso.

currentRouteSegmentEndPoint

object (TripWaypointLog)

Il waypoint in cui termina currentRouteSegment.

pickupPoint

object (TerminalLocationLog)

Località in cui il cliente indica di essere disponibile per il ritiro.

actualPickupPoint

object (StopLocationLog)

La posizione effettiva in cui il cliente è stato ritirato.

actualPickupArrivalPoint

object (StopLocationLog)

L'ora e la posizione effettive dell'arrivo del conducente al punto di ritiro. Questo campo consente a un fornitore di fornire un feedback sulle informazioni sull'arrivo effettivo al punto di ritiro.

pickupTime

string (Timestamp format)

L'orario di riconsegna del cliente. Può essere nel futuro o nel passato.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

intermediateDestinations[]

object (TerminalLocationLog)

Fermate intermedie nell'ordine richiesto (oltre a quelle di prelievo e consegna).

intermediateDestinationIndex

integer

Quando TripStatus è ENROUTE_TO_INTERMEDIATE_DESTINATION, un numero compreso tra [0..N-1] che indica la prossima destinazione intermedia che il veicolo attraverserà. Quando TripStatus è ARRIVED_AT_INTERMEDIATE_DESTINATION, un numero compreso tra [0..N-1] che indica quale destinazione intermedia è la posizione attuale del veicolo.

intermediateDestinationsVersion

string (Timestamp format)

La versione delle destinazioni intermedie specificate

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

actualIntermediateDestinations[]

object (StopLocationLog)

L'ora e la posizione effettive in cui e quando il cliente è stato ritirato da una destinazione intermedia. Questo campo consente a un fornitore di fornire un feedback sulle informazioni effettive sul ritiro nelle destinazioni intermedie.

actualIntermediateDestinationArrivalPoints[]

object (StopLocationLog)

L'ora e la posizione effettive dell'arrivo del conducente a una destinazione intermedia. Questo campo consente a un fornitore di fornire feedback sulle informazioni effettive sull'arrivo alle destinazioni intermedie.

dropoffPoint

object (TerminalLocationLog)

Località in cui il cliente indica di essere in attesa.

actualDropoffPoint

object (StopLocationLog)

La posizione effettiva in cui il cliente è stato scaricato.

dropoffTime

string (Timestamp format)

Ora in cui il cliente verrà o è stato scaricato.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

remainingDistanceMeters

integer

La distanza percorsa rimanente nel tratto di percorso corrente.

etaToFirstWaypoint

string (Timestamp format)

L'orario di arrivo stimato al waypoint successivo (la prima voce nel campo Trip.remaining_waypoints).

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

remainingTimeToFirstWaypoint

string (Duration format)

Il tempo rimanente per raggiungere il waypoint successivo (la prima voce nel campo Trip.remaining_waypoints).

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

numberOfPassengers

integer

Indica il numero di passeggeri di questo viaggio e non include il conducente. Un veicolo deve avere una capacità disponibile per essere restituito in SearchVehicles.

currentRouteSegmentTraffic

object (ConsumableTrafficPolylineLog)

Se disponibili, le condizioni del traffico lungo il tratto di percorso corrente.

attributes[]

object (TripAttributeLog)

Un elenco di attributi di viaggio personalizzati.

StopLocationLog

La posizione effettiva in cui si verifica una fermata (prelievo/consegna).

Rappresentazione JSON
{
  "timestamp": string,
  "point": {
    object (LatLng)
  }
}
Campi
timestamp

string (Timestamp format)

Il timestamp della registrazione della posizione.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

point

object (LatLng)

Indica la posizione effettiva della fermata.

TripAttributeLog

Un attributo espresso come coppia chiave-valore associato a un viaggio.

Rappresentazione JSON
{
  "key": string,

  // Union field trip_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field trip_attribute_value.
}
Campi
key

string

La chiave dell'attributo.

Campo unione trip_attribute_value. Il valore dell'attributo può essere di tipo stringa, booleano o doppio. trip_attribute_value può essere solo uno dei seguenti:
stringValue

string

Valore dell'attributo di tipo stringa.

boolValue

boolean

Valore dell'attributo di tipo booleano.

numberValue

number

Valore dell'attributo con tipo doppio.