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 questa chiamata è membro.

Parametri di query

Parametri
header

object (RequestHeader)

L'intestazione della richiesta Fleet Engine standard.
view

enum (TripView)

Il sottoinsieme di campi di Trip che devono essere restituiti e la relativa interpretazione.
currentRouteSegmentVersion

string (Timestamp format)

Indica il timestamp minimo (esclusivo) per cui vengono recuperati i dati Trip.route o Trip.current_route_segment. Se i dati del percorso non sono stati modificati da questo timestamp, il campo route non è impostato nella risposta. Se non è specificato un valore minimo, i dati del percorso vengono sempre recuperati.

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".
remainingWaypointsVersion

string (Timestamp format)

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

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".
routeFormatType

enum (PolylineFormatType)

Il formato della route 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 (escluso) per il quale viene recuperato Trip.current_route_segment_traffic. Se i dati sul traffico non sono cambiati da questo timestamp, il campo currentRouteSegmentTraffic non è impostato nella risposta. Se non viene specificato un valore minimo, i dati sul traffico vengono sempre recuperati. Tieni presente che il traffico è disponibile solo per i clienti della soluzione Trasporto passeggeri e consegne on demand.

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".
remainingWaypointsRouteVersion

string (Timestamp format)

Indica il timestamp minimo (escluso) per il recupero dei dati di 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 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".

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 del 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 delle polilinee. La decodifica non è ancora supportata.