Method: providers.trips.get

Ricevere informazioni su un singolo viaggio.

Richiesta HTTP

GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Deve essere nel formato providers/{provider}/trips/{trip}. Il provider deve essere l'ID progetto (ad esempio sample-cloud-project) del progetto Google Cloud di cui l'account di servizio che effettua la chiamata è membro.

Parametri di ricerca

Parametri
header

object (RequestHeader)

L'intestazione della richiesta standard di Fleet Engine.
view

enum (TripView)

Il sottoinsieme di campi Trip che deve essere restituito e la relativa interpretazione.
currentRouteSegmentVersion

string (Timestamp format)

Indica il timestamp minimo (esclusivo) per il quale vengono recuperati i dati Trip.route o Trip.current_route_segment. Se i dati di route non vengono modificati dopo questo timestamp, il campo del percorso non viene impostato nella risposta. Se non viene specificato un numero minimo, i dati della route vengono sempre recuperati.

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

string (Timestamp format)

Indica il timestamp minimo (esclusivo) per il quale vengono recuperati i Trip.remaining_waypoints. Se non sono stati modificati dopo questo timestamp, gli remainingWaypoints non vengono impostati nella risposta. Se questo campo non viene specificato, remainingWaypoints viene sempre recuperato.

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

enum (PolylineFormatType)

Il formato del percorso corrente restituito, LAT_LNG_LIST_TYPE (in Trip.route) o ENCODED_POLYLINE_TYPE (in Trip.current_route_segment). Il valore predefinito è LAT_LNG_LIST_TYPE.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Indica il timestamp minimo (esclusivo) per il quale viene recuperato il valore Trip.current_route_segment_traffic. Se i dati sul traffico non vengono modificati dopo questo timestamp, il campo currentRouteSegmentTraffic non viene impostato nella risposta. Se non viene specificato un numero minimo, i dati sul traffico vengono sempre recuperati. Tieni presente che il traffico è disponibile solo per i clienti delle soluzioni on demand per le corse e le consegne.

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

string (Timestamp format)

Indica il timestamp minimo (esclusivo) per il quale vengono recuperati i dati Trip.remaining_waypoints.traffic_to_waypoint e Trip.remaining_waypoints.path_to_waypoint. Se i dati non sono stati modificati dopo questo timestamp, i campi precedenti non vengono impostati nella risposta. Se remainingWaypointsRouteVersion non è specificato, il traffico e il percorso vengono sempre recuperati.

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

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Trip.

PolylineFormatType

Il tipo di formato della polilinea.

Enum
UNKNOWN_FORMAT_TYPE Il formato non è specificato o è sconosciuto.
LAT_LNG_LIST_TYPE Un elenco di google.type.LatLng.
ENCODED_POLYLINE_TYPE Una polilinea codificata con un algoritmo di compressione della polilinea. La decodifica non è ancora supportata.