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 corsa. |
pickupPoint |
Località in cui il cliente indica che verrà ritirato. |
actualPickupPoint |
Solo input. Il luogo effettivo in cui e dove è stato ritirato il cliente. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive relative al ritiro. |
actualPickupArrivalPoint |
Solo input. L'ora e la posizione 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'ora futura stimata in cui verranno prelevati i passeggeri oppure l'ora effettiva in cui sono stati prelevati. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
intermediateDestinations[] |
Fermate intermedie in modo che la corsa richieda (oltre a prelievo e discesa). All'inizio questa funzionalità non sarà supportata per le corse condivise. |
intermediateDestinationsVersion |
Indica l'ultima volta che Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
intermediateDestinationIndex |
Quando |
actualIntermediateDestinationArrivalPoints[] |
Solo input. L'ora e la posizione effettivi dell'arrivo del conducente a una destinazione intermedia. Questo campo consente al fornitore di fornire un feedback sulle informazioni relative agli arrivi effettivi a destinazioni intermedie. |
actualIntermediateDestinations[] |
Solo input. L'ora e la località effettive in cui e dove il cliente è stato ritirato da una destinazione intermedia. Questo campo consente al fornitore di fornire un feedback sulle informazioni sul ritiro effettivo presso destinazioni intermedie. |
dropoffPoint |
Località in cui il cliente indica che verranno lasciati. |
actualDropoffPoint |
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 sull'abbandono. |
dropoffTime |
Solo output. L'ora futura stimata in cui i passeggeri verranno lasciati alla destinazione finale oppure l'ora effettiva in cui è stata consegnata. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
remainingWaypoints[] |
Solo output. Il percorso completo dalla posizione corrente al punto di uscita, inclusi. Questo percorso potrebbe includere tappe di altri viaggi. |
vehicleWaypoints[] |
Questo campo supporta l'ordinamento manuale delle tappe della corsa. Contiene tutti i punti restanti per il veicolo assegnato, nonché i punti di prelievo e di discesa della 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 nelle chiamate |
route[] |
Solo output. Percorso previsto per questo viaggio per la prima entrata nei Waypoint rimanenti. Tieni presente che il primo tappa potrebbe appartenere a una corsa diversa. |
currentRouteSegment |
Solo output. Percorso codificato per il punto di tappa successivo. 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 in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
currentRouteSegmentTraffic |
Solo output. Indica le condizioni del traffico lungo la 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 in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
currentRouteSegmentEndPoint |
Solo output. Il tappa in cui termina |
remainingDistanceMeters |
Solo output. La distanza percorsa rimanente nel campo |
etaToFirstWaypoint |
Solo output. L'orario di arrivo stimato al tappa successiva (la prima voce nel campo Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
remainingTimeToFirstWaypoint |
Solo output. La durata dal momento in cui i dati della corsa vengono restituiti al momento in Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
remainingWaypointsVersion |
Solo output. Indica l'ultima volta in cui Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
remainingWaypointsRouteVersion |
Solo output. Indica l'ultima volta che sono stati modificati Un timestamp in formato "Zulu" UTC RFC3339, 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 poter essere restituito in una risposta |
lastLocation |
Solo output. Indica l'ultima posizione segnalata del veicolo lungo il percorso. |
lastLocationSnappable |
Solo output. Indica se l'oggetto |
view |
Il sottoinsieme di campi Trip che vengono compilati e come devono essere interpretati. |
TripStatus
Lo stato di una corsa che indica il suo avanzamento.
Enum | |
---|---|
UNKNOWN_TRIP_STATUS |
Predefinita, utilizzata 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 passeggero. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
Il conducente si sta dirigendo verso una destinazione intermedia (non il punto di discesa). |
ENROUTE_TO_DROPOFF |
L'autista ha preso il passeggero e si sta dirigendo verso la prossima destinazione. |
COMPLETE |
Il passeggero è stato consegnato e la corsa è terminata. |
CANCELED |
La corsa è stata annullata prima del ritiro da parte del conducente, del passeggero o del fornitore di servizi di ridesharing. |
StopLocation
La posizione effettiva in cui si è verificata una fermata (ritiro/consegna).
Rappresentazione JSON |
---|
{
"point": {
object ( |
Campi | |
---|---|
point |
Obbligatorio. Indica la posizione effettiva. |
timestamp |
Indica quando è avvenuta l'interruzione. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
stopTime |
Solo input. Deprecato. Utilizza il campo del timestamp. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
TripView
Selettore per insiemi di campi Viaggio in una risposta trips.get
. Consulta AIP-157 per il contesto. È probabile che vengano aggiunte altre visualizzazioni.
Enum | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Il valore predefinito. Per la compatibilità con le versioni precedenti, l'API utilizza per impostazione predefinita una vista SDK. Per garantire stabilità e supporto, consigliamo ai clienti di selezionare un TripView diverso da SDK . |
SDK |
Include i campi che potrebbero non essere interpretabili o supportati quando utilizzano le librerie disponibili pubblicamente. |
JOURNEY_SHARING_V1S |
I campi Trip vengono compilati per il caso d'uso della condivisione del percorso. Questa visualizzazione è destinata alle comunicazioni server-to-server. |
Metodi |
|
---|---|
|
Crea una corsa in Fleet Engine e restituisce la nuova corsa. |
|
Ricevere informazioni su un singolo viaggio. |
|
Visualizza tutte le corse di un veicolo specifico. |
|
Aggiorna i dati del viaggio. |