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.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

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 è specificato, viene sempre recuperato remainingWaypoints.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

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 (esclusivo) per cui 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.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

remainingWaypointsRouteVersion

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

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.