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" (Voyage) à renvoyer et 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 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.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

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é.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

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.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

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 n'ont pas changé depuis ce code temporel, 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 sont toujours récupérés.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

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.