REST Resource: providers.trips

{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}

string

Solo output. Nel formato "providers/{provider}/trips/{trip}"

string

ID del veicolo che effettua la corsa.

enum (TripStatus)

Stato attuale della corsa.

enum (TripType)

Il tipo di viaggio.

object (TerminalLocation)

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

object (StopLocation)

Solo input. Il luogo effettivo di quando e dove il cliente è stato ritirato. Questo campo è destinato al fornitore per fornire un feedback sulle informazioni effettive sul ritiro.

object (StopLocation)

Solo input. L'ora e il luogo effettivi dell'arrivo del conducente al punto di prelievo. Questo campo è destinato al fornitore per fornire feedback sulle informazioni sull'arrivo effettivo al punto di ritiro.

string (Timestamp format)

Solo output. L'orario futuro stimato in cui verranno ritirati i passeggeri o l'ora effettiva in cui sono stati prelevati.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (TerminalLocation)

Fermate intermedie in ordine di richiesta della corsa (oltre a partenza e arrivo). Inizialmente, questa funzionalità non sarà supportata per i viaggi condivisi.

string (Timestamp format)

Indica l'ultima volta che intermediateDestinations è stato modificato. Il server deve memorizzare nella cache questo valore e passarlo in UpdateTripRequest quando aggiorna intermediateDestinationIndex per assicurarsi che intermediateDestinations non venga modificato.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

integer

Quando TripStatus è ENROUTE_TO_INTERMEDIATE_DESTINATION, un numero compreso tra [0..N-1] e [0..N-1] indica la destinazione intermedia che verrà attraversata dal veicolo. Quando TripStatus è ARRIVED_AT_INTERMEDIATE_DESTINATION, un numero compreso tra [0..N-1] che indica la destinazione intermedia in cui si trova il veicolo. Questo valore viene impostato dal fornitore. Se non sono presenti intermediateDestinations, questo campo viene ignorato.

object (StopLocation)

Solo input. L'ora e il luogo effettivi in cui arriva il conducente a una destinazione intermedia. Questo campo è destinato al fornitore per fornire feedback sulle informazioni di arrivo effettive nelle destinazioni intermedie.

object (StopLocation)

Solo input. L'ora e il luogo effettivi in cui il cliente è stato prelevato da una destinazione intermedia. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive sul ritiro presso le destinazioni intermedie.

object (TerminalLocation)

Località in cui il cliente indica che verrà riconsegnato.

object (StopLocation)

Solo input. L'ora e il luogo effettivi in cui e dove il cliente è stato consegnato. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive di abbandono.

string (Timestamp format)

Solo output. L'orario futuro stimato in cui i passeggeri verranno riconsegnati alla destinazione finale o l'ora effettiva in cui sono stati riconsegnati.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

Solo output. Il percorso completo dalla posizione attuale al punto di consegna, incluso. Questo percorso potrebbe includere waypoint di altri viaggi.

object (TripWaypoint)

Questo campo supporta l'ordinamento manuale dei waypoint per il viaggio. Contiene tutte le tappe rimanenti per il veicolo assegnato, nonché le tappe di partenza e arrivo per questa corsa. Se la corsa non è stata assegnata a un veicolo, Fleet Engine ignora questo campo. Per motivi di privacy, questo campo viene compilato dal server solo per le chiamate trips.update e trips.create, NON per le chiamate trips.get.

object (LatLng)

Solo output. Percorso previsto per questo viaggio al primo ingresso nei waypoint rimanenti. Tieni presente che il primo waypoint potrebbe appartenere a un viaggio diverso.

string

Solo output. Un percorso codificato per il waypoint successivo.

Nota: questo campo è destinato esclusivamente all'utilizzo da parte dell'SDK driver e dell'SDK consumer. La decodifica non è ancora supportata.

string (Timestamp format)

Solo output. Indica l'ultima volta che il percorso è stato modificato.

Nota: questo campo è destinato esclusivamente all'utilizzo da parte dell'SDK driver e dell'SDK consumer.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (ConsumableTrafficPolyline)

Solo output. Indica le condizioni del traffico lungo il currentRouteSegment quando sono disponibili.

Nota: questo campo è destinato esclusivamente all'utilizzo da parte dell'SDK driver e dell'SDK consumer.

string (Timestamp format)

Solo output. Indica l'ultima volta che currentRouteSegmentTraffic è stato modificato.

Nota: questo campo è destinato esclusivamente all'utilizzo da parte dell'SDK Driver e dell'SDK Consumer.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

Solo output. Il waypoint dove finisce currentRouteSegment.

integer

Solo output. La distanza di guida rimanente nel campo currentRouteSegment. Il valore non è specificato se la corsa non è assegnata a un veicolo oppure se la corsa è stata completata o annullata.

string (Timestamp format)

Solo output. L'orario di arrivo stimato al waypoint successivo (la prima voce nel campo remainingWaypoints). Il valore non è specificato se la corsa non è assegnata a un veicolo o se la corsa non è attiva (completata o annullata).

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Solo output. La durata tra il momento in cui i dati del viaggio vengono restituiti all'ora indicata in Trip.eta_to_first_waypoint. Il valore non è specificato se la corsa non è assegnata a un veicolo o se è inattiva (completata o annullata).

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

string (Timestamp format)

Solo output. Indica l'ultima volta che remainingWaypoints è stato modificato (è stato aggiunto, rimosso o modificato un waypoint).

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Solo output. Indica l'ultima volta che remainingWaypoints.path_to_waypoint e remainingWaypoints.traffic_to_waypoint sono stati modificati. L'app client deve memorizzare nella cache questo valore e trasmetterlo a GetTripRequest per garantire che i percorsi e il traffico per remainingWaypoints vengano restituiti solo se aggiornati.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

integer

Immutabile. Indica il numero di passeggeri di questa corsa e non include il conducente. Un veicolo deve avere una capacità disponibile per essere restituito in una risposta vehicles.search.

object (VehicleLocation)

Solo output. Indica l'ultima posizione segnalata del veicolo lungo il percorso.

boolean

Solo output. Indica se il lastLocation del veicolo può essere agganciato a currentRouteSegment. False se lastLocation o currentRouteSegment non esiste. Viene calcolato da Fleet Engine. Eventuali aggiornamenti dei client verranno ignorati.

enum (TripView)

Il sottoinsieme di campi Trip compilati e come devono essere interpretati.

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object (LatLng)

Obbligatorio. Indica la posizione effettiva.

string (Timestamp format)

Indica quando si è verificato l'arresto.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Solo input. Deprecato. Utilizza il campo timestamp.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".