Package google.maps.routing.v2

Index

Routes

L'API Routes.

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

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 :

  • La somme du nombre d'origines et du nombre de destinations spécifiés comme place_id ou address ne doit pas dépasser 50.
  • Le produit du nombre d'origines par le nombre de destinations ne doit en aucun cas dépasser 625.
  • Le produit du nombre d'origines par le nombre de destinations ne doit pas dépasser 100 si routing_preference est défini sur TRAFFIC_AWARE_OPTIMAL.
  • Le produit du nombre d'origines par le nombre de destinations ne doit pas dépasser 100 si travel_mode est défini sur TRANSIT.
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, elle est définie par défaut sur l'heure à laquelle vous avez envoyé la demande. REMARQUE : Vous ne pouvez spécifier un departure_time dans le passé que lorsque RouteTravelMode est défini sur TRANSIT.
arrival_time

Timestamp

Facultatif. Heure d'arrivée. REMARQUE : Ne peut être défini que lorsque RouteTravelMode est défini sur TRANSIT. Vous pouvez spécifier departure_time ou arrival_time, mais pas les deux.
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 l'emplacement de la première origine.
region_code

string

Facultatif. Code régional, spécifié sous la forme d'une valeur ccTLD (TLD pour top-level domain, domaine de premier niveau) à deux caractères. Pour en savoir plus, consultez Domaines nationaux de premier niveau.
units

Units

Facultatif. Spécifie les unités de mesure pour les champs d'affichage.
extra_computations[]

ExtraComputation

Facultatif. Liste des calculs supplémentaires pouvant être utilisés pour traiter la demande. Remarque : Ces calculs supplémentaires peuvent renvoyer des champs supplémentaires dans la réponse. Ces champs supplémentaires doivent également être spécifiés dans le masque de champ pour être renvoyés dans la réponse.
traffic_model

TrafficModel

Facultatif. Spécifie les hypothèses à utiliser lors du calcul du temps passé dans le trafic. Ce paramètre influe sur la valeur renvoyée dans le champ Duration de RouteMatrixElement, qui contient le temps de trajet prévu en fonction des moyennes historiques. TrafficModel n'est disponible que pour les demandes pour lesquelles RoutingPreference est défini sur TRAFFIC_AWARE_OPTIMAL et RouteTravelMode sur DRIVE. La valeur par défaut est BEST_GUESS si du trafic est demandé et que TrafficModel n'est pas spécifié.
transit_preferences

TransitPreferences

Facultatif. Spécifie les préférences qui influencent l'itinéraire renvoyé pour les itinéraires TRANSIT. REMARQUE : Vous ne pouvez spécifier un transit_preferences que lorsque RouteTravelMode est défini sur TRANSIT.

ExtraComputation

Calculs supplémentaires à effectuer pour traiter la demande.

Enums
EXTRA_COMPUTATION_UNSPECIFIED Non utilisé. Les requêtes contenant cette valeur échoueront.
TOLLS Informations sur les péages pour le ou les éléments de la matrice.

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. REMARQUE : Vous ne pouvez spécifier un departure_time dans le passé que lorsque RouteTravelMode est défini sur TRANSIT. Les trajets en transports en commun sont disponibles pour les sept derniers jours ou les 100 jours à venir.
arrival_time

Timestamp

Facultatif. Heure d'arrivée. REMARQUE : Ce champ est ignoré lorsque les requêtes spécifient un RouteTravelMode autre que TRANSIT. Vous pouvez spécifier departure_time ou arrival_time, mais pas les deux. Les trajets en transports en commun sont disponibles pour les sept derniers jours ou les 100 jours à venir.
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 mode de calcul des itinéraires.
language_code

string

Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez 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.
region_code

string

Facultatif. Code régional, spécifié sous la forme d'une valeur ccTLD (TLD pour top-level domain, domaine de premier niveau) à deux caractères. Pour en savoir plus, consultez Domaines nationaux de premier niveau.
units

Units

Facultatif. Spécifie les unités de mesure pour les champs d'affichage. Ces champs incluent 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 première origine.
optimize_waypoint_order

bool

Facultatif. Si la valeur est définie sur "true", le service tente de minimiser le coût global de l'itinéraire en réorganisant les points de cheminement intermédiaires spécifiés. La requête échoue si l'un des points de cheminement intermédiaires est un point de cheminement via. Utilisez ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index pour trouver le nouvel ordre. Si ComputeRoutesResponse.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 sera vide.
requested_reference_routes[]

ReferenceRoute

Facultatif. Spécifie les itinéraires de référence à calculer dans la requête en plus de l'itinéraire par défaut. Un itinéraire de référence est un itinéraire dont l'objectif de calcul est différent de celui de l'itinéraire par défaut. Par exemple, un calcul d'itinéraire de référence FUEL_EFFICIENT prend en compte différents paramètres qui généreraient un itinéraire optimal en termes de consommation de carburant. Lorsque vous utilisez cette fonctionnalité, recherchez route_labels sur les itinéraires obtenus.
extra_computations[]

ExtraComputation

Facultatif. Liste des calculs supplémentaires pouvant être utilisés pour traiter la demande. Remarque : Ces calculs supplémentaires peuvent renvoyer des champs supplémentaires dans la réponse. Ces champs supplémentaires doivent également être spécifiés dans le masque de champ pour être renvoyés dans la réponse.
traffic_model

TrafficModel

Facultatif. Spécifie les hypothèses à utiliser lors du calcul du temps passé dans le trafic. Ce paramètre influe sur la valeur renvoyée dans le champ Duration des objets Route et RouteLeg, qui contient le temps de trajet prévu en fonction des moyennes historiques. TrafficModel n'est disponible que pour les demandes pour lesquelles RoutingPreference est défini sur TRAFFIC_AWARE_OPTIMAL et RouteTravelMode sur DRIVE. La valeur par défaut est BEST_GUESS si du trafic est demandé et que TrafficModel n'est pas spécifié.
transit_preferences

TransitPreferences

Facultatif. Spécifie les préférences qui influencent l'itinéraire renvoyé pour les itinéraires TRANSIT. REMARQUE : Vous ne pouvez spécifier un transit_preferences que lorsque RouteTravelMode est défini sur TRANSIT.

ExtraComputation

Calculs supplémentaires à effectuer pour traiter la demande. D'autres valeurs pourront être ajoutées à l'avenir.

Enums
EXTRA_COMPUTATION_UNSPECIFIED Non utilisé. Les requêtes contenant cette valeur échoueront.
TOLLS Informations sur les péages pour le ou les itinéraires.
FUEL_CONSUMPTION Consommation de carburant estimée pour le ou les itinéraires.
TRAFFIC_ON_POLYLINE Polylignes tenant compte du trafic pour le ou les itinéraires.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstruction présenté sous la forme d'une chaîne de texte HTML formatée. Ce contenu est destiné à être lu tel quel. Il est uniquement destiné à l'affichage. Ne l'analysez pas de manière programmatique.
FLYOVER_INFO_ON_POLYLINE Informations sur les survols pour le ou les itinéraires. Le fieldmask routes.polyline_details.flyover_info doit être spécifié pour renvoyer ces informations. Ces données ne seront actuellement renseignées que pour certaines agglomérations en Inde. Cette fonctionnalité est expérimentale. Le SKU et les frais sont susceptibles d'être modifiés.
NARROW_ROAD_INFO_ON_POLYLINE Informations sur les routes étroites pour le ou les itinéraires. Le fieldmask routes.polyline_details.narrow_road_info doit être spécifié pour renvoyer ces informations. Ces données ne seront actuellement renseignées que pour certaines agglomérations en Inde. Cette fonctionnalité est expérimentale. Le SKU et les frais sont susceptibles d'être modifiés.
TUNNEL_INFO_ON_POLYLINE Informations sur les tunnels de l'itinéraire ou des itinéraires. Le fieldmask routes.polyline_details.tunnel_info doit être spécifié pour renvoyer ces informations.
BRIDGE_INFO_ON_POLYLINE Informations sur les ponts pour le ou les itinéraires. Le fieldmask routes.polyline_details.bridge_info doit être spécifié pour renvoyer ces informations.
SKYWAY_INFO_ON_POLYLINE Informations sur les routes à péage pour le ou les itinéraires. Le fieldmask routes.polyline_details.skyway_info doit être spécifié pour renvoyer ces informations.

ReferenceRoute

Itinéraire de référence accepté dans ComputeRoutesRequest.

Enums
REFERENCE_ROUTE_UNSPECIFIED Non utilisé. Les requêtes contenant cette valeur échouent.
FUEL_EFFICIENT Itinéraire économe en carburant.
SHORTER_DISTANCE

Itinéraire avec une distance de trajet plus courte. Cette fonctionnalité est expérimentale.

Pour les requêtes DRIVE, cette fonctionnalité privilégie la distance la plus courte au confort de conduite. Par exemple, il peut préférer les routes locales aux autoroutes, emprunter des routes non bitumées, traverser des parkings, etc. Cette fonctionnalité ne renvoie aucune manœuvre que Google Maps sait illégale.

Pour les requêtes BICYCLE et TWO_WHEELER, cette fonctionnalité renvoie des itinéraires semblables à ceux renvoyés lorsque vous ne spécifiez pas requested_reference_routes.

Cette fonctionnalité n'est pas compatible avec d'autres modes de transport, les points de cheminement intermédiaires ni optimize_waypoint_order. Ces demandes échoueront. Toutefois, vous pouvez l'utiliser avec n'importe quel routing_preference.

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

GeocodingResults

Contient des informations sur la réponse de géocoding pour les points de cheminement spécifiés sous forme d'adresses.

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 TRAFFIC_UNAWARE RoutingPreference a été utilisé pour calculer la réponse.
FALLBACK_TRAFFIC_AWARE Indique que TRAFFIC_AWARE RoutingPreference a été utilisé pour calculer la réponse.

GeocodedWaypoint

Détails sur les lieux utilisés comme points de repère. Renseigné uniquement pour les waypoints d'adresse. Inclut des informations sur les résultats du géocodage afin de déterminer à quoi l'adresse a été géocodée.

Champs
geocoder_status

Status

Indique le code d'état résultant de l'opération de géocodage.
type[]

string

Type(s) du résultat, sous la forme de zéro, une ou plusieurs balises de type. Types acceptés : types d'adresses et de composants d'adresse.
partial_match

bool

Indique que le geocoder n'a pas renvoyé de correspondance exacte pour la requête d'origine, bien qu'il ait pu trouver une partie de l'adresse demandée. Nous vous recommandons d'examiner la requête d'origine pour vérifier qu'elle ne contient pas d'erreur de syntaxe et/ou que l'adresse est bien complète.
place_id

string

ID de lieu pour ce résultat.
intermediate_waypoint_request_index

int32

Index du point de cheminement intermédiaire correspondant dans la requête. N'est renseigné que si le point de cheminement correspondant est un point de cheminement intermédiaire.

GeocodingResults

Contient GeocodedWaypoints pour les points de départ, de destination et de cheminement intermédiaires. Renseigné uniquement pour les waypoints d'adresse.

Champs
origin

GeocodedWaypoint

Point de cheminement de départ géocodé.
destination

GeocodedWaypoint

Point de cheminement géocodé de la destination.
intermediates[]

GeocodedWaypoint

Liste des points de cheminement intermédiaires géocodés, chacun contenant un champ d'index qui correspond à la position du point de cheminement dans l'ordre dans lequel il a été spécifié dans la requête (position basée sur zéro).

LocalizedTime

Description localisée de l'heure.

Champs
time

LocalizedText

Heure spécifiée sous forme de chaîne dans un fuseau horaire donné.
time_zone

string

Contient le fuseau horaire. La valeur correspond au nom du fuseau horaire, tel que défini dans la base de données des fuseaux horaires de l'IANA (par exemple, "America/New_York").

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 indique le côté de la route pour la prise en charge et la dépose. Les valeurs d'orientation peuvent être comprises entre 0 et 360, où 0 correspond à une orientation plein nord, 90 à une orientation plein est, etc. Vous ne pouvez utiliser ce champ que pour les RouteTravelMode 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 Se rabattre sur la voie de circulation.
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.

Encapsule les instructions de navigation pour un RouteLegStep.

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 polyligne sous forme de chaîne à l'aide de l'algorithme d'encodage de polylignes
geo_json_linestring

Struct

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

PolylineDetails

Détails correspondant à un index ou à un segment contigu d'une polyligne. Étant donné une polyligne avec des points P_0, P_1, ... , P_N (index basé sur zéro), PolylineDetails définit un intervalle et les métadonnées associées.

Champs
tunnel_info[]

TunnelInfo

Détails du tunnel le long de la polyligne. Ce champ est renseigné si la requête spécifie le modificateur de route avoid_tunnels et que la route résultante ne parvient pas à les éviter, OU si TUNNEL_INFO_ON_POLYLINE est spécifié dans extra_computations et que la route contient des tunnels.
restriction_info[]

RestrictionInfo

Détails des restrictions le long de la polyligne. Ce champ n'est renseigné que si une requête spécifie le modificateur d'itinéraire vehicle_info et que l'itinéraire obtenu contient une restriction applicable. Sinon, ce champ n'est pas utilisé.
flyover_info[]

FlyoverInfo

Détails du survol le long de la polyligne.
narrow_road_info[]

NarrowRoadInfo

Détails sur les routes étroites le long de la polyligne.
bridge_info[]

BridgeInfo

Détails du pont le long de la polyligne.
skyway_info[]

SkywayInfo

Détails sur la voie rapide le long de la polyligne.

BridgeInfo

Encapsule les informations sur les ponts le long de la polyligne.

Champs
bridge_presence

RoadFeatureState

Indique si un pont existe pour une section donnée de la polyligne.
polyline_point_index

PolylinePointIndex

Emplacement des informations liées au pont le long de la polyligne.

FlyoverInfo

Encapsule les informations sur les échangeurs le long de la polyligne.

Champs
flyover_presence

RoadFeatureState

Uniquement en sortie. Indique si un survol existe pour un tronçon donné de la polyligne.
polyline_point_index

PolylinePointIndex

Emplacement des informations associées au survol le long de la polyligne.

NarrowRoadInfo

Encapsule des informations sur les routes étroites le long de la polyligne.

Champs
narrow_road_presence

RoadFeatureState

Uniquement en sortie. Indique si une route étroite existe pour une section donnée de la polyligne.
polyline_point_index

PolylinePointIndex

Emplacement des informations sur la route étroite le long de la polyligne.

PolylinePointIndex

Encapsule les index de début et de fin pour un détail de polyligne. Pour les cas où les données correspondent à un seul point, start_index et end_index seront égaux.

Champs
start_index

int32

Index de début de ce détail dans la polyligne.
end_index

int32

Index de fin de ce détail dans la polyligne.

RestrictionInfo

Encapsule des informations sur diverses restrictions le long de la polyligne.

Champs
restriction_presence

RoadFeatureState

Uniquement en sortie. Indique si une restriction existe pour une section donnée de la polyligne.
polyline_point_index

PolylinePointIndex

Emplacement des informations sur les restrictions le long de la polyligne.
Champ d'union restriction. Encapsule les types de restrictions pouvant s'appliquer à une section donnée de la polyligne. restriction ne peut être qu'un des éléments suivants :
restricted_height_mm

int64

Hauteur maximale, en millimètres. Ce champ est renseigné lorsque la hauteur limitée empêche le passage ou entraîne un faible dégagement pour le véhicule spécifié.
restricted_weight_kg

int64

Limite de poids, en kilogrammes. Ce champ est rempli lorsque la limite de poids empêche le passage ou est proche du poids du véhicule spécifié.
hazardous_goods

bool

Ce champ est défini sur "true" lorsque le transport de marchandises dangereuses est limité.
trucks_prohibited

bool

Ce champ est défini sur "true" lorsque les camions sont interdits.

RoadFeatureState

Encapsule les états des caractéristiques des routes le long d'une section de polyligne.

Enums
ROAD_FEATURE_STATE_UNSPECIFIED L'état de la caractéristique de route n'a pas été calculé (valeur par défaut).
EXISTS La route existe.
DOES_NOT_EXIST La fonctionnalité de route n'existe pas.

SkywayInfo

Encapsule les informations sur les skyways le long de la polyligne.

Champs
skyway_presence

RoadFeatureState

Indique si une voie aérienne existe pour une section donnée de la polyligne.
polyline_point_index

PolylinePointIndex

Emplacement des informations sur le skyway le long de la polyligne.

TunnelInfo

Encapsule les informations sur les tunnels le long de la polyligne.

Champs
tunnel_presence

RoadFeatureState

Indique si un tunnel existe pour une section donnée de la polyligne.
polyline_point_index

PolylinePointIndex

Emplacement des informations sur le tunnel le long de la polyligne.

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

Contient 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
route_labels[]

RouteLabel

Libellés pour Route utiles pour identifier des propriétés spécifiques de l'itinéraire à comparer à d'autres.
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 Waypoints 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 sur l'itinéraire 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 vous définissez optimize_waypoint_order sur "true", ce champ contient l'ordre optimisé des points de cheminement intermédiaires. Sinon, ce champ est vide. Par exemple, si vous saisissez "Origine : Los Angeles ; points de cheminement intermédiaires : Dallas, Bangor, Phoenix ; destination : New York", et que l'ordre optimisé des points de cheminement intermédiaires est "Phoenix, Dallas, Bangor", ce champ contient les valeurs [2, 0, 1]. L'index commence par 0 pour le premier point de chemin intermédiaire fourni dans l'entrée.
localized_values

RouteLocalizedValues

Représentations textuelles des propriétés de Route.
route_token

string

Jeton opaque pouvant être transmis au SDK Navigation pour reconstruire l'itinéraire pendant la navigation et, en cas de changement d'itinéraire, respecter l'intention initiale lors de la création de l'itinéraire. Traitez ce jeton comme un blob opaque. Ne comparez pas sa valeur entre les requêtes, car elle peut changer même si le service renvoie exactement le même itinéraire.

REMARQUE : Route.route_token n'est disponible que pour les requêtes dont ComputeRoutesRequest.routing_preference est défini sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL. Route.route_token n'est pas compatible avec les requêtes comportant des points de cheminement "Via".
polyline_details

PolylineDetails

Contient des informations sur les détails le long de la polyligne.

RouteLocalizedValues

Représentations textuelles de certaines propriétés.

Champs
distance

LocalizedText

Distance de trajet représentée sous forme de texte.
duration

LocalizedText

Durée, représentée sous forme de texte et localisée selon la région de la requête. Tient compte des conditions de circulation. Remarque : Si vous n'avez pas demandé d'informations sur le trafic, cette valeur est identique à celle de static_duration.
static_duration

LocalizedText

Durée sans tenir compte des conditions de trafic, représentée sous forme de texte.
transit_fare

LocalizedText

Tarif des transports en commun sous forme de texte.

RouteLabel

Libellés pour Route utiles pour identifier des propriétés spécifiques de l'itinéraire à comparer à d'autres.

Enums
ROUTE_LABEL_UNSPECIFIED Par défaut : non utilisé.
DEFAULT_ROUTE Meilleur itinéraire par défaut renvoyé pour le calcul de l'itinéraire.
DEFAULT_ROUTE_ALTERNATE Itinéraire bis par rapport à l'itinéraire "meilleur" par défaut. Les itinéraires de ce type sont renvoyés lorsque compute_alternative_routes est spécifié.
FUEL_EFFICIENT Itinéraire économe en carburant. Les itinéraires associés à cette valeur sont considérés comme optimisés pour les paramètres Eco, tels que la consommation de carburant.
SHORTER_DISTANCE Itinéraire avec la distance de trajet la plus courte. Cette fonctionnalité est expérimentale.

RouteLeg

Contient un segment entre des points de cheminement 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 de cette section, qui inclut la polyligne de chaque step.
start_location

Location

Emplacement de départ de cette étape. Cette position peut être différente de celle fournie dans origin. 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. Cette position peut être différente de celle fournie dans destination. 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

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

RouteLegLocalizedValues

Représentations textuelles des propriétés de RouteLeg.
steps_overview

StepsOverview

Informations générales sur les étapes de ce RouteLeg. Ce champ n'est renseigné que pour les itinéraires TRANSIT.

RouteLegLocalizedValues

Représentations textuelles de certaines propriétés.

Champs
distance

LocalizedText

Distance de trajet représentée sous forme de texte.
duration

LocalizedText

Durée, représentée sous forme de texte et localisée selon la région de la requête. Tient compte des conditions de circulation. Remarque : Si vous n'avez pas demandé d'informations sur le trafic, cette valeur est identique à celle de static_duration.
static_duration

LocalizedText

Durée sans tenir compte des conditions de trafic, représentée sous forme de texte.

StepsOverview

Fournit des informations générales sur une liste de RouteLegStep.

Champs
multi_modal_segments[]

MultiModalSegment

Informations résumées sur les différents segments multimodaux de RouteLeg.steps. Ce champ n'est pas renseigné si RouteLeg ne contient aucun segment multimodal dans les étapes.

MultiModalSegment

Fournit des informations résumées sur différents segments multimodaux de RouteLeg.steps. Un segment multimodal est défini comme un ou plusieurs RouteLegStep contigus ayant le même RouteTravelMode. Ce champ n'est pas renseigné si RouteLeg ne contient aucun segment multimodal dans les étapes.

Champs
navigation_instruction

NavigationInstruction

NavigationInstruction pour le segment multimodal.
travel_mode

RouteTravelMode

Mode de transport du segment multimodal.
step_start_index

int32

Index RouteLegStep correspondant au début d'un segment multimodal.
step_end_index

int32

Index RouteLegStep correspondant à la fin d'un segment multimodal.

RouteLegStep

Contient 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

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

RouteLegStepLocalizedValues

Représentations textuelles des propriétés de RouteLegStep.
transit_details

RouteLegStepTransitDetails

Informations concernant cette étape si le mode de déplacement est TRANSIT.
travel_mode

RouteTravelMode

Mode de déplacement utilisé pour cette étape.

RouteLegStepLocalizedValues

Représentations textuelles de certaines propriétés.

Champs
distance

LocalizedText

Distance de trajet représentée sous forme de texte.
static_duration

LocalizedText

Durée sans tenir compte des conditions de trafic, représentée sous forme de texte.

RouteLegStepTransitDetails

Informations supplémentaires pour RouteLegStep concernant les routes TRANSIT.

Champs
stop_details

TransitStopDetails

Informations sur les arrêts d'arrivée et de départ de l'étape.
localized_values

TransitDetailsLocalizedValues

Représentations textuelles des propriétés de RouteLegStepTransitDetails.
headsign

string

Spécifie le sens du trajet sur cette ligne tel qu'indiqué sur le véhicule ou à l'arrêt de départ. Il s'agit souvent du terminus.
headway

Duration

Indique la durée estimée entre deux départs depuis le même arrêt à l'heure actuelle. Par exemple, si la valeur de headway_seconds est de 600, vous attendrez environ 10 minutes si vous manquez votre bus.
transit_line

TransitLine

Informations sur la ligne de transports en commun utilisée à cette étape.
stop_count

int32

Nombre d'arrêts entre l'arrêt de départ et l'arrêt d'arrivée. Ce nombre inclut l'arrêt d'arrivée, mais pas celui de départ. Par exemple, si votre itinéraire consiste à partir de l'arrêt A pour arriver à l'arrêt D en passant par les arrêts B et C, stop_count renvoie 3.
trip_short_text

string

Texte qui apparaît dans les plannings et sur les panneaux lumineux pour identifier un trajet en transports en commun pour les passagers. Le texte doit identifier un trajet unique au cours d'une journée de service. Par exemple, "538" est le trip_short_text du train Amtrak qui quitte San Jose, en Californie, à 15h10 en semaine pour Sacramento, en Californie.

TransitDetailsLocalizedValues

Descriptions localisées des valeurs pour RouteTransitDetails.

Champs
arrival_time

LocalizedTime

Heure dans sa représentation textuelle formatée avec un fuseau horaire correspondant.
departure_time

LocalizedTime

Heure dans sa représentation textuelle formatée avec un fuseau horaire correspondant.

TransitStopDetails

Détails sur les arrêts de transport en commun pour RouteLegStep.

Champs
arrival_stop

TransitStop

Informations sur l'arrêt d'arrivée de l'étape.
arrival_time

Timestamp

Heure d'arrivée prévue pour l'étape.
departure_stop

TransitStop

Informations sur l'arrêt de départ de l'étape.
departure_time

Timestamp

Heure de départ estimée pour l'étape.

RouteLegStepTravelAdvisory

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

Champs
speed_reading_intervals[]

SpeedReadingInterval

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

RouteLegTravelAdvisory

Contient les informations supplémentaires dont l'utilisateur doit être informé pour une étape du trajet, comme les éventuelles restrictions de zone de circulation.

Champs
toll_info

TollInfo

Contient des 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 et que le TOLLS est inclus dans le ComputeRoutesRequest.extra_computations de la requête. 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 toll_info n'existe pas, il n'y a pas de péage sur RouteLeg.
speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture rapide indiquant la densité du trafic. Ce champ n'est renseigné que pour les requêtes dont la valeur ComputeRoutesRequest.routing_preference est TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, et dont TRAFFIC_ON_POLYLINE est inclus dans ComputeRoutesRequest.extra_computations. 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

Contient les informations d'itinéraire calculées pour une paire point de départ/destination dans l'API ComputeRouteMatrix. Ce proto peut être diffusé au client.

Champs
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 spécifique, 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.
localized_values

LocalizedValues

Représentations textuelles des propriétés de RouteMatrixElement.
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.

LocalizedValues

Représentations textuelles de certaines propriétés.

Champs
distance

LocalizedText

Distance de trajet représentée sous forme de texte.
duration

LocalizedText

Durée représentée sous forme de texte, en tenant compte des conditions de circulation. Remarque : Si aucune information sur le trafic n'a été demandée, cette valeur est identique à celle de static_duration.
static_duration

LocalizedText

Durée représentée sous forme de texte sans tenir compte des conditions de circulation.
transit_fare

LocalizedText

Tarif des transports en commun sous forme de texte.

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 RouteTravelMode 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 RouteTravelMode 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'à RouteTravelMode pour 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'à la WALK RouteTravelMode.
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 RouteTravelMode DRIVE et TWO_WHEELER.
avoid_tunnels

bool

Facultatif. Lorsque la valeur est définie sur "true", les tunnels sont évités dans la mesure du possible, en privilégiant les itinéraires qui n'en comportent pas. Ne s'applique qu'aux RouteTravelMode DRIVE et TWO_WHEELER. RoutingPreference doit être défini sur TRAFFIC_AWARE_OPTIMAL. Ce champ n'est pas compatible avec ComputeRouteMatrix.

RouteTravelAdvisory

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

Champs
toll_info

TollInfo

Contient des informations sur les péages sur l'itinéraire. Ce champ n'est renseigné que si des péages sont prévus sur l'itinéraire et que TOLLS est inclus dans le ComputeRoutesRequest.extra_computations de la requête. Si ce champ est défini, mais que le sous-champ estimatedPrice n'est pas renseigné, cela signifie que l'itinéraire comporte des péages, mais que le prix estimé est inconnu. Si toll_info n'est pas défini, aucun péage n'est attendu sur l'itinéraire.
speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture rapide indiquant la densité du trafic. Ce champ n'est renseigné que pour les requêtes dont la valeur ComputeRoutesRequest.routing_preference est TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, et dont TRAFFIC_ON_POLYLINE est inclus dans ComputeRoutesRequest.extra_computations. 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).
fuel_consumption_microliters

int64

Consommation de carburant prévue en microlitres. Ce champ n'est renseigné que lorsque FUEL_CONSUMPTION est inclus dans le ComputeRoutesRequest.extra_computations de la requête.
route_restrictions_partially_ignored

bool

L'itinéraire renvoyé peut comporter des restrictions qui ne conviennent pas au mode de déplacement ou aux modificateurs d'itinéraire demandés.
transit_fare

Money

Si elle est présente, cette propriété contient le tarif total ou le prix des billets pour cet itinéraire. Elle n'est renvoyée que pour les requêtes TRANSIT et uniquement pour les itinéraires pour lesquels des informations tarifaires sont disponibles pour toutes les étapes de transport en commun.

RouteTravelMode

Ensemble de valeurs utilisé pour spécifier le mode de transport. REMARQUE : Les itinéraires WALK, BICYCLE et TWO_WHEELER sont en version bêta et peuvent parfois ne pas inclure de trottoirs, de chemins piétons ou de pistes cyclables clairs. Vous devez afficher cet avertissement à l'utilisateur pour tous les itinéraires à pied, à vélo et à deux roues que vous affichez dans votre application.

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.
TRUCK Camion, qui peut être soumis à des restrictions réglementaires ou physiques. Vous devez renseigner les attributs du véhicule dans le message VehicleInfo.
TRANSIT Empruntez les transports en commun, si possible.

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_UNAWARE
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 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 en temps réel. 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 en temps réel, sans appliquer la plupart des optimisations de 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.
end_polyline_point_index

int32

Index de fin de cet intervalle dans la polyligne.
Champ d'union speed_type. Type de vitesse dans cet intervalle. speed_type ne peut être qu'un des éléments suivants :
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 Vitesse normale, sans embouteillages.
SLOW Ralentissement détecté, trafic moyen.
TRAFFIC_JAM Retards dus au trafic

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 règle générale, 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 Télépéage de Sydney. Pour en savoir plus, consultez https://www.myetoll.com.au.
AU_EWAY_TAG Télépéage de Sydney. Pour en savoir plus, consultez https://www.tollpay.com.au.
AU_LINKT Abonnement 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. Exemples : 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 HP.
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 Télépéage au 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 http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Mexique
MX_TAG_TELEVIA Société de télépéage mexicaine. L'un des nombreux centres d'opérations de Mexico. Pour en savoir plus, consultez https://www.televia.com.mx.
MX_TELEVIA Société de télépéage mexicaine. L'une des nombreuses entreprises opérant à 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_BREAKAWAY 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.

TrafficModel

Ce champ spécifie l'une des hypothèses suivantes à utiliser pour calculer le temps de trajet dans des conditions de trafic, comme indiqué dans les énumérations ci-dessous. Le champ duration de la réponse TrafficModel varie en fonction de l'énumération choisie. La valeur contient le temps de trajet prévu jusqu'à la destination en fonction des moyennes historiques. TrafficModel n'est disponible que pour les demandes pour lesquelles RoutingPreference est défini sur TRAFFIC_AWARE_OPTIMAL et RouteTravelMode sur DRIVE.

Enums
TRAFFIC_MODEL_UNSPECIFIED Non utilisé. Si elle est spécifiée, la valeur par défaut est BEST_GUESS.
BEST_GUESS Indique que le duration renvoyé doit correspondre à la meilleure estimation du temps de trajet compte tenu des conditions de circulation historiques et en temps réel. Plus departure_time est proche de l'heure actuelle, plus la circulation en temps réel devient importante.
PESSIMISTIC Indique que la durée renvoyée doit être supérieure à la durée réelle du trajet la plupart du temps. Toutefois, les jours où la circulation est particulièrement difficile, le temps de trajet peut être plus long.
OPTIMISTIC Indique que la durée renvoyée doit être inférieure à la durée réelle du trajet la plupart du temps. Toutefois, les jours où la circulation est particulièrement fluide, le temps de trajet peut être plus court.

TransitAgency

Agence de transports en commun qui exploite une ligne de transports en commun.

Champs
name

string

Nom de cette agence de transports en commun.
phone_number

string

Numéro de téléphone de l'agence de transports en commun, mis en forme en fonction des paramètres régionaux.
uri

string

URI de l'agence de transports en commun.

TransitLine

Contient des informations sur la ligne de transports en commun utilisée à cette étape.

Champs
agencies[]

TransitAgency

Agence ou agences de transports en commun qui exploitent cette ligne.
name

string

Nom complet de la ligne de transports en commun (par exemple, "8th Avenue Local").
uri

string

URI de cette ligne de transports en commun fourni par l'agence de transports en commun.
color

string

Couleur couramment utilisée pour désigner cette ligne. Représenté au format hexadécimal.
icon_uri

string

URI de l'icône associée à cette ligne.
name_short

string

Nom court de cette ligne de transports en commun. Il s'agit généralement d'un numéro de ligne tel que "M7" ou "355".
text_color

string

Couleur généralement utilisée pour le texte sur les panneaux de signalisation de cette ligne. Représenté au format hexadécimal.
vehicle

TransitVehicle

Type de véhicule utilisé sur cette ligne de transports en commun.

TransitPreferences

Préférences pour les itinéraires basés sur TRANSIT qui influencent l'itinéraire renvoyé.

Champs
allowed_travel_modes[]

TransitTravelMode

Ensemble de modes de déplacement à utiliser pour obtenir un itinéraire TRANSIT. Par défaut, tous les modes de transport acceptés sont inclus.
routing_preference

TransitRoutingPreference

Préférence de routage qui, lorsqu'elle est spécifiée, influence la route TRANSIT renvoyée.

TransitRoutingPreference

Spécifie les préférences de routage pour les itinéraires en transports en commun.

Enums
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED Aucune préférence spécifiée.
LESS_WALKING Indique que l'itinéraire calculé doit limiter le plus possible la marche.
FEWER_TRANSFERS Indique que l'itinéraire calculé doit utiliser un nombre limité de correspondances.

TransitTravelMode

Ensemble de valeurs utilisé pour spécifier le mode de transport.

Enums
TRANSIT_TRAVEL_MODE_UNSPECIFIED Aucun mode de transport en commun n'a été spécifié.
BUS Voyagez en bus.
SUBWAY Voyagez en métro.
TRAIN Voyagez en train.
LIGHT_RAIL Prenez le métro léger ou le tramway.
RAIL Voyagez en train. Cela équivaut à une combinaison de SUBWAY, TRAIN et LIGHT_RAIL.

TransitStop

Informations sur un arrêt de transports en commun.

Champs
name

string

Nom de l'arrêt de transports en commun.
location

Location

Emplacement de l'arrêt exprimé en coordonnées de latitude/longitude.

TransitVehicle

Informations sur un véhicule utilisé sur les itinéraires de transports en commun.

Champs
name

LocalizedText

Nom de ce véhicule, avec une majuscule.
type

TransitVehicleType

Type de véhicule utilisé.
icon_uri

string

URI d'une icône associée à ce type de véhicule.
local_icon_uri

string

URI de l'icône associée à ce type de véhicule, d'après la signalétique locale pour les transports en commun.

TransitVehicleType

Type de véhicules pour les itinéraires de transports en commun.

Enums
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Non utilisé.
BUS Bus.
CABLE_CAR Véhicule tracté par un câble, généralement en surface. Les téléphériques peuvent être de type GONDOLA_LIFT.
COMMUTER_TRAIN Train de banlieue.
FERRY Ferry.
FUNICULAR Véhicule tracté par un câble le long d'une pente prononcée. Un funiculaire se compose généralement de deux rames, chacune agissant comme contrepoids de l'autre.
GONDOLA_LIFT Téléphérique.
HEAVY_RAIL Métro.
HIGH_SPEED_TRAIN Train à grande vitesse.
INTERCITY_BUS Bus interurbain.
LONG_DISTANCE_TRAIN Train longue distance.
METRO_RAIL Métro léger.
MONORAIL Monorail.
OTHER Tous les autres véhicules.
RAIL Train.
SHARE_TAXI Type de bus pouvant faire monter et descendre des passagers n'importe où sur la ligne.
SUBWAY Métro léger souterrain.
TRAM Métro léger en surface.
TROLLEYBUS Trolleybus.

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'à la DRIVE RouteTravelMode.

Enums
VEHICLE_EMISSION_TYPE_UNSPECIFIED Aucun type d'émission n'a été spécifié. Valeur par défaut : GASOLINE
GASOLINE Véhicule à essence
ELECTRIC Véhicule électrique
HYBRID Véhicule hybride (essence et électricité, par exemple)
DIESEL Véhicule diesel

VehicleInfo

Contient des informations sur le véhicule, comme le type d'émissions.

Champs
emission_type

VehicleEmissionType

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

int64

Hauteur du véhicule, y compris celle des remorques éventuelles. Doit être défini pour que le camionnage ou le remorquage se déclenchent. Ce champ n'est pas compatible avec ComputeRouteMatrix lorsque RouteTravelMode est défini sur DRIVE.
total_length_mm

int64

Longueur du véhicule, y compris celle des remorques éventuellement attachées. Doit être défini pour que le camionnage ou le remorquage se déclenchent. Ce champ n'est pas compatible avec ComputeRouteMatrix lorsque RouteTravelMode est défini sur DRIVE.
total_width_mm

int64

Largeur du véhicule, y compris celle des remorques éventuellement attelées. Doit être défini pour que le camionnage ou le remorquage se déclenchent. Ce champ n'est pas compatible avec ComputeRouteMatrix lorsque RouteTravelMode est défini sur DRIVE.
total_weight_kg

int64

Poids du véhicule, y compris celui des remorques éventuelles. Dans ce contexte, le terme "poids" fait référence au poids réel, et non à la catégorie de poids. Doit être défini pour que le camionnage ou le remorquage se déclenchent. Ce champ n'est pas compatible avec ComputeRouteMatrix lorsque RouteTravelMode est défini sur DRIVE.
trailer_info[]

TrailerInfo

Contient une entrée pour chaque bande-annonce. Si des informations sur la bande-annonce sont fournies, RoutingPreference doit être défini sur TRAFFIC_AWARE_OPTIMAL. Ce champ n'est pas compatible avec ComputeRouteMatrix lorsque RouteTravelMode est défini sur DRIVE.
hazardous_goods_types[]

HazardousGoodsType

Liste des matières dangereuses transportées dans le véhicule, le cas échéant.

HazardousGoodsType

Différents types de matières dangereuses.

Enums
HAZARDOUS_GOODS_TYPE_UNSPECIFIED Aucun type de marchandise dangereuse n'a été spécifié.
EXPLOSIVES Produits explosifs
GASES Gaz.
FLAMMABLE Produits inflammables
COMBUSTIBLE Produits combustibles
ORGANIC Produits biologiques
POISON Produits toxiques
RADIOACTIVE Produits radioactifs
CORROSIVE Produits corrosifs.
ASPIRATION_HAZARD Produits dangereux par aspiration
ENVIRONMENTAL_HAZARD Produits dangereux pour l'environnement
OTHER Autres types de biens

TrailerInfo

Informations sur les remorques individuelles attelées au véhicule. Pour le transport routier, vous devez indiquer la longueur de toutes les remorques. Les autres attributs sont facultatifs. Le nombre total d'attributs doit inclure ceux des bandes-annonces. Par exemple, total_height_mm doit toujours être supérieur ou égal à trailer_info.height_mm.

Champs
height_mm

int64

Hauteur de la bande-annonce.
length_mm

int64

Durée de la bande-annonce.
width_mm

int64

Largeur de la bande-annonce.
weight_kg

int64

Poids de la remorque. Dans ce contexte, le terme "poids" fait référence au poids réel, et non à la catégorie de poids.

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 RouteTravelMode DRIVE et TWO_WHEELER.
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.
address

string

Adresse lisible ou Plus Code. Pour en savoir plus, consultez https://plus.codes.
navigation_point_token

string

Jeton qui identifie un NavigationPoint, obtenu à partir de la méthode SearchDestinations de l'API Geocoding.