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

L'API Routes Preferred.

ComputeCustomRoutes

ComputeCustomRoutes
`rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)` À partir d'un ensemble de points de cheminement terminaux et intermédiaires, et d'un objectif d'itinéraire, calcule le meilleur itinéraire pour l'objectif de l'itinéraire. Renvoie é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` (voir les 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 pour savoir comment créer les chemins d'accès aux champs. Par exemple, dans cette méthode: Masque de champ de tous les champs disponibles (pour inspection manuelle): `X-Goog-FieldMask: ` Masque de champ des distances de l'itinéraire, de la durée, du jeton 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 d'utiliser le masque de champ de réponse avec caractère générique (``) ou de spécifier le masque de champ au niveau supérieur (`routes`), pour les raisons suivantes: En sélectionnant uniquement les champs dont vous avez besoin, vous permettez à notre serveur d'économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible. Sélectionner uniquement les champs dont vous avez besoin dans votre job de production garantit des performances de latence stables. Nous ajouterons peut-être d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs du niveau supérieur, vous risquez de constater une dégradation des performances. En effet, tout nouveau champ ajouté sera automatiquement inclus dans la réponse. En ne sélectionnant que les champs dont vous avez besoin, vous pouvez réduire la taille de réponse 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)

À partir d'un ensemble de points de cheminement terminaux et intermédiaires, et d'un objectif d'itinéraire, calcule le meilleur itinéraire pour l'objectif de l'itinéraire. Renvoie é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 (voir les 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 pour savoir comment créer les chemins d'accès aux champs.

Par exemple, dans cette méthode:

Masque de champ de tous les champs disponibles (pour inspection manuelle): X-Goog-FieldMask: *
Masque de champ des distances de l'itinéraire, de la durée, du jeton 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 d'utiliser le masque de champ de réponse avec caractère générique (*) ou de spécifier le masque de champ au niveau supérieur (routes), pour les raisons suivantes:

En sélectionnant uniquement les champs dont vous avez besoin, vous permettez à notre serveur d'économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
Sélectionner uniquement les champs dont vous avez besoin dans votre job de production garantit des performances de latence stables. Nous ajouterons peut-être d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs du niveau supérieur, vous risquez de constater une dégradation des performances. En effet, tout nouveau champ ajouté sera automatiquement inclus dans la réponse.
En ne sélectionnant que les champs dont vous avez besoin, vous pouvez réduire la taille de réponse 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)` Reçoit une liste de points de départ et de destinations, et renvoie un flux contenant des informations sur les itinéraires correspondant à chaque combinaison de points de départ et de destination. 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` (voir les 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 pour savoir comment créer les chemins d'accès aux champs. Par exemple, dans cette méthode: Masque de champ de tous les champs disponibles (pour inspection manuelle): `X-Goog-FieldMask: ` Masque de champ des durées de l'itinéraire, des distances, de l'état, des conditions et des indices des éléments (exemple de configuration de production): `X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` Vous devez impérativement inclure `status` dans votre masque de champ, sinon tous les messages semblent corrects. Google déconseille l'utilisation du masque de champ de réponse avec caractère générique (``) pour les raisons suivantes: En sélectionnant uniquement les champs dont vous avez besoin, vous permettez à notre serveur d'économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible. Sélectionner uniquement les champs dont vous avez besoin dans votre job de production garantit des performances de latence stables. Nous ajouterons peut-être d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs du niveau supérieur, vous risquez de constater une dégradation des performances. En effet, tout nouveau champ ajouté sera automatiquement inclus dans la réponse. En ne sélectionnant que les champs dont vous avez besoin, vous pouvez réduire la taille de réponse 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)

Reçoit une liste de points de départ et de destinations, et renvoie un flux contenant des informations sur les itinéraires correspondant à chaque combinaison de points de départ et de destination.

Par exemple, dans cette méthode:

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

Vous devez impérativement inclure status dans votre masque de champ, sinon tous les messages semblent corrects. Google déconseille l'utilisation du masque de champ de réponse avec caractère générique (*) pour les raisons suivantes:

En sélectionnant uniquement les champs dont vous avez besoin, vous permettez à notre serveur d'économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
Sélectionner uniquement les champs dont vous avez besoin dans votre job de production garantit des performances de latence stables. Nous ajouterons peut-être d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs du niveau supérieur, vous risquez de constater une dégradation des performances. En effet, tout nouveau champ ajouté sera automatiquement inclus dans la réponse.
En ne sélectionnant que les champs dont vous avez besoin, vous pouvez réduire la taille de réponse 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)` Renvoie l'itinéraire principal ainsi que d'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` (voir les 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 inspection manuelle): `X-Goog-FieldMask: ` Masque de champ pour la durée, la distance et la 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 d'utiliser le masque de champ de réponse avec caractère générique (``) ou de spécifier le masque de champ au niveau supérieur (`routes`), pour les raisons suivantes: En sélectionnant uniquement les champs dont vous avez besoin, vous permettez à notre serveur d'économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible. Sélectionner uniquement les champs dont vous avez besoin dans votre job de production garantit des performances de latence stables. Nous ajouterons peut-être d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs du niveau supérieur, vous risquez de constater une dégradation des performances. En effet, tout nouveau champ ajouté sera automatiquement inclus dans la réponse. En ne sélectionnant que les champs dont vous avez besoin, vous pouvez réduire la taille de réponse 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)

Renvoie l'itinéraire principal ainsi que d'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 (voir les 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 inspection manuelle): X-Goog-FieldMask: *
Masque de champ pour la durée, la distance et la 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 d'utiliser le masque de champ de réponse avec caractère générique (*) ou de spécifier le masque de champ au niveau supérieur (routes), pour les raisons suivantes:

En sélectionnant uniquement les champs dont vous avez besoin, vous permettez à notre serveur d'économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
Sélectionner uniquement les champs dont vous avez besoin dans votre job de production garantit des performances de latence stables. Nous ajouterons peut-être d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs du niveau supérieur, vous risquez de constater une dégradation des performances. En effet, tout nouveau champ ajouté sera automatiquement inclus dans la réponse.
En ne sélectionnant que les champs dont vous avez besoin, vous pouvez réduire la taille de réponse 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. Jusqu'à 25 points de cheminement intermédiaires sont acceptés.
`travel_mode`	`RouteTravelMode` Facultatif. Spécifie le mode de transport. Seul Drive est désormais pris en charge.
`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 plus longue, une erreur est renvoyée. À l'avenir, nous pourrons mettre en œuvre un mécanisme de remplacement permettant d'utiliser une autre option lorsque l'option préférée ne donnera pas de résultat valide. Vous ne pouvez spécifier cette option que lorsque `travel_mode` est défini sur `DRIVE` ou `TWO_WHEELER`. Sinon, la requête échoue.
`polyline_quality`	`PolylineQuality` Facultatif. Spécifie 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 correspond par défaut à l'heure à laquelle vous avez effectué la requête. Si vous définissez cette valeur sur une heure qui s'est déjà produite, la requête échoue.
`route_modifiers`	`RouteModifiers` Facultatif. Ensemble de conditions à remplir qui affectent la façon dont les itinéraires sont calculés.
`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 disponibles. 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`. Les unités de mesure utilisées pour l'itinéraire, la section, la distance de pas et la durée ne sont pas affectées par cette valeur. Si vous n'indiquez pas cette valeur, les unités d'affichage sont déduites de l'emplacement de la requête.

ComputeCustomRoutesResponse

ComputeCustomRoutes.

Champs
`routes[]`	`CustomRoute` Les "meilleures" routes pour l'objectif de route d'entrée.
`fastest_route`	`CustomRoute` La route de référence la plus rapide.
`shortest_route`	`CustomRoute` Route de référence la plus courte.
`fallback_info`	`FallbackInfo` Informations de remplacement pour les routes personnalisées.

FallbackInfo

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

S'il ne peut pas calculer la route à l'aide des préférences de routage demandées par le client, il passe à un autre mode de routage. Dans ce cas, les paramètres "fallback_routing_mode" et "router_mode_fallback_reason" permettent de communiquer le mode de routage de remplacement utilisé, ainsi que la raison de ce choix.
S'il n'arrive pas à calculer une "meilleure" pour l'objectif d'itinéraire spécifié par le client, il peut passer à un autre objectif. Fallback_route_objective est utilisé pour communiquer l'objectif de la route de remplacement.

Champs

Champs
`routing_mode`	`FallbackRoutingMode` Mode de routage utilisé pour la réponse. Si une création de remplacement a été déclenchée, le mode peut être différent des préférences de routage définies dans la requête client d'origine.
`routing_mode_reason`	`FallbackReason` Raison pour laquelle la réponse de remplacement a été utilisée à la place de 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 une création de remplacement a été déclenchée, l'objectif peut être différent de celui de la route fourni dans la requête client d'origine.

routing_mode

FallbackRoutingMode

Mode de routage utilisé pour la réponse. Si une création de remplacement a été déclenchée, le mode peut être différent des préférences de routage définies dans la requête client d'origine.

routing_mode_reason

FallbackReason

Raison pour laquelle la réponse de remplacement a été utilisée à la place de 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 une création de remplacement a été déclenchée, l'objectif peut être différent de celui de la route fourni dans la requête client d'origine.

FallbackRouteObjective

RouteObjective utilisé pour la réponse.

Enums
`FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED`	Objectif de la 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 pas de données sur les prix de péage pour l'itinéraire, l'API utilise le tableau des tarifs sans tenir compte des frais de péage.

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 de destination: Le nombre d'éléments (points de départ × destinations) ne doit pas dépasser 625. Le nombre d'éléments (points de départ × destinations) ne doit pas dépasser 100 si routage_preference est défini sur `TRAFFIC_AWARE_OPTIMAL`. Le nombre de points de cheminement (points de départ + destinations) spécifiés en tant que `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 plus longue, une erreur est renvoyée. À l'avenir, nous pourrons mettre en œuvre un mécanisme de remplacement permettant d'utiliser une autre option lorsque l'option préférée ne donnera pas de résultat valide. Vous ne pouvez spécifier cette option que lorsque `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, l'heure à laquelle vous avez effectué la requête est utilisée par défaut. Si vous définissez cette valeur sur une heure qui s'est déjà produite, 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. Jusqu'à 25 points de cheminement intermédiaires sont acceptés.
`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 plus longue, une erreur est renvoyée. À l'avenir, nous pourrons mettre en œuvre un mécanisme de remplacement permettant d'utiliser une autre option lorsque l'option préférée ne donnera pas de résultat valide. Vous ne pouvez spécifier cette option que lorsque `travel_mode` est défini sur `DRIVE` ou `TWO_WHEELER`. Sinon, la requête échoue.
`polyline_quality`	`PolylineQuality` Facultatif. Spécifie 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 correspond par défaut à l'heure à laquelle vous avez effectué la requête. Si vous définissez cette valeur sur une heure qui s'est déjà produite, la requête échoue.
`compute_alternative_routes`	`bool` Indique s'il faut calculer des itinéraires bis en plus de l'itinéraire.
`route_modifiers`	`RouteModifiers` Facultatif. Ensemble de conditions à remplir qui affectent la façon dont les itinéraires sont calculés.
`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 disponibles. 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`. Les unités de mesure utilisées pour l'itinéraire, la section, la distance de pas et la durée ne sont pas affectées par cette valeur. Si vous n'indiquez pas cette valeur, les unités d'affichage sont déduites de l'emplacement de la requête.
`optimize_waypoint_order`	`bool` Si OptimizeWaypointOrder est défini sur "true", une tentative de réorganisation des points de cheminement intermédiaires spécifiés est effectuée afin de minimiser le coût global de l'itinéraire. Si l'un des points de cheminement intermédiaires se trouve via un point de cheminement, la requête échoue. Utilisez ComputeRoutesResponse.Routes.optimized_intermédiaire_waypoint_index pour trouver le nouvel ordre. Si l'élément "routes.optimized_intermédiaire_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", ComputeRoutesResponse.optimized_intermédiaire_waypoint_index est vide.

ComputeRoutesResponse

ComputeRoute le message de réponse.

Champs

Champs
`routes[]`	`Route` Contient un tableau de routes calculées (jusqu'à trois) lorsque vous spécifiez compute_alternatives_routes et ne contient qu'un seul itinéraire lorsque vous ne le faites pas. 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 des itinéraires avec toutes les préférences d'entrée, il peut utiliser 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 de routes calculées (jusqu'à trois) lorsque vous spécifiez compute_alternatives_routes et ne contient qu'un seul itinéraire lorsque vous ne le faites pas. 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 des itinéraires avec toutes les préférences d'entrée, il peut utiliser 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 route spécifié par le client. CustomRoute contient un itinéraire et un jeton d'itinéraire, qui peuvent être transmis à NavSDK afin de reconstruire l'itinéraire personnalisé pour la navigation détaillée.

Champs

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

route

Route

L'itinéraire considéré comme le "meilleur" pour l'objectif de route d'entrée.

token

string

Jeton d'itinéraire encodé en base64 adapté au Web qui peut être transmis à NavSDK, ce qui permet à NavSDK de reconstruire l'itinéraire pendant la navigation. En cas de réacheminement, il respecte l'intention initiale lorsque RoutesPreferred ComputeCustomRoutes est appelé. 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é un mode de routage différent de votre mode préféré comme mode de remplacement.

Champs

Champs
`routing_mode`	`FallbackRoutingMode` Mode de routage utilisé pour la réponse. Si une création de remplacement a été déclenchée, le mode peut être différent des préférences de routage définies dans la requête client d'origine.
`reason`	`FallbackReason` Raison pour laquelle la réponse de remplacement a été utilisée à la place de 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

reason

FallbackReason

FallbackReason

Pourquoi utiliser une réponse de remplacement ?

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

FallbackRoutingMode

Mode de routage réel utilisé pour renvoyer une réponse de remplacement.

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

Lieu

Encapsule un emplacement (un point géographique et un en-tête facultatif).

Champs

Champs
`lat_lng`	`LatLng` Coordonnées géographiques du point de cheminement
`heading`	`Int32Value` Direction associée au sens du flux de circulation. Cette valeur permet d'indiquer le côté de la route à utiliser pour les lieux de prise en charge et de dépose. Les valeurs d'en-tête peuvent être comprises entre 0 et 360. La valeur "0" correspond à l'orientation vers le nord, 90 à l'orientation vers le nord, 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

Direction associée au sens du flux de circulation. Cette valeur permet d'indiquer le côté de la route à utiliser pour les lieux de prise en charge et de dépose. Les valeurs d'en-tête peuvent être comprises entre 0 et 360. La valeur "0" correspond à l'orientation vers le nord, 90 à l'orientation vers le nord, etc. Vous ne pouvez utiliser ce champ que pour les modes de transport DRIVE et TWO_WHEELER.

Manœuvre

Ensemble de valeurs qui spécifient l'action de navigation à effectuer pour l'étape actuelle (ex. : tourner à gauche, fusionner, droit, etc.).

Enums
`MANEUVER_UNSPECIFIED`	Non utilisé.
`TURN_SLIGHT_LEFT`	Tournez légèrement vers la gauche.
`TURN_SHARP_LEFT`	Tournez brusquement vers la gauche.
`UTURN_LEFT`	Faites demi-tour sur la gauche.
`TURN_LEFT`	Tournez à gauche.
`TURN_SLIGHT_RIGHT`	Tournez légèrement sur la droite.
`TURN_SHARP_RIGHT`	Tournez brusquement vers la droite.
`UTURN_RIGHT`	Faites demi-tour sur la droite.
`TURN_RIGHT`	Tournez à droite.
`STRAIGHT`	Allez tout droit.
`RAMP_LEFT`	Prendre la rampe à gauche.
`RAMP_RIGHT`	Prenez la rampe à droite.
`MERGE`	Fusionner dans le trafic.
`FORK_LEFT`	Prenez la bifurcation à gauche.
`FORK_RIGHT`	Prenez la droite.
`FERRY`	Prendre le ferry.
`FERRY_TRAIN`	Prenez 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, droit, etc.). Ce champ détermine l'icône à afficher.

instructions

string

Instructions pour effectuer 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 "encodé_polyligne". `polyline_type` ne peut être qu'un des éléments suivants :
`encoded_polyline`	`string` L'encodage de chaîne de la polyligne à l'aide de l'algorithme d'encodage de polyligne
`geo_json_linestring`	`Struct` Spécifie une polyligne au format LineString GeoJSON.

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

encoded_polyline

string

L'encodage de chaîne de la polyligne à l'aide de l'algorithme d'encodage de polyligne

geo_json_linestring

Struct

Spécifie une polyligne au format LineString GeoJSON.

PolylineEncoding

Spécifie le type de polyligne souhaité à renvoyer.

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

PolylineQuality

Ensemble de valeurs spécifiant la qualité de la polyligne.

Enums
`POLYLINE_QUALITY_UNSPECIFIED`	Aucune préférence de qualité de polyligne spécifiée. La valeur par défaut est `OVERVIEW`.
`HIGH_QUALITY`	Spécifie une polyligne de haute qualité, composée à l'aide de plus de points que `OVERVIEW`, au prix d'une taille de réponse plus importante. Utilisez cette valeur lorsque vous avez besoin de plus de précision.
`OVERVIEW`	Spécifie une polyligne d'aperçu, composée à l'aide d'un petit nombre de points. Utilisez cette valeur lorsque vous affichez un aperçu de la route. Cette option offre une latence de requête inférieure à celle de l'option `HIGH_QUALITY`.

Itinéraire

Encapsule un itinéraire, composé d'une série de segments de route reliés entre eux, qui rejoignent des points de cheminement de départ, d'arrivée et intermédiaires.

Champs
`legs[]`	`RouteLeg` Ensemble de sections (segments de chemin entre les points de cheminement) qui constituent l'itinéraire. Chaque section correspond au trajet entre deux points de cheminement non-`via`. Par exemple, un itinéraire sans point de cheminement intermédiaire ne comporte qu'une section. Un itinéraire qui inclut un point de cheminement intermédiaire non-`via` comporte deux sections. Un itinéraire qui inclut un point de cheminement intermédiaire `via` comporte une section. L'ordre des étapes correspond à celui des points de cheminement (entre `origin`, `intermediates` et `destination`).
`distance_meters`	`int32` Distance parcourue 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 sur l'itinéraire sans tenir compte des conditions de circulation.
`polyline`	`Polyline` Polyligne globale de l'itinéraire. 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: LA" ; Intermédiaires: Dallas, Bangor, Phoenix ; Destination: New York; et l'ordre de point de cheminement intermédiaire optimisé est: Phoenix, Dallas, Bangor. Ensuite, ce champ contient 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 de trajet de la section de l'itinéraire, exprimée 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` est `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 le long de la section, 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 des é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 trafic sur un tronçon d'itinéraire.

RouteLegStep

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

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

RouteLegStepTravelAdvisory

Encapsule les informations supplémentaires dont l'utilisateur doit être informé, telles que les éventuelles restrictions de zone de trafic sur une étape de l'étape de trajet.

Champs

Champs
`speed_reading_intervals[]`	`SpeedReadingInterval` Intervalles de lecture de la vitesse indiquant la densité du trafic Applicable dans le cas des préférences de routage `TRAFFIC_AWARE` et `TRAFFIC_AWARE_OPTIMAL`. Les intervalles couvrent toute la polyligne du RouteLegStep sans chevauchement. Le point de début d'un intervalle spécifié est identique au point de fin 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 la vitesse indiquant la densité du trafic Applicable dans le cas des préférences de routage TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent toute la polyligne du RouteLegStep sans chevauchement. Le point de début d'un intervalle spécifié est identique au point de fin 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 trafic sur un tronçon d'itinéraire.

Champs

Champs
`toll_info`	`TollInfo` Encapsule les informations sur les péages sur le RouteLeg spécifique. Ce champ n'est renseigné que si nous estimons qu'il y a des péages sur le RouteLeg. Si ce champ est défini, mais que le sous-champ "estimated_price" n'est pas renseigné, il est normal que la route contienne des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'existe pas, il n'y a pas de péage sur le RouteLeg.
`speed_reading_intervals[]`	`SpeedReadingInterval` Intervalles de lecture de la vitesse indiquant la densité du trafic Applicable dans le cas des préférences de routage `TRAFFIC_AWARE` et `TRAFFIC_AWARE_OPTIMAL`. Les intervalles couvrent la totalité de la polyligne du RouteLg sans chevauchement. Le point de début d'un intervalle spécifié est identique au point de fin 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 le RouteLeg spécifique. Ce champ n'est renseigné que si nous estimons qu'il y a des péages sur le RouteLeg. Si ce champ est défini, mais que le sous-champ "estimated_price" n'est pas renseigné, il est normal que la route contienne des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'existe pas, il n'y a pas de péage sur le RouteLeg.

speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture de la vitesse indiquant la densité du trafic Applicable dans le cas des préférences de routage TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent la totalité de la polyligne du RouteLg sans chevauchement. Le point de début d'un intervalle spécifié est identique au point de fin 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 d'itinéraire calculées pour une paire point de départ/destination dans l'API ComputeRouteMatrix. Ce proto peut être diffusé en streaming 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 dans 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 parcourue 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 sur l'itinéraire sans tenir compte des conditions de circulation.
`travel_advisory`	`RouteTravelAdvisory` Informations supplémentaires sur l'itinéraire. Par exemple: restrictions et informations sur les péages
`fallback_info`	`FallbackInfo` Dans certains cas, lorsque le serveur n'est pas en mesure de calculer la route avec les préférences données pour cette paire point de départ/destination spécifique, il peut choisir d'utiliser 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

La condition de la route renvoyée.

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 sont pas renseignés dans l'élément.

RouteMatrixOrigin

Une seule origine pour ComputeRouteMatrixRequest

Champs

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

waypoint

Waypoint

Obligatoire. Point de cheminement de départ

route_modifiers

RouteModifiers

Facultatif. Modificateurs pour 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 s'il faut éviter les routes à péage dans la mesure du raisonnable. La priorité sera donnée aux itinéraires ne comportant pas de routes à péage. S'applique uniquement aux modes de transport `DRIVE` et `TWO_WHEELER`.
`avoid_highways`	`bool` Indique s'il faut éviter les autoroutes lorsque cela est raisonnable. La préférence sera donnée aux itinéraires ne comportant pas d'autoroutes. S'applique uniquement aux modes de transport `DRIVE` et `TWO_WHEELER`.
`avoid_ferries`	`bool` Spécifie s'il faut éviter les ferries dans la mesure du possible. Une préférence sera donnée aux itinéraires qui ne comportent pas de trajets en ferry. S'applique uniquement aux modes de transport `DRIVE` et `TWO_WHEELER`.
`avoid_indoor`	`bool` Indique s'il faut éviter de naviguer en intérieur dans la mesure du possible. La préférence sera donnée aux itinéraires ne contenant 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 de péage. Si des pass de péage sont fournis, l'API tente de renvoyer le prix du titre de transport. Si aucun pass de péage n'est fourni, l'API considère qu'il s'agit d'un titre inconnu et tente de renvoyer le prix en espèces. S'applique uniquement aux modes de transport READ 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 route de tableau des tarifs.

Champs

Champs
`cost_per_minute`	`MonetaryCost` Facultatif. Coût par minute
`cost_per_km`	`MonetaryCost` Facultatif. Coût par kilomètre
`include_tolls`	`bool` Facultatif. Indique si les frais de péage doivent être inclus dans le coût global.

cost_per_minute

MonetaryCost

Facultatif. Coût par minute

cost_per_km

MonetaryCost

Facultatif. Coût par kilomètre

include_tolls

bool

Facultatif. Indique si les frais de péage doivent être inclus dans le coût global.

MonetaryCost

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

Champs

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

value

double

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

RouteTravelAdvisory

Encapsule les informations supplémentaires dont l'utilisateur doit être informé, telles que les éventuelles restrictions de zone de trafic, etc.

Champs

Champs
`toll_info`	`TollInfo` Encapsule des informations sur les péages sur l'itinéraire. Ce champ n'est renseigné que si nous estimons qu'il y aura des péages sur l'itinéraire. Si ce champ est défini, mais que le sous-champ "estimated_price" n'est pas renseigné, il est normal que la route contienne des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'est pas défini, il n'y aura pas de péage sur l'itinéraire.
`speed_reading_intervals[]`	`SpeedReadingInterval` Intervalles de lecture de la vitesse indiquant la densité du trafic Applicable dans le cas des préférences de routage `TRAFFIC_AWARE` et `TRAFFIC_AWARE_OPTIMAL`. Les intervalles couvrent toute la polyligne de l'itinéraire, sans chevauchement. Le point de début d'un intervalle spécifié est identique au point de fin 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 des informations sur les péages sur l'itinéraire. Ce champ n'est renseigné que si nous estimons qu'il y aura des péages sur l'itinéraire. Si ce champ est défini, mais que le sous-champ "estimated_price" n'est pas renseigné, il est normal que la route contienne des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'est pas défini, il n'y aura pas de péage sur l'itinéraire.

speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture de la vitesse indiquant la densité du trafic Applicable dans le cas des préférences de routage TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent toute la polyligne de l'itinéraire, sans chevauchement. Le point de début d'un intervalle spécifié est identique au point de fin 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`	Déplacements en voiture à passagers.
`BICYCLE`	Se déplacer à vélo.
`WALK`	Déplacements à pied.
`TWO_WHEELER`	Véhicule motorisé à deux roues. Exemple : moto. Notez que cela diffère du mode de transport `BICYCLE`, qui couvre le mode manuel.
`TAXI`	Prendre un taxi agréé, qui peut permettre au véhicule de circuler sur les voies désignées dans certaines zones Le mode TAXI est une fonctionnalité expérimentale. Si le client demande un itinéraire en TAXI dans une ville pour laquelle les données sur les voies de taxi ne sont pas disponibles, un itinéraire drive est renvoyé.

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. Convient lorsque les conditions de circulation n'ont pas d'importance. L'utilisation de cette valeur produit la latence la plus faible.
`TRAFFIC_AWARE`	Calcule des 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 produit la latence la plus élevée.

SpeedReadingInterval

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

Champs

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

start_polyline_point_index

int32

Index de départ de cet intervalle dans la polyligne. Au format JSON, lorsque l'index est égal à 0, le champ semble être non renseigné.

end_polyline_point_index

int32

Index de fin de cet intervalle dans la polyligne. Au format JSON, lorsque l'index est égal à 0, le champ semble être non renseigné.

speed

Speed

Vitesse du trafic pour cet intervalle.

Vitesse

Classification de la vitesse d'une polyligne 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 ne s'est formé.
`TRAFFIC_JAM`	Embouteillage détecté.

TollInfo

Encapsule les informations de péage sur un Route ou un RouteLeg.

Champs

Champs
`estimated_price[]`	`Money` Valeur monétaire des péages pour l'itinéraire ou le RouteLeg correspondant. Cette liste contient un montant monétaire pour chaque devise qui devrait ê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 trajets 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 le RouteLeg correspondant. Cette liste contient un montant monétaire pour chaque devise qui devrait ê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 trajets internationaux, cette liste peut contenir plusieurs éléments afin de refléter les péages dans différentes devises.

TollPass

Liste des pass de péage que nous acceptons à travers le monde.

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 péages de Sydney. https://www.myetoll.com.au
`AU_EWAY_TAG`	L'un des nombreux fournisseurs de péages de Sydney. https://www.tollpay.com.au/
`AU_LINKT`	Péage traversant l'Australie. Pour en savoir plus, consultez le site https://www.linkt.com.au/.
`AR_TELEPASE`	Pass de péage 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 la page 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 le site https://www.semparar.com.br.
`BR_TAGGY`	Pass de péage pour le Brésil. Pour en savoir plus, consultez le site 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`	Passage frontalier entre le Canada et les États-Unis.
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	Passage frontalier entre le Canada et les États-Unis.
`CA_US_BLUE_WATER_EDGE_PASS`	Poste-frontière entre l'Ontario, le Canada et le Michigan, aux États-Unis.
`CA_US_CONNEXION`	Poste-frontière entre l'Ontario, le Canada et le Michigan, aux États-Unis.
`CA_US_NEXUS_CARD`	Passage frontalier entre le Canada et les États-Unis.
`ID_E_TOLL`	Indonésie. Carte électronique fournie par plusieurs banques et utilisée pour payer les péages. Toutes les cartes électroniques émises par les banques sont facturées de la même manière. Une seule valeur enum est donc nécessaire. 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`	Exemption de plaque d'immatriculation de l'État de l'Inde (HP)
`MX_TAG_IAVE`	Pass de péage au Mexique.
`MX_TAG_TELEVIA`	Entreprise de télépéage au Mexique. C'est l'un des nombreux établissements opérant à Mexico. Pour en savoir plus, consultez https://www.televia.com.mx.
`MX_VIAPASS`	Pass de péage au Mexique. Pour en savoir plus, consultez la page 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`	AK, États-Unis.
`US_CA_FASTRAK`	en Californie, États-Unis.
`US_CA_FASTRAK_CAV_STICKER`	Indique que le conducteur dispose d'une carte FasTrak en plus de l'autocollant CAV émis par le DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	Colorado, États-Unis.
`US_CO_GO_PASS`	Colorado, É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`	en Inde, aux É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`	Kentucky, É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 York, É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`	Rhode Island, É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 spécifiant l'unité de mesure à utiliser 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é. La valeur par défaut est GASOLINE.
`GASOLINE`	Véhicule à essence/essence.
`ELECTRIC`	Véhicule électrique.
`HYBRID`	Véhicule hybride (électrique ou essence, par exemple)

VehicleInfo

Encapsule les informations sur le véhicule, telles que 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 les arrêts intermédiaires sur l'itinéraire.

Champs
`via`	`bool` Marque ce point de cheminement comme un jalon plutôt que comme un point d'arrêt. Pour chaque point de cheminement non via de la requête, la réponse ajoute une entrée au tableau `legs` afin de fournir les détails des arrêts de 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 des points de cheminement n'entraînent pas l'ajout d'une entrée au tableau `legs`, mais ils guident le trajet par le point de cheminement. Vous ne pouvez définir cette valeur que sur des points de cheminement intermédiaires. La requête échoue si vous définissez ce champ sur les 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, et que l'intention est de monter ou de descendre. Lorsque vous définissez cette valeur, l'itinéraire calculé n'inclut pas les points de cheminement autres que `via` sur les routes non adaptées aux lieux de prise en charge et de dépose. 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 être prioritaire pour que le véhicule s'arrête à un côté de la route en particulier. Lorsque vous définissez cette valeur, l'itinéraire passe par l'emplacement afin que le véhicule puisse s'arrêter sur le côté de la route vers lequel l'emplacement est orienté à partir du centre. Cette option ne fonctionne que pour "Drive". et "TWO_WHEELER" modes de transport 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, y compris un en-tête facultatif.
`place_id`	`string` ID de lieu du POI associé au point de cheminement.