Package google.maps.routes.v1

Index

RoutesPreferred

L'API Routes Preferred.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Étant donné un ensemble de points de cheminement intermédiaires et de destination, ainsi qu'un objectif d'itinéraire, calcule le meilleur itinéraire pour l'objectif d'itinéraire. Renvoie également l'itinéraire le plus rapide et l'itinéraire le plus court comme 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 à l'aide de l'en-tête HTTP/gRPC X-Goog-FieldMask (consultez les paramètres et en-têtes d'URL disponibles). La valeur est une liste de chemins de champ séparés par une virgule. Consultez cette documentation détaillée sur la construction des chemins de champ.

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, durées, informations sur les jetons et les péages des itinéraires : 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 générique (*) ou la spécification du masque de champ au niveau supérieur (routes), car :

  • En ne sélectionnant que les champs dont vous avez besoin, vous aidez notre serveur à économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
  • Si vous ne sélectionnez que les champs dont vous avez besoin dans votre job de production, vous garantissez des performances de latence stables. Nous pourrons être amenés à ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourront nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs au niveau supérieur, les performances peuvent se dégrader, car tout nouveau champ que nous ajouterons sera automatiquement inclus dans la réponse.
  • Si vous ne sélectionnez que les champs dont vous avez besoin, la taille de la réponse sera plus petite, ce qui augmentera 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

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Accepte une liste d'origines et de destinations, et renvoie un flux contenant des informations sur l'itinéraire pour chaque combinaison d'origine 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 à l'aide de l'en-tête HTTP/gRPC X-Goog-FieldMask (consultez les paramètres et en-têtes d'URL disponibles). La valeur est une liste de chemins de champ séparés par une virgule. Consultez cette documentation détaillée sur la construction des chemins de champ.

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 durées et distances des itinéraires, de l'état des éléments, de la condition et des index 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, car sinon tous les messages sembleront corrects. Google déconseille l'utilisation du masque de champ de réponse générique (*), car :

  • En ne sélectionnant que les champs dont vous avez besoin, vous aidez notre serveur à économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
  • Si vous ne sélectionnez que les champs dont vous avez besoin dans votre job de production, vous garantissez des performances de latence stables. Nous pourrons être amenés à ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourront nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs au niveau supérieur, les performances peuvent se dégrader, car tout nouveau champ que nous ajouterons sera automatiquement inclus dans la réponse.
  • Si vous ne sélectionnez que les champs dont vous avez besoin, la taille de la réponse sera plus petite, ce qui augmentera 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

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 intermédiaires 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 à l'aide d'un en-tête HTTP/gRPC X-Goog-FieldMask (consultez les paramètres et en-têtes d'URL disponibles). La valeur est une liste de chemins de champ séparés par une virgule. Consultez la documentation détaillée sur la construction des chemins de champ.

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 la durée, de la distance et de 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 l'utilisation du masque de champ de réponse générique (*) ou la spécification du masque de champ au niveau supérieur (routes), car :

  • En ne sélectionnant que les champs dont vous avez besoin, vous aidez notre serveur à économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
  • Si vous ne sélectionnez que les champs dont vous avez besoin dans votre job de production, vous garantissez des performances de latence stables. Nous pourrons être amenés à ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourront nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs au niveau supérieur, les performances peuvent se dégrader, car tout nouveau champ que nous ajouterons sera automatiquement inclus dans la réponse.
  • Si vous ne sélectionnez que les champs dont vous avez besoin, la taille de la réponse sera plus petite, ce qui augmentera 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 le long de l'itinéraire (à l'exclusion des points de terminaison), pour s'arrêter ou passer par un lieu. Vous pouvez ajouter jusqu'à 25 points de cheminement intermédiaires.

travel_mode

RouteTravelMode

Facultatif. Spécifie le mode de transport. Seules les valeurs DRIVE et "TWO_WHEELER" sont acceptées.

routing_preference

RoutingPreference

Facultatif. Indique comment calculer l'itinéraire. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer l'itinéraire. Si la préférence de routage génère une erreur ou une latence très longue, une erreur est renvoyée. 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 est définie par défaut sur l'heure à laquelle vous avez envoyé la demande. Si vous définissez cette valeur sur une heure déjà passée, la requête échoue.

route_modifiers

RouteModifiers

Facultatif. Ensemble de conditions à respecter 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 Identifiant de paramètre régional Unicode. Pour obtenir la liste des langues disponibles, consultez Langues acceptées. Si vous ne fournissez pas cette valeur, la langue d'affichage est déduite de la localisation de la demande d'itinéraire.

units

Units

Facultatif. Spécifie les unités de mesure pour les 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 la distance et la durée de l'itinéraire, de la section et de l'étape. Si vous ne fournissez pas cette valeur, les unités d'affichage sont déduites de l'emplacement de la demande.

ComputeCustomRoutesResponse

Message de réponse ComputeCustomRoutes.

Champs
routes[]

CustomRoute

Les "meilleurs" itinéraires pour l'objectif d'itinéraire saisi.

fastest_route

CustomRoute

L'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 solutions de repli :

  1. S'il ne peut pas calculer l'itinéraire à l'aide du routing_preference demandé par le client, il utilisera un autre mode de routage. Dans ce cas, fallback_routing_mode et routing_mode_fallback_reason sont utilisés pour communiquer le mode de routage de secours utilisé, ainsi que la raison du secours.

  2. S'il ne parvient pas à calculer le "meilleur" itinéraire pour l'objectif d'itinéraire spécifié par le client, il peut revenir à un autre objectif. fallback_route_objective est utilisé pour communiquer l'objectif de l'itinéraire de secours.

Champs
routing_mode

FallbackRoutingMode

Mode de routage utilisé pour la réponse. Si le mode de repli 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 secours a été utilisée au lieu de la réponse d'origine. Ce champ n'est renseigné que lorsque le mode de secours est déclenché et que la réponse de secours est renvoyée.

route_objective

FallbackRouteObjective

Objectif de la route utilisé pour la réponse. Si le mode secours a été déclenché, l'objectif peut être différent de l'objectif de 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 RateCard et définit include_tolls sur "true", et que Google ne dispose pas de données sur les prix des péages pour l'itinéraire, l'API revient à RateCard sans tenir compte du prix des péages.

ComputeRouteMatrixRequest

Message de requête ComputeRouteMatrix

Champs
origins[]

RouteMatrixOrigin

Obligatoire. Tableau d'origines, qui détermine les lignes de la matrice de réponse. Plusieurs restrictions de taille s'appliquent à la cardinalité des origines et des destinations :

  • Le nombre d'éléments (origines × destinations) ne doit en aucun cas dépasser 625.
  • Le nombre d'éléments (origines × destinations) ne doit pas dépasser 100 si routing_preference est défini sur TRAFFIC_AWARE_OPTIMAL.
  • Le nombre de points de cheminement (origines + destinations) spécifié comme place_id ne doit pas dépasser 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. Indique comment calculer l'itinéraire. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer l'itinéraire. Si la préférence de routage génère une erreur ou une latence très longue, une erreur est renvoyée. 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, la valeur par défaut correspond à l'heure à laquelle vous avez envoyé 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 le long de l'itinéraire (à l'exclusion des points de terminaison), pour s'arrêter ou passer par un lieu. Vous pouvez ajouter jusqu'à 25 points de cheminement intermédiaires.

travel_mode

RouteTravelMode

Facultatif. Spécifie le mode de transport.

routing_preference

RoutingPreference

Facultatif. Indique comment calculer l'itinéraire. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer l'itinéraire. Si la préférence de routage génère une erreur ou une latence très longue, une erreur est renvoyée. 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 est définie par défaut sur l'heure à laquelle vous avez envoyé la demande. Si vous définissez cette valeur sur une heure déjà passée, la requête échoue.

compute_alternative_routes

bool

Facultatif. Indique s'il faut calculer des itinéraires alternatifs en plus de l'itinéraire. Aucun itinéraire alternatif n'est renvoyé pour les requêtes comportant des points de cheminement intermédiaires.

route_modifiers

RouteModifiers

Facultatif. Ensemble de conditions à respecter qui affectent le 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 Identifiant de paramètre régional Unicode. Pour obtenir la liste des langues disponibles, consultez Langues acceptées. Si vous ne fournissez pas cette valeur, la langue d'affichage est déduite de la localisation de la demande d'itinéraire.

units

Units

Facultatif. Spécifie les unités de mesure pour les 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 la distance et la durée de l'itinéraire, de la section et de l'étape. Si vous ne fournissez pas cette valeur, les unités d'affichage sont déduites de l'emplacement de la demande.

optimize_waypoint_order

bool

Si optimizeWaypointOrder est défini sur "true", une tentative est faite pour réorganiser les waypoints intermédiaires spécifiés afin de minimiser le coût global de l'itinéraire. Si l'un des points de cheminement intermédiaires est un point de cheminement intermédiaire, la requête échoue. Utilisez ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index pour trouver 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 optimize_waypoint_order est défini sur "false", ComputeRoutesResponse.optimized_intermediate_waypoint_index est vide.

ComputeRoutesResponse

Message de réponse ComputeRoutes.

Champs
routes[]

Route

Contient un tableau d'itinéraires calculés (jusqu'à trois) lorsque vous spécifiez compute_alternatives_routes, et ne contient qu'un seul itinéraire lorsque vous ne le spécifiez 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'aucun itinéraire n'a été trouvé.

fallback_info

FallbackInfo

Dans certains cas, lorsque le serveur n'est pas en mesure de calculer les résultats de l'itinéraire avec toutes les préférences d'entrée, il peut revenir à 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 au NavSDK pour reconstruire l'itinéraire personnalisé pour la navigation guidée.

Champs
route

Route

Il s'agit de l'itinéraire considéré comme le "meilleur" pour l'objectif de l'itinéraire saisi.

token

string

Jeton d'itinéraire encodé au format base64 adapté au Web, qui peut être transmis au SDK Navigation. Il permet au SDK Navigation de reconstruire l'itinéraire pendant la navigation et, en cas de changement d'itinéraire, de respecter l'intention initiale lorsque RoutesPreferred ComputeCustomRoutes est appelé. Les clients doivent traiter ce jeton comme un blob opaque.

FallbackInfo

Informations sur la façon et la raison pour lesquelles 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 celui que vous préférez comme solution de repli.

Champs
routing_mode

FallbackRoutingMode

Mode de routage utilisé pour la réponse. Si le mode de repli 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 secours a été utilisée au lieu de la réponse d'origine. Ce champ n'est renseigné que lorsque le mode de secours est déclenché et que la réponse de secours est renvoyée.

FallbackReason

Motifs d'utilisation de la réponse de secours.

Enums
FALLBACK_REASON_UNSPECIFIED Aucun motif de remplacement n'a été spécifié.
SERVER_ERROR Une erreur de serveur s'est produite lors du calcul des itinéraires avec votre mode de calcul 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 de déplacement 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 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 emplacement (un point géographique et un cap facultatif).

Champs
lat_lng

LatLng

Coordonnées géographiques du point de repère.

heading

Int32Value

Orientation de la boussole associée au sens du trafic. Cette valeur spécifie le côté de la route à utiliser pour la prise en charge et la dépose. Les valeurs de cap peuvent être comprises entre 0 et 360, où 0 correspond à un cap plein nord, 90 à un cap plein est, et ainsi de suite. Vous ne pouvez utiliser ce champ que pour les modes de déplacement DRIVE et TWO_WHEELER.

Manœuvre

Ensemble de valeurs qui spécifient l'action de navigation à effectuer pour l'étape en cours (par exemple, tourner à gauche, s'insérer ou tout droit).

Enums
MANEUVER_UNSPECIFIED Non utilisé.
TURN_SLIGHT_LEFT Tournez légèrement vers la gauche.
TURN_SHARP_LEFT Tournez brusquement à gauche.
UTURN_LEFT Faites demi-tour vers la gauche.
TURN_LEFT Tournez à gauche.
TURN_SLIGHT_RIGHT Tournez légèrement vers la droite.
TURN_SHARP_RIGHT Tournez brusquement à droite.
UTURN_RIGHT Faites demi-tour vers la droite.
TURN_RIGHT Tournez à droite.
STRAIGHT Va tout droit.
RAMP_LEFT Prenez la bretelle de gauche.
RAMP_RIGHT Prenez la bretelle de droite.
MERGE Insérez-vous dans le trafic.
FORK_LEFT Prenez la bifurcation de gauche.
FORK_RIGHT Prenez la fourche de droite.
FERRY Prenez 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.
DEPART Manœuvre initiale.
NAME_CHANGE Indique un changement de nom de rue.
DESTINATION Utilisé pour indiquer l'arrivée à destination.
Champs
maneuver

Maneuver

Encapsule les instructions de navigation pour l'étape en cours (par exemple, tourner à gauche, s'insérer ou continuer tout droit). Ce champ détermine l'icône à afficher.

instructions

string

Instructions pour cette étape.

Polyline

Encapsule une polyligne encodée.

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

string

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

geo_json_linestring

Struct

Spécifie une polyligne à l'aide du format LineString GeoJSON.

PolylineEncoding

Spécifie le type de polyligne à renvoyer.

Enums
POLYLINE_ENCODING_UNSPECIFIED Aucune préférence de type de polyligne n'a été 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 à l'aide du format LineString GeoJSON.

PolylineQuality

Ensemble de valeurs qui spécifient 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 de plus de points que OVERVIEW, au détriment de la taille de la réponse. Utilisez cette valeur lorsque vous avez besoin de plus de précision.
OVERVIEW Spécifie une polyligne d'aperçu, qui est composée d'un petit nombre de points. Utilisez cette valeur lorsque vous affichez un aperçu de l'itinéraire. Cette option présente une latence de requête plus faible que l'option HIGH_QUALITY.

Route

Encapsule un itinéraire, qui se compose d'une série de segments de route connectés qui relient les 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 composent 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 seule 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 à l'ordre des points de cheminement, de origin à intermediates, puis à destination.

distance_meters

int32

Distance de l'itinéraire en mètres.

duration

Duration

Durée 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 sans tenir compte des conditions de circulation.

polyline

Polyline

Polyligne de l'itinéraire global. Cette polyligne est 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 ; Intermédiaires : Dallas, Bangor, Phoenix ; Destination : New York" et que l'ordre optimisé des points de cheminement intermédiaires soit "Phoenix, Dallas, Bangor". Ce champ contient alors les valeurs [2, 0, 1]. L'index commence à 0 pour le premier point de chemin intermédiaire.

RouteLeg

Encapsule un segment entre des points de repère non-via.

Champs
distance_meters

int32

Distance parcourue pour la section de l'itinéraire, en mètres.

duration

Duration

Durée nécessaire pour parcourir la section. Si route_preference est défini sur TRAFFIC_UNAWARE, cette valeur est identique à static_duration. Si route_preference est défini 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 dans la section, calculée sans tenir compte des conditions de circulation.

polyline

Polyline

Polyligne globale pour cette section. Cela inclut la polyligne de chaque step.

start_location

Location

Emplacement de départ de cette étape. Elle peut être différente de la valeur origin fournie. Par exemple, lorsque le origin fourni n'est pas à proximité d'une route, il s'agit d'un point sur la route.

end_location

Location

Emplacement de fin de cette section. Elle peut être différente de la valeur destination fournie. Par exemple, lorsque le destination fourni n'est 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, etc. sur une étape de l'itinéraire.

RouteLegStep

Encapsule un segment d'un RouteLeg. Une étape correspond à une instruction de navigation unique. Les tronçons d'itinéraire sont composés d'étapes.

Champs
distance_meters

int32

Distance parcourue lors de cette étape, en mètres. Dans certains cas, ce champ peut ne pas avoir de valeur.

static_duration

Duration

Durée du trajet à cette étape sans tenir compte des conditions de circulation. Dans certains cas, ce champ peut ne pas avoir de valeur.

polyline

Polyline

Polyligne associée à cette étape.

start_location

Location

Point de départ de cette étape.

end_location

Location

Emplacement de 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 restrictions de zone de circulation possibles sur une étape du trajet.

RouteLegStepTravelAdvisory

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

Champs
speed_reading_intervals[]

SpeedReadingInterval

REMARQUE : Ce champ n'est pas renseigné pour le moment.

RouteLegTravelAdvisory

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

Champs
toll_info

TollInfo

Encapsule les informations sur les péages sur le RouteLeg spécifique. Ce champ n'est renseigné que si nous prévoyons des péages sur le RouteLeg. Si ce champ est défini, mais que le sous-champ estimated_price n'est pas renseigné, nous partons du principe que la route comporte des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'existe pas, cela signifie qu'il n'y a pas de péage sur la RouteLeg.

speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture rapide indiquant la densité du trafic. Applicable en cas de préférences de routage TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent l'intégralité de la polyligne de RouteLeg sans se chevaucher. 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

Destination unique pour ComputeRouteMatrixRequest

Champs
waypoint

Waypoint

Obligatoire. Point de cheminement de destination

RouteMatrixElement

Encapsule les informations de route calculées pour une paire origine/destination dans l'API ComputeRouteMatrix. Ce proto peut être diffusé au 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épendamment de l'état.

distance_meters

int32

Distance de l'itinéraire en mètres.

duration

Duration

Durée 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 sans tenir compte des conditions de circulation.

travel_advisory

RouteTravelAdvisory

Informations supplémentaires sur l'itinéraire. Par exemple : informations sur les restrictions et 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 données pour cette paire origine/destination, il peut revenir à 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 OK.
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 n'a pu être 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 seule origine pour ComputeRouteMatrixRequest

Champs
waypoint

Waypoint

Obligatoire. Point de cheminement d'origine

route_modifiers

RouteModifiers

Facultatif. Modificateurs pour chaque itinéraire qui prend ce point comme origine

RouteModifiers

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

Champs
avoid_tolls

bool

Lorsque la valeur est définie sur "true", les routes à péage sont évitées dans la mesure du possible, en privilégiant les itinéraires qui n'en comportent pas. Ne s'applique qu'aux modes de déplacement DRIVE et TWO_WHEELER.

avoid_highways

bool

Lorsque la valeur est définie sur "true", les voies rapides sont évitées dans la mesure du possible, et la préférence est donnée aux itinéraires qui n'en contiennent pas. Ne s'applique qu'aux modes de déplacement DRIVE et TWO_WHEELER.

avoid_ferries

bool

Lorsque la valeur est définie sur "true", les ferries sont évités dans la mesure du possible, en privilégiant les itinéraires qui n'en comportent pas. Ne s'applique qu'aux modes de transport DRIVE et TWO_WHEELER.

avoid_indoor

bool

Lorsque cette valeur est définie sur "true", la navigation en intérieur est évitée dans la mesure du possible, en privilégiant les itinéraires ne contenant pas de navigation en intérieur. Ne s'applique qu'au mode de déplacement WALK.

vehicle_info

VehicleInfo

Spécifie les informations sur le véhicule.

toll_passes[]

TollPass

Encapsule les informations sur le télépéage. Si des badges de télépéage sont fournis, l'API tente de renvoyer le prix du badge. Si aucun télépéage n'est fourni, l'API considère qu'il est inconnu et tente de renvoyer le prix en espèces. Ne s'applique qu'aux modes de déplacement DRIVE et TWO_WHEELER.

RouteObjective

Encapsule un objectif à optimiser par ComputeCustomRoutes.

Champs
Champ d'union objective. Objectif de l'itinéraire. objective ne peut être qu'un des éléments suivants :
rate_card

RateCard

Objectif RateCard.

RateCard

Encapsule un objectif d'itinéraire RateCard.

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 s'il faut inclure le coût des péages dans le coût global.

MonetaryCost

Encapsule le coût utilisé dans la grille tarifaire.

Champs
value

double

Obligatoire. Valeur du coût dans la devise locale déduite de la demande.

RouteTravelAdvisory

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

Champs
toll_info

TollInfo

Encapsule les informations sur les péages sur l'itinéraire. Ce champ n'est renseigné que si nous prévoyons des péages sur l'itinéraire. Si ce champ est défini, mais que le sous-champ estimated_price n'est pas renseigné, nous partons du principe que la route comporte des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'est pas défini, cela signifie qu'il n'y a pas de péage sur l'itinéraire.

speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture rapide indiquant la densité du trafic. Applicable en cas de préférences de routage TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent l'intégralité de la polyligne de l'itinéraire sans se chevaucher. 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 utilisé pour spécifier le mode de transport.

Enums
TRAVEL_MODE_UNSPECIFIED Aucun mode de déplacement n'a été spécifié. La valeur par défaut est DRIVE.
DRIVE Trajet en voiture de tourisme.
BICYCLE Déplacez-vous à vélo.
WALK Se déplacer à pied
TWO_WHEELER Véhicule motorisé à deux roues. Par exemple, une moto. Notez que ce mode de déplacement diffère du mode BICYCLE, qui couvre les modes de déplacement à propulsion humaine.
TAXI

Voyagez en taxi agréé, qui peut être autorisé à circuler sur des voies réservées aux taxis dans certaines zones.

Le mode TAXI est une fonctionnalité expérimentale. Si un client demande un itinéraire en TAXI dans une ville où les données sur les voies de taxi ne sont pas disponibles, un itinéraire en VOITURE est renvoyé.

RoutingPreference

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

Enums
ROUTING_PREFERENCE_UNSPECIFIED Aucune préférence de routage n'a été spécifiée. Valeur par défaut : TRAFFIC_AWARE
TRAFFIC_UNAWARE Calcule les itinéraires sans tenir compte des conditions de circulation en temps réel. Convient lorsque les conditions de trafic n'ont pas d'importance ou ne s'appliquent pas. Cette valeur permet d'obtenir la latence la plus faible. Remarque : Pour les modes RouteTravelMode DRIVE et TWO_WHEELER, l'itinéraire et la durée sont déterminés en fonction du réseau routier et des conditions de circulation moyennes toutes heures confondues, et non de l'état actuel des routes. Par conséquent, l'itinéraire peut inclure des routes temporairement fermées. Les résultats d'une requête donnée peuvent varier au fil du temps en raison des modifications du réseau routier, de l'évolution des conditions de circulation moyennes et de la nature décentralisée du service. Les résultats peuvent également varier entre plusieurs itinéraires presque équivalents à tout moment et à n'importe quelle fréquence.
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 des performances. 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 chemin. Étant donné un chemin avec des points P_0, P_1, ... , P_N (index basé sur zéro), SpeedReadingInterval définit un intervalle et décrit son trafic à l'aide des catégories suivantes.

Champs
start_polyline_point_index

int32

Index de début de cet intervalle dans la polyligne. En JSON, lorsque l'index est défini sur 0, le champ semble vide.

end_polyline_point_index

int32

Index de fin de cet intervalle dans la polyligne. En JSON, lorsque l'index est défini sur 0, le champ semble vide.

speed

Speed

Vitesse du trafic dans cet intervalle.

Vitesse

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 La vitesse est normale, aucun ralentissement n'a été détecté.
SLOW Ralentissement détecté, mais pas d'embouteillage.
TRAFFIC_JAM Embouteillage détecté.

TollInfo

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

Champs
estimated_price[]

Money

Montant monétaire des péages pour le Route ou le RouteLeg correspondant. Cette liste contient un montant pour chaque devise qui devrait être facturé par les péages. En général, cette liste ne contient qu'un seul élément pour les itinéraires avec péages dans une seule devise. Pour les trajets internationaux, cette liste peut contenir plusieurs éléments pour refléter les péages dans différentes devises.

TollPass

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

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 de Sydney. https://www.myetoll.com.au
AU_EWAY_TAG L'un des nombreux fournisseurs de télépéage de Sydney. https://www.tollpay.com.au/
AU_LINKT Abonnement de télépéage valable dans toute l'Australie. Pour en savoir plus, consultez https://www.linkt.com.au/.
AR_TELEPASE Télépéage en Argentine. Pour en savoir plus, consultez https://telepase.com.ar.
BR_AUTO_EXPRESO Télépéage au Brésil. Pour en savoir plus, consultez https://www.autoexpreso.com.
BR_CONECTCAR Télépéage au Brésil. Pour en savoir plus, consultez https://conectcar.com.
BR_MOVE_MAIS Télépéage au Brésil. Pour en savoir plus, consultez https://movemais.com.
BR_PASSA_RAPIDO Télépéage au Brésil. Pour en savoir plus, consultez https://pasorapido.gob.do/.
BR_SEM_PARAR Télépéage au Brésil. Pour en savoir plus, consultez https://www.semparar.com.br.
BR_TAGGY Télépéage au Brésil. Pour en savoir plus, consultez https://taggy.com.br.
BR_VELOE Télépéage au Brésil. Pour en savoir plus, consultez https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Passage de la frontière entre le Canada et les États-Unis.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Passage de la frontière entre le Canada et les États-Unis.
CA_US_BLUE_WATER_EDGE_PASS Passage de la frontière entre l'Ontario (Canada) et le Michigan (États-Unis).
CA_US_CONNEXION Passage de la frontière entre l'Ontario (Canada) et le Michigan (États-Unis).
CA_US_NEXUS_CARD Passage de la frontière 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 e-cartes émises par les banques sont facturées au même prix. 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, exonération de la plaque d'immatriculation de l'État de l'Himachal Pradesh.
JP_ETC ETC au Japon. Système électronique sans fil pour collecter les péages. https://www.go-etc.jp/
JP_ETC2 Japon ETC2.0. Nouvelle version d'ETC avec une remise supplémentaire et une communication bidirectionnelle entre les appareils des véhicules et les antennes sur la route. https://www.go-etc.jp/etc2/index.html
MX_IAVE Mexique https://iave.capufe.gob.mx/#/
MX_PASE Mexique https://www.pase.com.mx
MX_QUICKPASS Mexique : https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA Mexique http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Mexique
MX_TAG_TELEVIA Société mexicaine de télépéage. L'un des nombreux centres d'opérations de Mexico. Pour en savoir plus, consultez https://www.televia.com.mx.
MX_TELEVIA Société mexicaine de télépéage. L'un des nombreux opérateurs à Mexico. https://www.televia.com.mx
MX_VIAPASS Télépéage au Mexique Pour en savoir plus, consultez https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, États-Unis.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, États-Unis.
US_CA_FASTRAK CA, États-Unis.
US_CA_FASTRAK_CAV_STICKER Indique que le conducteur possède un pass FasTrak en plus de l'autocollant Clean Air Vehicle (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 DE, États-Unis.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, États-Unis.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, États-Unis.
US_FL_EPASS FL, États-Unis.
US_FL_GIBA_TOLL_PASS FL, États-Unis.
US_FL_LEEWAY FL, États-Unis.
US_FL_SUNPASS FL, États-Unis.
US_FL_SUNPASS_PRO FL, États-Unis.
US_IL_EZPASSIL IL, États-Unis.
US_IL_IPASS IL, États-Unis.
US_IN_EZPASSIN IN, États-Unis.
US_KS_BESTPASS_HORIZON KS, États-Unis.
US_KS_KTAG KS, États-Unis.
US_KS_NATIONALPASS KS, États-Unis.
US_KS_PREPASS_ELITEPASS KS, États-Unis.
US_LA_GEAUXPASS LA, États-Unis.
US_LA_TOLL_TAG LA, États-Unis.
US_MA_EZPASSMA MA, États-Unis.
US_MD_EZPASSMD MD, États-Unis.
US_ME_EZPASSME ME, États-Unis.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, États-Unis.
US_MI_BCPASS MI, États-Unis.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, États-Unis.
US_MI_IQ_PROX_CARD

MI, États-Unis. Obsolète, car ce type de pass n'existe plus.

US_MI_IQ_TAG MI, États-Unis.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, États-Unis.
US_MI_NEXPRESS_TOLL MI, États-Unis.
US_MN_EZPASSMN MN, États-Unis.
US_NC_EZPASSNC NC, États-Unis.
US_NC_PEACH_PASS NC, États-Unis.
US_NC_QUICK_PASS NC, États-Unis.
US_NH_EZPASSNH NH, États-Unis.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, États-Unis.
US_NJ_EZPASSNJ NJ, États-Unis.
US_NY_EXPRESSPASS NY, États-Unis.
US_NY_EZPASSNY NY, États-Unis.
US_OH_EZPASSOH OH, États-Unis.
US_PA_EZPASSPA PA, États-Unis.
US_RI_EZPASSRI RI, États-Unis.
US_SC_PALPASS SC, États-Unis.
US_TX_AVI_TAG TX, États-Unis.
US_TX_BANCPASS TX, États-Unis.
US_TX_DEL_RIO_PASS TX, États-Unis.
US_TX_EFAST_PASS TX, États-Unis.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, États-Unis.
US_TX_EPTOLL TX, États-Unis.
US_TX_EZ_CROSS TX, États-Unis.
US_TX_EZTAG TX, États-Unis.
US_TX_FUEGO_TAG TX, États-Unis.
US_TX_LAREDO_TRADE_TAG TX, États-Unis.
US_TX_PLUSPASS TX, États-Unis.
US_TX_TOLLTAG TX, États-Unis.
US_TX_TXTAG TX, États-Unis.
US_TX_XPRESS_CARD TX, États-Unis.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, États-Unis.
US_VA_EZPASSVA VA, États-Unis.
US_WA_BREEZEBY WA, États-Unis.
US_WA_GOOD_TO_GO WA, États-Unis.
US_WV_EZPASSWV WV, États-Unis.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, États-Unis.
US_WV_MOV_PASS WV, États-Unis
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, États-Unis.

Unités

Ensemble de valeurs qui spécifient l'unité de mesure utilisée dans l'affichage.

Enums
UNITS_UNSPECIFIED Les unités de mesure ne sont pas spécifiées. La valeur par défaut correspond à l'unité de mesure déduite de la requête.
METRIC Unités de mesure métriques.
IMPERIAL Unités de mesure impériales (anglaises).

VehicleEmissionType

Ensemble de valeurs décrivant le type d'émissions du véhicule. Ne s'applique qu'au mode de déplacement "VOITURE".

Enums
VEHICLE_EMISSION_TYPE_UNSPECIFIED Aucun type d'émission n'a été spécifié. La valeur par défaut est "GASOLINE".
GASOLINE Véhicule à essence
ELECTRIC Véhicule électrique
HYBRID Véhicule hybride (essence et électricité, par exemple)

VehicleInfo

Encapsule les informations sur le véhicule, telles que le type d'émissions.

Champs
emission_type

VehicleEmissionType

Décrit le type d'émissions du véhicule. Ne s'applique qu'à la DRIVE RouteTravelMode.

Repère

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

Champs
via

bool

Marque ce point de cheminement comme un jalon plutôt qu'un point d'arrêt. Pour chaque point de cheminement autre que "via" dans la requête, la réponse ajoute une entrée au tableau legs pour fournir les détails des escales sur cette partie du trajet. Définissez cette valeur sur "true" lorsque vous souhaitez que l'itinéraire passe par ce point de cheminement sans s'y arrêter. Les points de cheminement intermédiaires n'entraînent pas l'ajout d'une entrée au tableau legs, mais ils permettent de définir l'itinéraire passant par le point de cheminement. Vous ne pouvez définir cette valeur que sur les points de cheminement intermédiaires. La requête échoue si vous définissez ce champ sur des points de cheminement de terminal. 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é à l'arrêt des véhicules, dans le but de prendre en charge ou de déposer des passagers. Lorsque vous définissez cette valeur, l'itinéraire calculé n'inclut pas les points de cheminement non via sur les routes qui ne conviennent pas à la prise en charge et à la dépose. Cette option ne fonctionne que pour les modes de déplacement DRIVE et TWO_WHEELER, et lorsque location_type est défini sur location.

side_of_road

bool

Indique que l'emplacement de ce point de cheminement doit s'arrêter de préférence à un côté spécifique de la route. Lorsque vous définissez cette valeur, l'itinéraire passe par l'emplacement afin que le véhicule puisse s'arrêter du côté de la route vers lequel l'emplacement est orienté par rapport au centre de la route. Cette option ne fonctionne que pour les modes de déplacement "VOITURE" et "DEUX_ROUES".

Champ d'union location_type. Différentes façons 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 cap facultatif.

place_id

string

ID de lieu du point d'intérêt associé au point de cheminement.