Method: providers.trips.get

Obtenir des informations sur un seul trajet

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Doit se présenter sous la forme providers/{provider}/trips/{trip}. Le fournisseur doit être l'ID du projet Google Cloud (par exemple, sample-cloud-project) auquel appartient le compte de service qui effectue cet appel.

Paramètres de requête

Paramètres
header

object (RequestHeader)

En-tête de requête Fleet Engine standard.
view

enum (TripView)

Sous-ensemble des champs "Trip" qui doivent être renvoyés, ainsi que leur interprétation.
currentRouteSegmentVersion

string (Timestamp format)

Indique l'horodatage minimal (exclusif) pour lequel les données Trip.route ou Trip.current_route_segment sont récupérées. Si les données de l'itinéraire ne sont pas modifiées depuis cet horodatage, le champ d'itinéraire n'est pas défini dans la réponse. Si une valeur minimale n'est pas spécifiée, les données de route sont toujours récupérées.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
remainingWaypointsVersion

string (Timestamp format)

Indique le code temporel minimal (exclu) pour lequel les valeurs Trip.remaining_waypoints sont récupérées. S'ils ne sont pas modifiés depuis cet horodatage, les remainingWaypoints ne sont pas définis dans la réponse. Si ce champ n'est pas spécifié, remainingWaypoints est toujours récupéré.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
routeFormatType

enum (PolylineFormatType)

Format d'itinéraire actuel renvoyé : LAT_LNG_LIST_TYPE (dans Trip.route) ou ENCODED_POLYLINE_TYPE (dans Trip.current_route_segment). La valeur par défaut est LAT_LNG_LIST_TYPE.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Indique le code temporel minimal (exclu) pour lequel la valeur Trip.current_route_segment_traffic est récupérée. Si les données de trafic ne sont pas modifiées depuis cet horodatage, le champ currentRouteSegmentTraffic n'est pas défini dans la réponse. Si une valeur minimale n'est pas spécifiée, les données de trafic sont toujours récupérées. Notez que le trafic n'est disponible que pour les clients de la solution On-Demand Rides and Deliveries.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
remainingWaypointsRouteVersion

string (Timestamp format)

Indique l'horodatage minimal (exclusif) pour lequel les données Trip.remaining_waypoints.traffic_to_waypoint et Trip.remaining_waypoints.path_to_waypoint sont récupérées. Si les données ne sont pas modifiées depuis cet horodatage, les champs ci-dessus ne sont pas définis dans la réponse. Si remainingWaypointsRouteVersion n'est pas spécifié, le trafic et le chemin d'accès sont toujours récupérés.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Trip.

PolylineFormatType

Type de format de la polyligne.

Enums
UNKNOWN_FORMAT_TYPE Le format n'est pas spécifié ou est inconnu.
LAT_LNG_LIST_TYPE Liste de google.type.LatLng.
ENCODED_POLYLINE_TYPE Polyligne encodée avec un algorithme de compression de polylignes. Le décodage n'est pas encore pris en charge.