L'API Routes Preferred n'est actuellement disponible que pour certains clients. Contactez le service commercial pour en savoir plus.

Cette page a été traduite par l'API Cloud Translation.

Package google.maps.routes.v1

Index

RoutesPreferred (interface)
ComputeCustomRoutesRequest (message)
ComputeCustomRoutesResponse (message)
ComputeCustomRoutesResponse.FallbackInfo (message)
ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective (enum)
ComputeRouteMatrixRequest (message)
ComputeRoutesRequest (message)
ComputeRoutesResponse (message)
CustomRoute (message)
FallbackInfo (message)
FallbackReason (enum)
FallbackRoutingMode (enum)
Location (message)
Maneuver (enum)
NavigationInstruction (message)
Polyline (message)
PolylineEncoding (enum)
PolylineQuality (enum)
Route (message)
RouteLeg (message)
RouteLegStep (message)
RouteLegStepTravelAdvisory (message)
RouteLegTravelAdvisory (message)
RouteMatrixDestination (message)
RouteMatrixElement (message)
RouteMatrixElementCondition (enum)
RouteMatrixOrigin (message)
RouteModifiers (message)
RouteObjective (message)
RouteObjective.RateCard (message)
RouteObjective.RateCard.MonetaryCost (message)
RouteTravelAdvisory (message)
RouteTravelMode (enum)
RoutingPreference (enum)
SpeedReadingInterval (message)
SpeedReadingInterval.Speed (enum)
TollInfo (message)
TollPass (enum)
Units (enum)
VehicleEmissionType (enum)
VehicleInfo (message)
Waypoint (message)

RoutesPreferred

API Routes Preferred

ComputeCustomRoutes

ComputeCustomRoutes
`rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)` Calcule le meilleur itinéraire pour cet objectif à partir d'un ensemble de points de cheminement terminaux et intermédiaires, et d'un objectif d'itinéraire. Affiche également l'itinéraire le plus rapide et l'itinéraire le plus court en tant qu'itinéraires de référence. REMARQUE:Cette méthode nécessite que vous spécifiiez un masque de champ de réponse dans l'entrée. Vous pouvez fournir le masque de champ de réponse à l'aide du paramètre d'URL `$fields` ou `fields`, ou de l'en-tête HTTP/gRPC `X-Goog-FieldMask` (consultez Paramètres et en-têtes d'URL disponibles. La valeur est une liste de chemins d'accès de champs séparés par une virgule. Consultez cette documentation détaillée sur la création des chemins d'accès aux champs. Par exemple, dans cette méthode: Masque de champ de tous les champs disponibles (pour l'inspection manuelle): `X-Goog-FieldMask: ` Masque de champ des distances de l'itinéraire, des durées, des jetons et des informations sur les péages: `X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo` Google déconseille l'utilisation du masque de champ de réponse utilisant le caractère générique (``) ou la spécification de ce masque de champ au niveau supérieur (`routes`) pour les raisons suivantes: Sélectionner uniquement les champs dont vous avez besoin permet à notre serveur d'économiser des cycles de calcul et de vous renvoyer le résultat avec une latence plus faible. Sélectionner uniquement les champs dont vous avez besoin pour votre job de production garantit des performances de latence stables. Nous pourrions ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter du temps de calcul supplémentaire. Si vous sélectionnez tous les champs, ou tous les champs au niveau supérieur, vous risquez de constater une dégradation des performances, car tout nouveau champ que nous ajoutons sera automatiquement inclus dans la réponse. Si vous ne sélectionnez que les champs dont vous avez besoin, vous réduirez la taille des réponses et, par conséquent, le débit du réseau. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : `https://www.googleapis.com/auth/maps-platform.routespreferred` Pour en savoir plus, consultez la présentation d'OAuth 2.0.

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Calcule le meilleur itinéraire pour cet objectif à partir d'un ensemble de points de cheminement terminaux et intermédiaires, et d'un objectif d'itinéraire. Affiche également l'itinéraire le plus rapide et l'itinéraire le plus court en tant qu'itinéraires de référence.

REMARQUE:Cette méthode nécessite que vous spécifiiez un masque de champ de réponse dans l'entrée. Vous pouvez fournir le masque de champ de réponse à l'aide du paramètre d'URL $fields ou fields, ou de l'en-tête HTTP/gRPC X-Goog-FieldMask (consultez Paramètres et en-têtes d'URL disponibles. La valeur est une liste de chemins d'accès de champs séparés par une virgule. Consultez cette documentation détaillée sur la création des chemins d'accès aux champs.

Par exemple, dans cette méthode:

Masque de champ de tous les champs disponibles (pour l'inspection manuelle): X-Goog-FieldMask: *
Masque de champ des distances de l'itinéraire, des durées, des jetons et des informations sur les péages: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Google déconseille l'utilisation du masque de champ de réponse utilisant le caractère générique (*) ou la spécification de ce masque de champ au niveau supérieur (routes) pour les raisons suivantes:

Sélectionner uniquement les champs dont vous avez besoin permet à notre serveur d'économiser des cycles de calcul et de vous renvoyer le résultat avec une latence plus faible.
Sélectionner uniquement les champs dont vous avez besoin pour votre job de production garantit des performances de latence stables. Nous pourrions ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter du temps de calcul supplémentaire. Si vous sélectionnez tous les champs, ou tous les champs au niveau supérieur, vous risquez de constater une dégradation des performances, car tout nouveau champ que nous ajoutons sera automatiquement inclus dans la réponse.
Si vous ne sélectionnez que les champs dont vous avez besoin, vous réduirez la taille des réponses et, par conséquent, le débit du réseau.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

https://www.googleapis.com/auth/maps-platform.routespreferred

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

ComputeRouteMatrix

ComputeRouteMatrix
`rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)` Se base sur une liste de points de départ et de destinations, et renvoie un flux contenant des informations sur l'itinéraire pour chaque combinaison de points de départ et d'arrivée. REMARQUE:Cette méthode nécessite que vous spécifiiez un masque de champ de réponse dans l'entrée. Vous pouvez fournir le masque de champ de réponse à l'aide du paramètre d'URL `$fields` ou `fields`, ou de l'en-tête HTTP/gRPC `X-Goog-FieldMask` (consultez Paramètres et en-têtes d'URL disponibles. La valeur est une liste de chemins d'accès de champs séparés par une virgule. Consultez cette documentation détaillée sur la création des chemins d'accès aux champs. Par exemple, dans cette méthode: Masque de champ de tous les champs disponibles (pour l'inspection manuelle): `X-Goog-FieldMask: ` Masque de champ contenant la durée de l'itinéraire, les distances, l'état des éléments, l'état et les indices des éléments (exemple de configuration de production): `X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` Il est essentiel d'inclure `status` dans votre masque de champ, sinon tous les messages s'afficheront correctement. Google déconseille l'utilisation du masque de champ de réponse utilisant le caractère générique (``) pour les raisons suivantes: Sélectionner uniquement les champs dont vous avez besoin permet à notre serveur d'économiser des cycles de calcul et de vous renvoyer le résultat avec une latence plus faible. Sélectionner uniquement les champs dont vous avez besoin pour votre job de production garantit des performances de latence stables. Nous pourrions ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter du temps de calcul supplémentaire. Si vous sélectionnez tous les champs, ou tous les champs au niveau supérieur, vous risquez de constater une dégradation des performances, car tout nouveau champ que nous ajoutons sera automatiquement inclus dans la réponse. Si vous ne sélectionnez que les champs dont vous avez besoin, vous réduirez la taille des réponses et, par conséquent, le débit du réseau. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : `https://www.googleapis.com/auth/maps-platform.routespreferred` Pour en savoir plus, consultez la présentation d'OAuth 2.0.

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Se base sur une liste de points de départ et de destinations, et renvoie un flux contenant des informations sur l'itinéraire pour chaque combinaison de points de départ et d'arrivée.

Par exemple, dans cette méthode:

Masque de champ de tous les champs disponibles (pour l'inspection manuelle): X-Goog-FieldMask: *
Masque de champ contenant la durée de l'itinéraire, les distances, l'état des éléments, l'état et les indices des éléments (exemple de configuration de production): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Il est essentiel d'inclure status dans votre masque de champ, sinon tous les messages s'afficheront correctement. Google déconseille l'utilisation du masque de champ de réponse utilisant le caractère générique (*) pour les raisons suivantes:

Sélectionner uniquement les champs dont vous avez besoin permet à notre serveur d'économiser des cycles de calcul et de vous renvoyer le résultat avec une latence plus faible.
Sélectionner uniquement les champs dont vous avez besoin pour votre job de production garantit des performances de latence stables. Nous pourrions ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter du temps de calcul supplémentaire. Si vous sélectionnez tous les champs, ou tous les champs au niveau supérieur, vous risquez de constater une dégradation des performances, car tout nouveau champ que nous ajoutons sera automatiquement inclus dans la réponse.
Si vous ne sélectionnez que les champs dont vous avez besoin, vous réduirez la taille des réponses et, par conséquent, le débit du réseau.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

https://www.googleapis.com/auth/maps-platform.routespreferred

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)` Affiche l'itinéraire principal ainsi que les autres itinéraires facultatifs, en fonction d'un ensemble de points de cheminement terminaux et intermédiaires. REMARQUE:Cette méthode nécessite que vous spécifiiez un masque de champ de réponse dans l'entrée. Vous pouvez fournir le masque de champ de réponse à l'aide du paramètre d'URL `$fields` ou `fields`, ou d'un en-tête HTTP/gRPC `X-Goog-FieldMask` (consultez Paramètres et en-têtes d'URL disponibles. La valeur est une liste de chemins d'accès de champs séparés par une virgule. Consultez la documentation détaillée sur la création des chemins d'accès aux champs. Par exemple, dans cette méthode: Masque de champ de tous les champs disponibles (pour l'inspection manuelle): `X-Goog-FieldMask: ` Masque de champ de durée, distance et polyligne au niveau de l'itinéraire (exemple de configuration de production): `X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline` Google déconseille l'utilisation du masque de champ de réponse utilisant le caractère générique (``) ou la spécification de ce masque de champ au niveau supérieur (`routes`) pour les raisons suivantes: Sélectionner uniquement les champs dont vous avez besoin permet à notre serveur d'économiser des cycles de calcul et de vous renvoyer le résultat avec une latence plus faible. Sélectionner uniquement les champs dont vous avez besoin pour votre job de production garantit des performances de latence stables. Nous pourrions ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter du temps de calcul supplémentaire. Si vous sélectionnez tous les champs, ou tous les champs au niveau supérieur, vous risquez de constater une dégradation des performances, car tout nouveau champ que nous ajoutons sera automatiquement inclus dans la réponse. Si vous ne sélectionnez que les champs dont vous avez besoin, vous réduirez la taille des réponses et, par conséquent, le débit du réseau. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : `https://www.googleapis.com/auth/maps-platform.routespreferred` Pour en savoir plus, consultez la présentation d'OAuth 2.0.

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Affiche l'itinéraire principal ainsi que les autres itinéraires facultatifs, en fonction d'un ensemble de points de cheminement terminaux et intermédiaires.

REMARQUE:Cette méthode nécessite que vous spécifiiez un masque de champ de réponse dans l'entrée. Vous pouvez fournir le masque de champ de réponse à l'aide du paramètre d'URL $fields ou fields, ou d'un en-tête HTTP/gRPC X-Goog-FieldMask (consultez Paramètres et en-têtes d'URL disponibles. La valeur est une liste de chemins d'accès de champs séparés par une virgule. Consultez la documentation détaillée sur la création des chemins d'accès aux champs.

Par exemple, dans cette méthode:

Masque de champ de tous les champs disponibles (pour l'inspection manuelle): X-Goog-FieldMask: *
Masque de champ de durée, distance et polyligne au niveau de l'itinéraire (exemple de configuration de production): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Sélectionner uniquement les champs dont vous avez besoin permet à notre serveur d'économiser des cycles de calcul et de vous renvoyer le résultat avec une latence plus faible.
Sélectionner uniquement les champs dont vous avez besoin pour votre job de production garantit des performances de latence stables. Nous pourrions ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter du temps de calcul supplémentaire. Si vous sélectionnez tous les champs, ou tous les champs au niveau supérieur, vous risquez de constater une dégradation des performances, car tout nouveau champ que nous ajoutons sera automatiquement inclus dans la réponse.
Si vous ne sélectionnez que les champs dont vous avez besoin, vous réduirez la taille des réponses et, par conséquent, le débit du réseau.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

https://www.googleapis.com/auth/maps-platform.routespreferred

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

ComputeCustomRoutesRequest

Message de requête ComputeCustomRoutes.

Champs
`origin`	`Waypoint` Obligatoire. Point de cheminement de départ.
`destination`	`Waypoint` Obligatoire. Point de cheminement de destination.
`intermediates[]`	`Waypoint` Facultatif. Ensemble de points de cheminement sur l'itinéraire (à l'exclusion des terminaux) permettant de s'arrêter ou de passer à proximité. Vous pouvez ajouter jusqu'à 25 points de cheminement intermédiaires.
`travel_mode`	`RouteTravelMode` Facultatif. Spécifie le mode de transport. Seul DRIVE est compatible à l'heure actuelle.
`routing_preference`	`RoutingPreference` Facultatif. Spécifie comment calculer la route. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer la route. Si la préférence de routage entraîne une erreur ou une latence extra longue, une erreur est renvoyée. À l'avenir, nous pourrons mettre en place un mécanisme de remplacement permettant d'utiliser une option différente lorsque l'option préférée ne donnera pas de résultat valide. Vous ne pouvez spécifier cette option que si `travel_mode` est défini sur `DRIVE` ou `TWO_WHEELER`. Sinon, la requête échoue.
`polyline_quality`	`PolylineQuality` Facultatif. Indique votre préférence pour la qualité de la polyligne.
`polyline_encoding`	`PolylineEncoding` Facultatif. Spécifie l'encodage préféré pour la polyligne.
`departure_time`	`Timestamp` Facultatif. Heure de départ. Si vous ne définissez pas cette valeur, elle est définie par défaut sur l'heure à laquelle vous avez effectué la requête. Si vous définissez cette valeur sur une heure déjà passée, la requête échoue.
`route_modifiers`	`RouteModifiers` Facultatif. Ensemble de conditions à remplir qui affectent le mode de calcul des itinéraires.
`route_objective`	`RouteObjective` Obligatoire. Objectif d'itinéraire à optimiser.
`language_code`	`string` Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Consultez la page Langues acceptées pour obtenir la liste des langues acceptées. Si vous ne fournissez pas cette valeur, la langue d'affichage est déduite de l'emplacement de la requête d'itinéraire.
`units`	`Units` Facultatif. Spécifie les unités de mesure des champs d'affichage. Cela inclut le champ `instruction` dans `NavigationInstruction`. Cette valeur n'a aucune incidence sur les unités de mesure utilisées pour l'itinéraire, le trajet, la distance de pas et la durée. Si vous ne fournissez pas cette valeur, les unités d'affichage sont déduites de l'emplacement de la requête.

ComputeCustomRoutesResponse

Message de réponse ComputeCustomRoutes.

Champs
`routes[]`	`CustomRoute` "meilleurs" itinéraires pour l'objectif de route d'entrée.
`fastest_route`	`CustomRoute` Itinéraire de référence le plus rapide.
`shortest_route`	`CustomRoute` Itinéraire de référence le plus court.
`fallback_info`	`FallbackInfo` Informations de remplacement pour les routes personnalisées.

FallbackInfo

Encapsule les informations de remplacement pour ComputeCustomRoutes. ComputeCustomRoutes effectue deux types de remplacement:

S'il ne peut pas calculer l'itinéraire à l'aide de la valeur de routage_preference demandée par le client, il utilise un autre mode de routage. Dans ce cas, les valeurs "fallback_Routing_mode" et "Routing_mode_fallback_reason" sont utilisées pour communiquer le mode de routage de remplacement utilisé, ainsi que le motif du remplacement.
S'il ne peut pas calculer le "meilleur" itinéraire pour l'objectif d'itinéraire spécifié par le client, il peut se tourner vers un autre objectif. "fallback_route_objective" permet de communiquer l'objectif d'itinéraire de remplacement.

Champs

Champs
`routing_mode`	`FallbackRoutingMode` Mode de routage utilisé pour la réponse. Si un remplacement a été déclenché, le mode peut être différent de la préférence de routage définie dans la requête client d'origine.
`routing_mode_reason`	`FallbackReason` Raison pour laquelle la réponse de remplacement a été utilisée plutôt que la réponse d'origine. Ce champ n'est renseigné que lorsque le mode de remplacement est déclenché et que la réponse de remplacement est renvoyée.
`route_objective`	`FallbackRouteObjective` Objectif de route utilisé pour la réponse. Si un remplacement a été déclenché, l'objectif peut être différent de celui fourni dans la requête d'origine du client.

routing_mode

FallbackRoutingMode

Mode de routage utilisé pour la réponse. Si un remplacement a été déclenché, le mode peut être différent de la préférence de routage définie dans la requête client d'origine.

routing_mode_reason

FallbackReason

Raison pour laquelle la réponse de remplacement a été utilisée plutôt que la réponse d'origine. Ce champ n'est renseigné que lorsque le mode de remplacement est déclenché et que la réponse de remplacement est renvoyée.

route_objective

FallbackRouteObjective

Objectif de route utilisé pour la réponse. Si un remplacement a été déclenché, l'objectif peut être différent de celui fourni dans la requête d'origine du client.

FallbackRouteObjective

RouteObjectif utilisé pour la réponse.

Enums
`FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED`	Objectif de route de remplacement non spécifié.
`FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA`	Si le client demande le tableau des tarifs et définit include_tolls sur true, et que Google ne dispose d'aucune donnée concernant les péages pour l'itinéraire, l'API utilise RateCard sans tenir compte de ces frais.

ComputeRouteMatrixRequest

Message de requête ComputeRouteMatrix

Champs
`origins[]`	`RouteMatrixOrigin` Obligatoire. Tableau des origines, qui détermine les lignes de la matrice de réponse. Plusieurs restrictions de taille s'appliquent à la cardinalité des points de départ et des destinations: Le nombre d'éléments (points de départ × destinations) ne doit pas dépasser 625. Le nombre d'éléments (origines × destinations) ne doit pas être supérieur à 100 si le paramètre "Routing_preference" est défini sur `TRAFFIC_AWARE_OPTIMAL`. Le nombre de points de cheminement (points de départ + destinations) spécifié dans `place_id` ne doit pas être supérieur à 50.
`destinations[]`	`RouteMatrixDestination` Obligatoire. Tableau de destinations, qui détermine les colonnes de la matrice de réponse.
`travel_mode`	`RouteTravelMode` Facultatif. Spécifie le mode de transport.
`routing_preference`	`RoutingPreference` Facultatif. Spécifie comment calculer la route. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer la route. Si la préférence de routage génère une erreur ou une latence extra longue, une erreur est renvoyée. À l'avenir, nous pourrons mettre en place un mécanisme de remplacement permettant d'utiliser une option différente lorsque l'option préférée ne donnera pas de résultat valide. Vous ne pouvez spécifier cette option que si `travel_mode` est défini sur `DRIVE` ou `TWO_WHEELER`. Sinon, la requête échoue.
`departure_time`	`Timestamp` Facultatif. Heure de départ. Si vous ne définissez pas cette valeur, la valeur par défaut est l'heure à laquelle vous avez effectué la requête. Si vous définissez cette valeur sur une heure déjà passée, la requête échoue.

ComputeRoutesRequest

Message de requête ComputeRoutes.

Champs
`origin`	`Waypoint` Obligatoire. Point de cheminement de départ.
`destination`	`Waypoint` Obligatoire. Point de cheminement de destination.
`intermediates[]`	`Waypoint` Facultatif. Ensemble de points de cheminement sur l'itinéraire (à l'exclusion des terminaux) permettant de s'arrêter ou de passer à proximité. Vous pouvez ajouter jusqu'à 25 points de cheminement intermédiaires.
`travel_mode`	`RouteTravelMode` Facultatif. Spécifie le mode de transport.
`routing_preference`	`RoutingPreference` Facultatif. Spécifie comment calculer la route. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer la route. Si la préférence de routage entraîne une erreur ou une latence extra longue, une erreur est renvoyée. À l'avenir, nous pourrons mettre en place un mécanisme de remplacement permettant d'utiliser une option différente lorsque l'option préférée ne donnera pas de résultat valide. Vous ne pouvez spécifier cette option que si `travel_mode` est défini sur `DRIVE` ou `TWO_WHEELER`. Sinon, la requête échoue.
`polyline_quality`	`PolylineQuality` Facultatif. Indique votre préférence pour la qualité de la polyligne.
`polyline_encoding`	`PolylineEncoding` Facultatif. Spécifie l'encodage préféré pour la polyligne.
`departure_time`	`Timestamp` Facultatif. Heure de départ. Si vous ne définissez pas cette valeur, elle est définie par défaut sur l'heure à laquelle vous avez effectué la requête. Si vous définissez cette valeur sur une heure déjà passée, la requête échoue.
`compute_alternative_routes`	`bool` Indique si des itinéraires alternatifs doivent être calculés en plus de l'itinéraire.
`route_modifiers`	`RouteModifiers` Facultatif. Ensemble de conditions à remplir qui affectent le mode de calcul des itinéraires.
`language_code`	`string` Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Consultez la page Langues acceptées pour obtenir la liste des langues acceptées. Si vous ne fournissez pas cette valeur, la langue d'affichage est déduite de l'emplacement de la requête d'itinéraire.
`units`	`Units` Facultatif. Spécifie les unités de mesure des champs d'affichage. Cela inclut le champ `instruction` dans `NavigationInstruction`. Cette valeur n'a aucune incidence sur les unités de mesure utilisées pour l'itinéraire, le trajet, la distance de pas et la durée. Si vous ne fournissez pas cette valeur, les unités d'affichage sont déduites de l'emplacement de la requête.
`optimize_waypoint_order`	`bool` Si optimiserWaypointOrder est défini sur "true", une tentative est effectuée pour réorganiser les points de cheminement intermédiaires spécifiés afin de réduire le coût global de l'itinéraire. Si l'un des points de cheminement intermédiaires est via un point de cheminement, la requête échoue. Utilisez ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index pour identifier le nouvel ordre. Si routes.Optimized_intermediate_waypoint_index n'est pas demandé dans l'en-tête `X-Goog-FieldMask`, la requête échoue. Si OptimizeWaypointOrder est défini sur "false", l'élément ComputeRoutesResponse.optimized_intermediate_waypoint_index est vide.

ComputeRoutesResponse

ComputeRoutes le message de réponse.

Champs

Champs
`routes[]`	`Route` Contient un tableau des itinéraires calculés (jusqu'à trois) lorsque vous spécifiez compute_alternatives_routes, et ne contient qu'un seul itinéraire dans le cas contraire. Lorsque ce tableau contient plusieurs entrées, la première est l'itinéraire le plus recommandé. Si le tableau est vide, cela signifie qu'aucune route n'a pu être trouvée.
`fallback_info`	`FallbackInfo` Dans certains cas, lorsque le serveur n'est pas en mesure de calculer les résultats d'itinéraires avec toutes vos préférences d'entrée, il peut avoir recours à une autre méthode de calcul. Lorsque le mode de remplacement est utilisé, ce champ contient des informations détaillées sur la réponse de remplacement. Sinon, ce champ n'est pas défini.

routes[]

Route

Contient un tableau des itinéraires calculés (jusqu'à trois) lorsque vous spécifiez compute_alternatives_routes, et ne contient qu'un seul itinéraire dans le cas contraire. Lorsque ce tableau contient plusieurs entrées, la première est l'itinéraire le plus recommandé. Si le tableau est vide, cela signifie qu'aucune route n'a pu être trouvée.

fallback_info

FallbackInfo

Dans certains cas, lorsque le serveur n'est pas en mesure de calculer les résultats d'itinéraires avec toutes vos préférences d'entrée, il peut avoir recours à une autre méthode de calcul. Lorsque le mode de remplacement est utilisé, ce champ contient des informations détaillées sur la réponse de remplacement. Sinon, ce champ n'est pas défini.

CustomRoute

Encapsule une route personnalisée calculée en fonction de l'objectif de routage spécifié par le client. CustomRouter contient un itinéraire et un jeton d'itinéraire, qui peuvent être transmis au NavSDK afin de reconstruire l'itinéraire personnalisé pour la navigation détaillée.

Champs

Champs
`route`	`Route` Route considérée comme "meilleure" pour l'objectif de route d'entrée.
`token`	`string` Jeton de route encodé en base64 adapté au Web qui peut être transmis à NavSDK, ce qui permet à ce dernier de reconstruire l'itinéraire pendant la navigation et, en cas de réacheminement, de respecter l'intention d'origine lorsque RoutesPreferred ComputeCustomRoutes est appelée. Les clients doivent traiter ce jeton comme un blob opaque.

route

Route

Route considérée comme "meilleure" pour l'objectif de route d'entrée.

token

string

Jeton de route encodé en base64 adapté au Web qui peut être transmis à NavSDK, ce qui permet à ce dernier de reconstruire l'itinéraire pendant la navigation et, en cas de réacheminement, de respecter l'intention d'origine lorsque RoutesPreferred ComputeCustomRoutes est appelée. Les clients doivent traiter ce jeton comme un blob opaque.

FallbackInfo

Informations expliquant comment et pourquoi un résultat de remplacement a été utilisé. Si ce champ est défini, cela signifie que le serveur a utilisé en remplacement un mode de routage différent de votre mode préféré.

Champs

Champs
`routing_mode`	`FallbackRoutingMode` Mode de routage utilisé pour la réponse. Si un remplacement a été déclenché, le mode peut être différent de la préférence de routage définie dans la requête client d'origine.
`reason`	`FallbackReason` Raison pour laquelle la réponse de remplacement a été utilisée plutôt que la réponse d'origine. Ce champ n'est renseigné que lorsque le mode de remplacement est déclenché et que la réponse de remplacement est renvoyée.

routing_mode

FallbackRoutingMode

Mode de routage utilisé pour la réponse. Si un remplacement a été déclenché, le mode peut être différent de la préférence de routage définie dans la requête client d'origine.

reason

FallbackReason

FallbackReason

Raisons d'utiliser une réponse de remplacement.

Enums
`FALLBACK_REASON_UNSPECIFIED`	Aucun motif de remplacement spécifié.
`SERVER_ERROR`	Une erreur de serveur s'est produite lors du calcul des itinéraires avec votre mode de routage préféré, mais nous avons pu renvoyer un résultat calculé à l'aide d'un autre mode.
`LATENCY_EXCEEDED`	Nous n'avons pas pu terminer le calcul avec votre mode de routage préféré à temps, mais nous avons pu renvoyer un résultat calculé par un autre mode.

FallbackRoutingMode

Mode de routage réel utilisé pour la réponse de remplacement renvoyée.

Enums
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	Non utilisé.
`FALLBACK_TRAFFIC_UNAWARE`	Indique que le mode de routage "TRAFFIC_UNAWARE" a été utilisé pour calculer la réponse.
`FALLBACK_TRAFFIC_AWARE`	Indique que le mode de routage "TRAFFIC_AWARE" a été utilisé pour calculer la réponse.

Emplacement

Encapsule un lieu (un point géographique et un titre facultatif).

Champs

Champs
`lat_lng`	`LatLng` Coordonnées géographiques du point de cheminement.
`heading`	`Int32Value` Orientation de la boussole associée au sens du trafic. Cette valeur permet d'indiquer le côté de la route à utiliser pour les montées et les descentes. Les valeurs de titre peuvent être comprises entre 0 et 360, où 0 indique une direction en direction du nord, 90 indique un cap en raison de l'est, etc. Vous ne pouvez utiliser ce champ que pour les modes de transport `DRIVE` et `TWO_WHEELER`.

lat_lng

LatLng

Coordonnées géographiques du point de cheminement.

heading

Int32Value

Orientation de la boussole associée au sens du trafic. Cette valeur permet d'indiquer le côté de la route à utiliser pour les montées et les descentes. Les valeurs de titre peuvent être comprises entre 0 et 360, où 0 indique une direction en direction du nord, 90 indique un cap en raison de l'est, etc. Vous ne pouvez utiliser ce champ que pour les modes de transport DRIVE et TWO_WHEELER.

Manœuvre

Ensemble de valeurs spécifiant l'action de navigation à effectuer pour l'étape en cours (par exemple, tourner à gauche, fusionner, tout droit, etc.).

Enums
`MANEUVER_UNSPECIFIED`	Non utilisé.
`TURN_SLIGHT_LEFT`	Tournez légèrement vers la gauche.
`TURN_SHARP_LEFT`	Tournez complètement vers la gauche.
`UTURN_LEFT`	Faites un demi-tour à gauche.
`TURN_LEFT`	Tournez à gauche.
`TURN_SLIGHT_RIGHT`	Tournez légèrement vers la droite.
`TURN_SHARP_RIGHT`	Tournez complètement vers la droite.
`UTURN_RIGHT`	Faites un demi-tour vers la droite.
`TURN_RIGHT`	Tournez à droite.
`STRAIGHT`	Allez tout droit.
`RAMP_LEFT`	Prendre la rampe de gauche.
`RAMP_RIGHT`	Prenez la bonne rampe.
`MERGE`	Fusionner dans les embouteillages.
`FORK_LEFT`	Prendre la bifurcation à gauche.
`FORK_RIGHT`	Prenez la bifurcation à droite.
`FERRY`	Prenez le ferry.
`FERRY_TRAIN`	Prendre le train qui mène au ferry.
`ROUNDABOUT_LEFT`	Au rond-point, tournez à gauche.
`ROUNDABOUT_RIGHT`	Au rond-point, tournez à droite.

NavigationInstruction

Champs

maneuver

Maneuver

Encapsule les instructions de navigation pour l'étape actuelle (par exemple, tourner à gauche, fusionner, droite, etc.). Ce champ détermine l'icône à afficher.

instructions

string

Instructions pour suivre cette étape.

Polyline

Encapsule une polyligne encodée.

Champs

Champs
Champ d'union `polyline_type`. Encapsule le type de polyligne. La valeur par défaut est coded_polyline. `polyline_type` ne peut être qu'un des éléments suivants :
`encoded_polyline`	`string` Encoder la chaîne de la polyligne à l'aide de l'algorithme d'encodage des polylignes
`geo_json_linestring`	`Struct` Spécifie une polyligne au format GeoJSON LineString.

Champ d'union polyline_type. Encapsule le type de polyligne. La valeur par défaut est coded_polyline. polyline_type ne peut être qu'un des éléments suivants :

encoded_polyline

string

Encoder la chaîne de la polyligne à l'aide de l'algorithme d'encodage des polylignes

geo_json_linestring

Struct

Spécifie une polyligne au format GeoJSON LineString.

PolylineEncoding

Spécifie le type de polyligne préféré à renvoyer.

Enums
`POLYLINE_ENCODING_UNSPECIFIED`	Aucune préférence spécifiée pour le type de polyligne. La valeur par défaut est `ENCODED_POLYLINE`.
`ENCODED_POLYLINE`	Spécifie une polyligne encodée à l'aide de l'algorithme d'encodage des polylignes.
`GEO_JSON_LINESTRING`	Spécifie une polyligne au format GeoJSON LineString.

PolylineQuality

Ensemble de valeurs qui spécifient la qualité de la polyligne.

Enums
`POLYLINE_QUALITY_UNSPECIFIED`	Aucune préférence en matière de qualité des polylignes n'a été spécifiée. La valeur par défaut est `OVERVIEW`.
`HIGH_QUALITY`	Spécifie une polyligne de haute qualité, composée à l'aide d'un plus grand nombre de points que `OVERVIEW`, au détriment de la taille des réponses. Utilisez cette valeur lorsque vous avez besoin de plus de précision.
`OVERVIEW`	Spécifie une polyligne de présentation, composée d'un petit nombre de points. Utilisez cette valeur pour afficher une vue d'ensemble de l'itinéraire. Avec cette option, la latence des requêtes est plus faible que celle de l'option `HIGH_QUALITY`.

Route

Encapsule un itinéraire composé d'une série de sections de route connectées qui relient des points de départ, d'arrivée et intermédiaires.

Champs
`legs[]`	`RouteLeg` Ensemble de sections (segments de chemin entre les points de cheminement) qui composent l'itinéraire. Chaque section correspond à un trajet entre deux points de cheminement non-`via`. Par exemple, un itinéraire sans point de cheminement intermédiaire ne comporte qu'une seule section. Un itinéraire qui comprend un point de cheminement intermédiaire autre que `via` comporte deux sections. Un itinéraire qui comprend un point de cheminement `via` intermédiaire comporte une section. L'ordre des étapes correspond à l'ordre des points de cheminement entre `origin`, `intermediates` et `destination`.
`distance_meters`	`int32` Distance de l'itinéraire, en mètres.
`duration`	`Duration` Temps nécessaire pour parcourir l'itinéraire. Si vous définissez `routing_preference` sur `TRAFFIC_UNAWARE`, cette valeur est identique à `static_duration`. Si vous définissez `routing_preference` sur `TRAFFIC_AWARE` ou `TRAFFIC_AWARE_OPTIMAL`, cette valeur est calculée en tenant compte des conditions de circulation.
`static_duration`	`Duration` Durée du trajet pour l'itinéraire sans tenir compte des conditions de circulation
`polyline`	`Polyline` Polyligne de l'itinéraire global. Cette polyligne sera la polyligne combinée de tous les `legs`.
`description`	`string` Description de l'itinéraire.
`warnings[]`	`string` Tableau d'avertissements à afficher lors de l'affichage de l'itinéraire.
`viewport`	`Viewport` Cadre de délimitation de la fenêtre d'affichage de la polyligne.
`travel_advisory`	`RouteTravelAdvisory` Informations supplémentaires sur l'itinéraire.
`optimized_intermediate_waypoint_index[]`	`int32` Si ComputeRoutesRequest.optimize_waypoint_order est défini sur "true", ce champ contient l'ordre optimisé des points de cheminement intermédiaires. Sinon, ce champ est vide. Par exemple, supposons que l'entrée soit "Origine: Los Angeles", "Niveau intermédiaire: Dallas, Bangor, Phoenix" ; Destination: New York ; et que l'ordre des points de cheminement intermédiaire optimisé soit: Phoenix, Dallas, Bangor. Ce champ contient alors les valeurs [2, 0, 1]. L'index commence par 0 pour le premier point de cheminement intermédiaire.

RouteLeg

Encapsule un segment entre des points de cheminement non-via.

Champs
`distance_meters`	`int32` Distance parcourue pour le trajet de l'itinéraire, en mètres.
`duration`	`Duration` Temps nécessaire pour parcourir l'étape. Si `route_preference` est défini sur `TRAFFIC_UNAWARE`, cette valeur est identique à `static_duration`. Si `route_preference` correspond à `TRAFFIC_AWARE` ou `TRAFFIC_AWARE_OPTIMAL`, cette valeur est calculée en tenant compte des conditions de circulation.
`static_duration`	`Duration` Durée du trajet pour le trajet, calculée sans tenir compte des conditions de circulation.
`polyline`	`Polyline` Polyligne globale de cette section. Cela inclut la polyligne de chaque `step`.
`start_location`	`Location` Lieu de départ de cette section. Il peut être différent du `origin` fourni. Par exemple, lorsque le `origin` fourni ne se trouve pas à proximité d'une route, il s'agit d'un point sur la route.
`end_location`	`Location` Lieu d'arrivée de cette section. Il peut être différent du `destination` fourni. Par exemple, lorsque le `destination` fourni ne se trouve pas à proximité d'une route, il s'agit d'un point sur la route.
`steps[]`	`RouteLegStep` Tableau d'étapes indiquant les segments de cette section. Chaque étape représente une instruction de navigation.
`travel_advisory`	`RouteLegTravelAdvisory` Encapsule les informations supplémentaires dont l'utilisateur doit être informé, telles que les éventuelles restrictions de zone de circulation sur une section de l'itinéraire.

RouteLegStep

Encapsule un segment de RouteLeg. Une étape correspond à une seule instruction de navigation. Les sections d'itinéraire sont composées d'étapes.

Champs
`distance_meters`	`int32` Distance parcourue pour cette étape, en mètres. Dans certains cas, ce champ peut ne pas comporter de valeur.
`static_duration`	`Duration` Durée du trajet pour cette étape sans tenir compte des conditions de circulation Dans certains cas, ce champ peut ne pas comporter de valeur.
`polyline`	`Polyline` Polyligne associée à cette étape.
`start_location`	`Location` Lieu de départ de cette étape.
`end_location`	`Location` Lieu d'arrivée de cette étape.
`navigation_instruction`	`NavigationInstruction` des instructions de navigation ;
`travel_advisory`	`RouteLegStepTravelAdvisory` Encapsule les informations supplémentaires dont l'utilisateur doit être informé, comme une possible restriction de zone de trafic sur une étape de l'étape.

RouteLegStepTravelAdvisory

Encapsule les informations supplémentaires dont l'utilisateur doit être informé, comme une possible restriction de zone de trafic sur une étape de l'étape.

Champs

Champs
`speed_reading_intervals[]`	`SpeedReadingInterval` Intervalles de lecture de vitesse détaillant la densité du trafic. Applicable en cas de préférences de routage `TRAFFIC_AWARE` et `TRAFFIC_AWARE_OPTIMAL`. Les intervalles couvrent la totalité de la polyligne de la RouteLegStep sans chevauchement. Le point de départ d'un intervalle spécifié est identique au point d'arrivée de l'intervalle précédent. Exemple : `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture de vitesse détaillant la densité du trafic. Applicable en cas de préférences de routage TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent la totalité de la polyligne de la RouteLegStep sans chevauchement. Le point de départ d'un intervalle spécifié est identique au point d'arrivée de l'intervalle précédent.

Exemple :

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteLegTravelAdvisory

Encapsule les informations supplémentaires dont l'utilisateur doit être informé, telles que les éventuelles restrictions de zone de circulation sur une section de l'itinéraire.

Champs

Champs
`toll_info`	`TollInfo` Encapsule les informations sur les péages sur la RouteLeg spécifique. Ce champ n'est renseigné que si la RouteLeg devrait comporter des péages. Si ce champ est défini, mais que le sous-champ "estimated_price" n'est pas renseigné, nous pensons que la route comporte des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'existe pas, la RouteLeg ne comprend pas de péage.
`speed_reading_intervals[]`	`SpeedReadingInterval` Intervalles de lecture de vitesse détaillant la densité du trafic. Applicable en cas de préférences de routage `TRAFFIC_AWARE` et `TRAFFIC_AWARE_OPTIMAL`. Les intervalles couvrent la totalité de la polyligne de RouteLg sans chevauchement. Le point de départ d'un intervalle spécifié est identique au point d'arrivée de l'intervalle précédent. Exemple : `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

Encapsule les informations sur les péages sur la RouteLeg spécifique. Ce champ n'est renseigné que si la RouteLeg devrait comporter des péages. Si ce champ est défini, mais que le sous-champ "estimated_price" n'est pas renseigné, nous pensons que la route comporte des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'existe pas, la RouteLeg ne comprend pas de péage.

speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture de vitesse détaillant la densité du trafic. Applicable en cas de préférences de routage TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent la totalité de la polyligne de RouteLg sans chevauchement. Le point de départ d'un intervalle spécifié est identique au point d'arrivée de l'intervalle précédent.

Exemple :

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

Une seule destination pour ComputeRouteMatrixRequest

Champs

Champs
`waypoint`	`Waypoint` Obligatoire. Point de cheminement de destination

waypoint

Waypoint

Obligatoire. Point de cheminement de destination

RouteMatrixElement

Encapsule les informations sur l'itinéraire calculées pour une paire point de départ-destination dans l'API ComputeRouteMatrix. Ce proto peut être diffusé vers le client.

Champs
`origin_index`	`int32` Index basé sur zéro de l'origine dans la requête.
`destination_index`	`int32` Index basé sur zéro de la destination de la requête.
`status`	`Status` Code d'état d'erreur pour cet élément.
`condition`	`RouteMatrixElementCondition` Indique si l'itinéraire a été trouvé ou non. Indépendant du statut
`distance_meters`	`int32` Distance de l'itinéraire, en mètres.
`duration`	`Duration` Temps nécessaire pour parcourir l'itinéraire. Si vous définissez `routing_preference` sur `TRAFFIC_UNAWARE`, cette valeur est identique à `static_duration`. Si vous définissez `routing_preference` sur `TRAFFIC_AWARE` ou `TRAFFIC_AWARE_OPTIMAL`, cette valeur est calculée en tenant compte des conditions de circulation.
`static_duration`	`Duration` Durée du trajet pour l'itinéraire sans tenir compte des conditions de circulation
`travel_advisory`	`RouteTravelAdvisory` Informations supplémentaires sur l'itinéraire. Par exemple: les restrictions et les informations sur les péages
`fallback_info`	`FallbackInfo` Dans certains cas, lorsque le serveur n'est pas en mesure de calculer l'itinéraire avec les préférences définies pour cette paire point de départ-destination, il peut se rabattre d'un autre mode de calcul. Lorsque le mode de remplacement est utilisé, ce champ contient des informations détaillées sur la réponse de remplacement. Sinon, ce champ n'est pas défini.

RouteMatrixElementCondition

État de l'itinéraire renvoyé.

Enums
`ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED`	Utilisé uniquement lorsque le `status` de l'élément n'est pas correct.
`ROUTE_EXISTS`	Un itinéraire a été trouvé, et les informations correspondantes ont été renseignées pour l'élément.
`ROUTE_NOT_FOUND`	Aucun itinéraire trouvé. Les champs contenant des informations sur l'itinéraire, tels que `distance_meters` ou `duration`, ne seront pas renseignés dans l'élément.

RouteMatrixOrigin

Une origine unique pour ComputeRouteMatrixRequest

Champs

Champs
`waypoint`	`Waypoint` Obligatoire. Point de cheminement de départ
`route_modifiers`	`RouteModifiers` Facultatif. Les modificateurs de chaque itinéraire qui l'utilise comme point de départ

waypoint

Waypoint

Obligatoire. Point de cheminement de départ

route_modifiers

RouteModifiers

Facultatif. Les modificateurs de chaque itinéraire qui l'utilise comme point de départ

RouteModifiers

Encapsule un ensemble de conditions facultatives à remplir lors du calcul des itinéraires.

Champs
`avoid_tolls`	`bool` Indique si les routes à péage doivent être évitées, dans la mesure du raisonnable. La priorité sera donnée aux itinéraires qui ne contiennent pas de routes à péage. S'applique uniquement aux modes de transport `DRIVE` et `TWO_WHEELER`.
`avoid_highways`	`bool` Indique si les autoroutes doivent être évitées lorsque cela est raisonnable. La priorité sera donnée aux itinéraires qui ne contiennent pas d'autoroutes. S'applique uniquement aux modes de transport `DRIVE` et `TWO_WHEELER`.
`avoid_ferries`	`bool` Indique si les ferries doivent être évités dans la mesure du raisonnable. Une préférence sera accordée aux itinéraires qui ne comprennent pas de trajets en ferry. S'applique uniquement aux modes de transport `DRIVE` et `TWO_WHEELER`.
`avoid_indoor`	`bool` Indique si la navigation à l'intérieur d'un bâtiment doit être évitée lorsque cela est raisonnable. La préférence sera donnée aux itinéraires qui ne contiennent pas de navigation en intérieur. S'applique uniquement au mode de transport `WALK`.
`vehicle_info`	`VehicleInfo` Spécifie les informations sur le véhicule.
`toll_passes[]`	`TollPass` Encapsule les informations sur les pass. Si des pass de péage sont fournis, l'API essaie de renvoyer leur prix. Si aucun pass de péage n'est fourni, l'API considère qu'il est inconnu et renvoie le prix en espèces. S'applique uniquement aux modes de transport DRIVE et TWO_WHEELER.

RouteObjective

Encapsule un objectif à optimiser par ComputeCustomRoutes.

Champs

Champs
`rate_card`	`RateCard` L'objectif du tableau des tarifs

rate_card

RateCard

L'objectif du tableau des tarifs

RateCard

Encapsule un objectif de routage du tableau des tarifs.

Champs

Champs
`cost_per_minute`	`MonetaryCost` Facultatif. Coût à la minute.
`cost_per_km`	`MonetaryCost` Facultatif. Coût au kilomètre
`include_tolls`	`bool` Facultatif. Indique s'il faut inclure les frais de péage dans le coût global.

cost_per_minute

MonetaryCost

Facultatif. Coût à la minute.

cost_per_km

MonetaryCost

Facultatif. Coût au kilomètre

include_tolls

bool

Facultatif. Indique s'il faut inclure les frais de péage dans le coût global.

MonetaryCost

Encapsule le coût utilisé dans le tableau des tarifs.

Champs

Champs
`value`	`double` Obligatoire. Valeur de coût dans la devise locale déduite de la requête.

value

double

Obligatoire. Valeur de coût dans la devise locale déduite de la requête.

RouteTravelAdvisory

Encapsule les informations supplémentaires dont l'utilisateur doit être informé, comme une possible restriction de zone de trafic, etc.

Champs

Champs
`toll_info`	`TollInfo` Encapsule les informations relatives aux péages sur l'itinéraire. Ce champ n'est renseigné que si l'itinéraire devrait comporter des péages. Si ce champ est défini, mais que le sous-champ "estimated_price" n'est pas renseigné, nous pensons que la route comporte des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'est pas défini, l'itinéraire ne devrait pas comporter de péage.
`speed_reading_intervals[]`	`SpeedReadingInterval` Intervalles de lecture de vitesse détaillant la densité du trafic. Applicable en cas de préférences de routage `TRAFFIC_AWARE` et `TRAFFIC_AWARE_OPTIMAL`. Les intervalles couvrent la totalité de la polyligne de l'itinéraire sans chevauchement. Le point de départ d'un intervalle spécifié est identique au point d'arrivée de l'intervalle précédent. Exemple : `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

Encapsule les informations relatives aux péages sur l'itinéraire. Ce champ n'est renseigné que si l'itinéraire devrait comporter des péages. Si ce champ est défini, mais que le sous-champ "estimated_price" n'est pas renseigné, nous pensons que la route comporte des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'est pas défini, l'itinéraire ne devrait pas comporter de péage.

speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture de vitesse détaillant la densité du trafic. Applicable en cas de préférences de routage TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent la totalité de la polyligne de l'itinéraire sans chevauchement. Le point de départ d'un intervalle spécifié est identique au point d'arrivée de l'intervalle précédent.

Exemple :

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteTravelMode

Ensemble de valeurs permettant de spécifier le mode de transport.

Enums
`TRAVEL_MODE_UNSPECIFIED`	Aucun mode de transport spécifié. La valeur par défaut est `DRIVE`.
`DRIVE`	Trajet en voiture de tourisme
`BICYCLE`	Déplacez-vous à vélo.
`WALK`	Déplacements à pied.
`TWO_WHEELER`	Véhicule à deux roues électrique. Par exemple, moto. Notez que cela diffère du mode de transport `BICYCLE`, qui inclut le mode de transport manuel.
`TAXI`	Prenez un taxi agréé, qui peut emprunter des voies de taxi dans certaines zones géographiques. Le mode TAXI est une fonctionnalité expérimentale. Si le client demande un itinéraire en TAXI dans une ville où les données sur les voies de taxi ne sont pas disponibles, il renvoie l'itinéraire en VOITURE.

RoutingPreference

Ensemble de valeurs spécifiant les facteurs à prendre en compte lors du calcul de l'itinéraire.

Enums
`ROUTING_PREFERENCE_UNSPECIFIED`	Aucune préférence de routage spécifiée. Valeur par défaut : `TRAFFIC_AWARE`
`TRAFFIC_UNAWARE`	Calcule les itinéraires sans tenir compte des conditions de circulation. Adapté aux conditions de circulation sans importance. Utiliser cette valeur permet d'obtenir la latence la plus faible.
`TRAFFIC_AWARE`	Calcule les itinéraires en tenant compte des conditions de circulation. Contrairement à `TRAFFIC_AWARE_OPTIMAL`, certaines optimisations sont appliquées pour réduire considérablement la latence.
`TRAFFIC_AWARE_OPTIMAL`	Calcule les itinéraires en tenant compte des conditions de circulation, sans appliquer la plupart des optimisations de performances. L'utilisation de cette valeur génère la latence la plus élevée.

SpeedReadingInterval

Indicateur de densité du trafic sur un segment contigu d'une polyligne ou d'un tracé Lorsqu'un chemin comporte des points P_0, P_1, ... et P_N (indice basé sur zéro), SpeedReadingInterval définit un intervalle et décrit le trafic à l'aide des catégories suivantes.

Champs

Champs
`start_polyline_point_index`	`int32` Index de départ de cet intervalle dans la polyligne. En JSON, lorsque l'index est 0, le champ semble non renseigné.
`end_polyline_point_index`	`int32` Index de fin de cet intervalle dans la polyligne. En JSON, lorsque l'index est 0, le champ semble non renseigné.
`speed`	`Speed` Vitesse du trafic dans cet intervalle.

start_polyline_point_index

int32

Index de départ de cet intervalle dans la polyligne. En JSON, lorsque l'index est 0, le champ semble non renseigné.

end_polyline_point_index

int32

Index de fin de cet intervalle dans la polyligne. En JSON, lorsque l'index est 0, le champ semble non renseigné.

speed

Speed

Vitesse du trafic dans cet intervalle.

Rapidité

Classification de la vitesse des polylignes en fonction des données de trafic.

Enums
`SPEED_UNSPECIFIED`	Valeur par défaut. Cette valeur n'est pas utilisée.
`NORMAL`	Vitesse normale ; aucun ralentissement n'est détecté.
`SLOW`	Ralentissement détecté, mais aucun embouteillage détecté.
`TRAFFIC_JAM`	Embouteillage détecté.

TollInfo

Encapsule les informations sur les péages dans un Route ou un RouteLeg.

Champs

Champs
`estimated_price[]`	`Money` Valeur monétaire des péages pour l'itinéraire ou la RouteLeg correspondant. Cette liste contient un montant monétaire pour chaque devise devant être facturée par les stations de péage. Généralement, cette liste ne contient qu'un seul élément pour les itinéraires avec des péages dans une seule devise. Pour les voyages internationaux, cette liste peut contenir plusieurs éléments afin de refléter les péages dans différentes devises.

estimated_price[]

Money

Valeur monétaire des péages pour l'itinéraire ou la RouteLeg correspondant. Cette liste contient un montant monétaire pour chaque devise devant être facturée par les stations de péage. Généralement, cette liste ne contient qu'un seul élément pour les itinéraires avec des péages dans une seule devise. Pour les voyages internationaux, cette liste peut contenir plusieurs éléments afin de refléter les péages dans différentes devises.

TollPass

Liste des péages dans le monde que nous acceptons.

Enums
`TOLL_PASS_UNSPECIFIED`	Non utilisé. Si cette valeur est utilisée, la requête échoue.
`AU_ETOLL_TAG`	L'un des nombreux fournisseurs de télépéage à Sydney. https://www.myetoll.com.au
`AU_EWAY_TAG`	L'un des nombreux fournisseurs de télépéage à Sydney. https://www.tollpay.com.au/
`AU_LINKT`	Péage sur l'ensemble de l'Australie. Pour en savoir plus, consultez https://www.linkt.com.au/.
`AR_TELEPASE`	Péage pour l'Argentine. Pour en savoir plus, consultez https://telepase.com.ar.
`BR_AUTO_EXPRESO`	Pass de péage pour le Brésil. Pour en savoir plus, consultez https://www.autoexpreso.com.
`BR_CONECTCAR`	Pass de péage pour le Brésil. Pour en savoir plus, consultez https://conectcar.com.
`BR_MOVE_MAIS`	Pass de péage pour le Brésil. Pour en savoir plus, consultez le site https://movemais.com.
`BR_PASSA_RAPIDO`	Pass de péage pour le Brésil. Pour en savoir plus, consultez https://pasorapido.gob.do/.
`BR_SEM_PARAR`	Pass de péage pour le Brésil. Pour en savoir plus, consultez https://www.semparar.com.br.
`BR_TAGGY`	Pass de péage pour le Brésil. Pour en savoir plus, consultez la page https://taggy.com.br.
`BR_VELOE`	Pass de péage pour le Brésil. Pour en savoir plus, consultez la page https://veloe.com.br/site/onde-usar.
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	Poste-frontière entre le Canada et les États-Unis.
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	Poste-frontière entre le Canada et les États-Unis.
`CA_US_BLUE_WATER_EDGE_PASS`	Ontario, Canada et Michigan, États-Unis.
`CA_US_CONNEXION`	Ontario, Canada et Michigan, États-Unis.
`CA_US_NEXUS_CARD`	Poste-frontière entre le Canada et les États-Unis.
`ID_E_TOLL`	Indonésie. Carte électronique fournie par plusieurs banques et utilisée pour le paiement des péages. Les cartes électroniques émises par les banques sont facturées de la même manière. Une seule valeur d'énumération est donc nécessaire. Par exemple, Bank Mandiri https://www.bankmandiri.co.id/e-money BCA https://www.bca.co.id/flazz BNI https://www.bni.co.id/id-id/ebanking/tapcash
`IN_FASTAG`	India.
`IN_LOCAL_HP_PLATE_EXEMPT`	Inde, exemption de plaque d'immatriculation HP.
`MX_TAG_IAVE`	le télépéage du Mexique.
`MX_TAG_TELEVIA`	Société mexicaine de télépéage. L'un des nombreux opéras à Mexico. Pour en savoir plus, consultez https://www.televia.com.mx.
`MX_VIAPASS`	le télépéage du Mexique. Pour en savoir plus, consultez https://www.viapass.com.mx/viapass/web_home.aspx.
`US_AL_FREEDOM_PASS`	Alabama, États-Unis.
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	Alaska, États-Unis.
`US_CA_FASTRAK`	Californie, États-Unis.
`US_CA_FASTRAK_CAV_STICKER`	Indique que le conducteur dispose d'une vignette FasTrak en plus de l'autocollant "CAV" émis par le DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	CO, États-Unis.
`US_CO_GO_PASS`	CO, États-Unis.
`US_DE_EZPASSDE`	Allemagne, États-Unis.
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	Floride, États-Unis.
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	Floride, États-Unis.
`US_FL_EPASS`	Floride, États-Unis.
`US_FL_GIBA_TOLL_PASS`	Floride, États-Unis.
`US_FL_LEEWAY`	Floride, États-Unis.
`US_FL_SUNPASS`	Floride, États-Unis.
`US_FL_SUNPASS_PRO`	Floride, États-Unis.
`US_IL_EZPASSIL`	Illinois, États-Unis.
`US_IL_IPASS`	Illinois, États-Unis.
`US_IN_EZPASSIN`	IN, ÉTATS-UNIS.
`US_KS_BESTPASS_HORIZON`	Kansas, États-Unis.
`US_KS_KTAG`	Kansas, États-Unis.
`US_KS_NATIONALPASS`	Kansas, États-Unis.
`US_KS_PREPASS_ELITEPASS`	Kansas, États-Unis.
`US_KY_RIVERLINK`	KY, États-Unis.
`US_LA_GEAUXPASS`	Los Angeles, États-Unis.
`US_LA_TOLL_TAG`	Los Angeles, États-Unis.
`US_MA_EZPASSMA`	Massachusetts, États-Unis.
`US_MD_EZPASSMD`	MD, États-Unis.
`US_ME_EZPASSME`	ME, ÉTATS-UNIS.
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	Michigan, États-Unis.
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	Michigan, États-Unis.
`US_MI_IQ_PROX_CARD`	Michigan, États-Unis.
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	Michigan, États-Unis.
`US_MI_NEXPRESS_TOLL`	Michigan, États-Unis.
`US_MN_EZPASSMN`	Minnesota, États-Unis.
`US_NC_EZPASSNC`	Caroline du Nord, États-Unis.
`US_NC_PEACH_PASS`	Caroline du Nord, États-Unis.
`US_NC_QUICK_PASS`	Caroline du Nord, États-Unis.
`US_NH_EZPASSNH`	New Hampshire, États-Unis.
`US_NJ_DOWNBEACH_EXPRESS_PASS`	New Jersey, États-Unis.
`US_NJ_EZPASSNJ`	New Jersey, États-Unis.
`US_NY_EXPRESSPASS`	New York, États-Unis.
`US_NY_EZPASSNY`	New York, États-Unis.
`US_OH_EZPASSOH`	Ohio, États-Unis.
`US_PA_EZPASSPA`	Pennsylvanie, États-Unis.
`US_RI_EZPASSRI`	RI, États-Unis.
`US_SC_PALPASS`	Caroline du Sud, États-Unis.
`US_TX_BANCPASS`	Texas, États-Unis.
`US_TX_DEL_RIO_PASS`	Texas, États-Unis.
`US_TX_EFAST_PASS`	Texas, États-Unis.
`US_TX_EAGLE_PASS_EXPRESS_CARD`	Texas, États-Unis.
`US_TX_EPTOLL`	Texas, États-Unis.
`US_TX_EZ_CROSS`	Texas, États-Unis.
`US_TX_EZTAG`	Texas, États-Unis.
`US_TX_LAREDO_TRADE_TAG`	Texas, États-Unis.
`US_TX_PLUSPASS`	Texas, États-Unis.
`US_TX_TOLLTAG`	Texas, États-Unis.
`US_TX_TXTAG`	Texas, États-Unis.
`US_TX_XPRESS_CARD`	Texas, États-Unis.
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	Utah, États-Unis.
`US_VA_EZPASSVA`	Virginie, États-Unis.
`US_WA_BREEZEBY`	Washington, États-Unis.
`US_WA_GOOD_TO_GO`	Washington, États-Unis.
`US_WV_EZPASSWV`	Virginie-Occidentale, États-Unis.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	Virginie-Occidentale, États-Unis.
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	Virginie-Occidentale, États-Unis.

Unités

Ensemble de valeurs indiquant l'unité de mesure utilisée sur l'écran.

Enums
`UNITS_UNSPECIFIED`	Unités de mesure non spécifiées. La valeur par défaut est l'unité de mesure déduite de la requête.
`METRIC`	Unités de mesure des métriques.
`IMPERIAL`	Unités de mesure impériales (anglais).

VehicleEmissionType

Ensemble de valeurs décrivant le type d'émission du véhicule. S'applique uniquement au mode de transport DRIVE.

Enums
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	Aucun type d'émission spécifié. Valeur par défaut : GASOLINE.
`GASOLINE`	Véhicule fonctionnant à l'essence
`ELECTRIC`	Véhicule électrique.
`HYBRID`	Véhicule hybride (essence + électrique, par exemple)

VehicleInfo

Encapsule les informations sur le véhicule, comme le dernier caractère de la plaque d'immatriculation.

Champs

Champs
`emission_type`	`VehicleEmissionType` Décrit le type d'émission du véhicule. S'applique uniquement au mode de transport DRIVE.

emission_type

VehicleEmissionType

Décrit le type d'émission du véhicule. S'applique uniquement au mode de transport DRIVE.

Repère

Encapsule un point de cheminement. Les points de cheminement marquent le début et la fin de l'itinéraire, et incluent des arrêts intermédiaires le long de l'itinéraire.

Champs
`via`	`bool` Marque ce point de cheminement comme une étape importante et non comme un point d'arrêt. Pour chaque point de cheminement non via via la requête, la réponse ajoute une entrée au tableau `legs` afin de fournir les détails des arrêts sur cette section du trajet. Définissez cette valeur sur "true" si vous souhaitez que l'itinéraire passe par ce point de cheminement sans s'arrêter. Les points de cheminement "via" n'entraînent pas l'ajout d'une entrée dans le tableau `legs`, mais ils acheminent le trajet par le point de cheminement. Vous ne pouvez définir cette valeur que pour les points de cheminement intermédiaires. La requête échoue si vous définissez ce champ sur des points de cheminement terminaux. Si ComputeRoutesRequest.optimize_waypoint_order est défini sur "true", ce champ ne peut pas être défini sur "true". Sinon, la requête échoue.
`vehicle_stopover`	`bool` Indique que le point de cheminement est destiné aux véhicules pour qu'ils s'arrêtent lorsqu'ils doivent monter ou descendre du véhicule. Si vous définissez cette valeur, l'itinéraire calculé n'inclut pas les points de cheminement autres que `via` sur les routes inadaptées aux montées et aux descentes. Cette option ne fonctionne que pour les modes de transport `DRIVE` et `TWO_WHEELER`, et lorsque la valeur de `location_type` est `location`.
`side_of_road`	`bool` Indique que l'emplacement de ce point de cheminement doit permettre au véhicule de s'arrêter en priorité sur un côté de la route. Lorsque vous définissez cette valeur, l'itinéraire passe par le lieu pour que le véhicule puisse s'arrêter du côté de la route vers lequel la position est orientée depuis le centre. Cette option ne fonctionne que pour les modes de transport "DRIVE" et "TWO_WHEELER", et lorsque le paramètre "location_type" est défini sur "location".
Champ d'union `location_type`. Différentes manières de représenter un lieu. `location_type` ne peut être qu'un des éléments suivants :
`location`	`Location` Point spécifié à l'aide de coordonnées géographiques, avec un cap facultatif.
`place_id`	`string` ID de lieu du POI associé au point de cheminement.