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 de projet (par exemple, sample-cloud-project) du projet Google Cloud dont le compte de service à l'origine de cet appel est membre.

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 le code temporel minimal (exclusif) pour lequel les données Trip.route ou Trip.current_route_segment sont récupérées. Si les données de parcours n'ont pas changé depuis ce code temporel, le champ "route" n'est pas défini dans la réponse. Si aucun nombre minimal n'est spécifié, les données de parcours 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 (exclusif) pour lequel les Trip.remaining_waypoints sont récupérés. Si elles n'ont pas changé depuis ce code temporel, les remainingWaypoints ne sont pas définies 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 de l'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 (exclusif) pour lequel Trip.current_route_segment_traffic est récupéré. Si les données de trafic n'ont pas changé depuis ce code temporel, le champ currentRouteSegmentTraffic n'est pas défini dans la réponse. Si aucun nombre minimal n'est spécifié, les données sur le trafic sont toujours récupérées. Notez que le trafic n'est disponible que pour les clients de la solution Courses et livraisons à la demande.

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 le code temporel 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 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 à l'aide d'un algorithme de compression de polyligne. Le décodage n'est pas encore disponible.