Risorsa: Viaggio
Metadati dei viaggi.
Rappresentazione JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Campi | |
---|---|
name |
Solo output. Nel formato "providers/{provider}/trips/{trip}" |
vehicleId |
ID del veicolo che effettua la corsa. |
tripStatus |
Stato attuale della corsa. |
tripType |
Il tipo di viaggio. |
pickupPoint |
Località in cui il cliente indica che verrà ritirato. |
actualPickupPoint |
Solo input. Il luogo effettivo di quando e dove il cliente è stato ritirato. Questo campo consente al fornitore di fornire un feedback sulle effettive informazioni sul ritiro. |
actualPickupArrivalPoint |
Solo input. L'ora e il luogo effettivi dell'arrivo del conducente al punto di prelievo. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive sull'arrivo al punto di prelievo. |
pickupTime |
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 RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
intermediateDestinations[] |
Fermate intermedie in ordine di richiesta della corsa (oltre a partenza e arrivo). Inizialmente, questa funzionalità non sarà supportata per i viaggi condivisi. |
intermediateDestinationsVersion |
Indica l'ultima volta che Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
intermediateDestinationIndex |
Quando |
actualIntermediateDestinationArrivalPoints[] |
Solo input. L'ora e il luogo effettivi in cui arriva il conducente a una destinazione intermedia. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive sull'arrivo alle destinazioni intermedie. |
actualIntermediateDestinations[] |
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. |
dropoffPoint |
Località in cui il cliente indica che verrà riconsegnato. |
actualDropoffPoint |
Solo input. L'ora e il luogo effettivi in cui e dove il cliente è stato riconsegnato. Questo campo consente al fornitore di fornire un feedback sulle effettive informazioni sull'abbandono. |
dropoffTime |
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 RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
remainingWaypoints[] |
Solo output. Il percorso completo dalla posizione corrente al punto di discesa, incluso. Questo percorso potrebbe includere tappe di altre corse. |
vehicleWaypoints[] |
Questo campo supporta l'ordinamento manuale delle tappe della corsa. 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 durante le chiamate |
route[] |
Solo output. Percorso previsto per questo viaggio al primo ingresso nei waypoint rimanenti. Tieni presente che la prima tappa potrebbe appartenere a una corsa diversa. |
currentRouteSegment |
Solo output. Un percorso codificato alla tappa successiva. Nota: questo campo è destinato esclusivamente all'utilizzo da parte dell'SDK driver e dell'SDK consumer. La decodifica non è ancora supportata. |
currentRouteSegmentVersion |
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 RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
currentRouteSegmentTraffic |
Solo output. Indica le condizioni del traffico lungo il Nota: questo campo è destinato esclusivamente all'utilizzo da parte dell'SDK driver e dell'SDK consumer. |
currentRouteSegmentTrafficVersion |
Solo output. Indica l'ultima volta che Nota: questo campo è destinato esclusivamente all'utilizzo da parte dell'SDK driver e dell'SDK consumer. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
currentRouteSegmentEndPoint |
Solo output. Il waypoint dove finisce |
remainingDistanceMeters |
Solo output. La distanza di guida rimanente nel campo |
etaToFirstWaypoint |
Solo output. L'orario di arrivo stimato alla tappa successiva (la prima voce nel campo Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
remainingTimeToFirstWaypoint |
Solo output. La durata tra il momento in cui i dati del viaggio vengono restituiti all'ora indicata in Durata in secondi con un massimo di nove cifre frazionarie e termina con " |
remainingWaypointsVersion |
Solo output. Indica l'ultima volta che Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
remainingWaypointsRouteVersion |
Solo output. Indica l'ultima volta che Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
numberOfPassengers |
Immutabile. Indica il numero di passeggeri di questa corsa e non include il conducente. Un veicolo deve avere capacità disponibile per essere restituito in una risposta |
lastLocation |
Solo output. Indica l'ultima posizione segnalata del veicolo lungo il percorso. |
lastLocationSnappable |
Solo output. Indica se l'elemento |
view |
Il sottoinsieme di campi Trip compilati e come devono essere interpretati. |
TripStatus
Lo stato di una corsa che indica l'avanzamento.
Enum | |
---|---|
UNKNOWN_TRIP_STATUS |
Valore predefinito, utilizzato per lo stato della corsa non specificato o non riconosciuto. |
NEW |
Viaggio appena creato. |
ENROUTE_TO_PICKUP |
L'autista si sta dirigendo verso il punto di prelievo. |
ARRIVED_AT_PICKUP |
L'autista è arrivato al punto di prelievo. |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
L'autista è arrivato a una destinazione intermedia e sta aspettando il corridore. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
Il conducente si sta dirigendo verso una destinazione intermedia (non il punto di consegna). |
ENROUTE_TO_DROPOFF |
L'autista ha preso il passeggero ed è in viaggio verso la prossima destinazione. |
COMPLETE |
Il passeggero è stato consegnato e la corsa è terminata. |
CANCELED |
La corsa è stata annullata prima del ritiro da parte dell'autista, del passeggero o del fornitore di ridesharing. |
StopLocation
Il luogo effettivo in cui si è verificata una fermata (ritiro/consegna).
Rappresentazione JSON |
---|
{
"point": {
object ( |
Campi | |
---|---|
point |
Obbligatorio. Indica la posizione effettiva. |
timestamp |
Indica quando si è verificata l'interruzione. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
stopTime |
Solo input. Deprecato. Utilizza il campo timestamp. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
TripView
Selettore per diversi insiemi di campi Viaggio in una risposta trips.get
. Per ulteriori informazioni, vedi AIP-157. È probabile che verranno aggiunte altre visualizzazioni.
Enum | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Il valore predefinito. Per la compatibilità con le versioni precedenti, l'API utilizzerà per impostazione predefinita una vista SDK. Per garantire stabilità e assistenza, consigliamo ai clienti di selezionare un TripView diverso da SDK . |
SDK |
Sono inclusi i campi che potrebbero non essere interpretabili o supportate dalle librerie disponibili pubblicamente. |
JOURNEY_SHARING_V1S |
I campi dei viaggi sono compilati per il caso d'uso della condivisione del percorso. Questa visualizzazione è pensata per le comunicazioni server-server. |
Metodi |
|
---|---|
|
Crea una corsa in Fleet Engine e restituisce la nuova corsa. |
|
Ricevere informazioni su un singolo viaggio. |
|
Visualizza tutti i viaggi per un veicolo specifico. |
|
Aggiorna i dati dei percorsi. |