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 Trip da restituire e la relativa interpretazione.
currentRouteSegmentVersion

string (Timestamp format)

Indica il timestamp minimo (escluso) per il recupero dei dati di Trip.route o Trip.current_route_segment. Se i dati del percorso non sono stati modificati dopo questo timestamp, il campo del percorso non è impostato nella risposta. Se non viene specificato un numero minimo, i dati del percorso vengono sempre recuperati.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 (escluso) per il quale vengono recuperati Trip.remaining_waypoints. Se rimangono invariati rispetto a questo timestamp, remainingWaypoints non viene impostato nella risposta. Se questo campo non viene specificato, viene sempre recuperato remainingWaypoints.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 attuale del percorso 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 stati modificati dopo questo timestamp, il campo currentRouteSegmentTraffic non è 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 On-Demand Rides and Deliveries Solution.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 (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 RFC3339 UTC "Zulu" 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 delle polilinee. La decodifica non è ancora supportata.