Package google.maps.routing.v2 (Automotive)

Index

DynamicAttributeService

Service d'attributs dynamiques contenant l'API AnnotatePaths.

AnnotatePaths

rpc AnnotatePaths(AnnotatePathsRequest) returns (AnnotatePathsResponse)

Renvoie les chemins basés sur les segments d'entrée avec des annotations pour les attributs dynamiques le long des chemins.

Routes

L'API Routes

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Prend une liste de points de départ et de destinations, et renvoie un flux contenant des informations sur les itinéraires pour chaque combinaison de points de départ et de destination.

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

Par exemple, dans cette méthode:

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

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

  • En sélectionnant uniquement les champs dont vous avez besoin, vous permettez à notre serveur d'économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
  • Sélectionner uniquement les champs dont vous avez besoin dans votre job de production garantit des performances de latence stables. Nous ajouterons peut-être d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs du niveau supérieur, vous risquez de constater une dégradation des performances, car tout nouveau champ ajouté sera automatiquement inclus dans la réponse.
  • En ne sélectionnant que les champs dont vous avez besoin, vous pouvez réduire la taille de réponse et, par conséquent, le débit du réseau.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

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

Par exemple, dans cette méthode:

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

Google déconseille d'utiliser le masque de champ de réponse avec caractère générique (*) ou de spécifier le masque de champ au niveau supérieur (routes), pour les raisons suivantes:

  • En sélectionnant uniquement les champs dont vous avez besoin, vous permettez à notre serveur d'économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
  • Sélectionner uniquement les champs dont vous avez besoin dans votre job de production garantit des performances de latence stables. Nous ajouterons peut-être d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs du niveau supérieur, vous risquez de constater une dégradation des performances, car tout nouveau champ ajouté sera automatiquement inclus dans la réponse.
  • En ne sélectionnant que les champs dont vous avez besoin, vous pouvez réduire la taille de réponse et, par conséquent, le débit du réseau.

AnnotatePathsRequest

Requête envoyée à l'API AnnotatePaths. Les tracés sont annotés comme si un véhicule devait commencer à parcourir chaque tracé à l'heure actuelle.

Les annotations sur une section peuvent varier en fonction du chemin auquel elle appartient. Par exemple, le même segment A peut exister dans le chemin 1 et le chemin 2. Dans le chemin 1, le segment A est suivi du segment B, et dans le chemin 2, le segment A est suivi du segment C. Les attributs dynamiques renvoyés pour le chemin 1 et le chemin 2 peuvent différer en fonction des différences entre les segments suivants.

Champs
paths[]

Path

Obligatoire. Routes demandées à remplir avec des données d'attributs dynamiques. Tous les tracés doivent avoir la même section de départ, à savoir la section sur laquelle se trouve actuellement le véhicule. Le véhicule est supposé se trouver au début de la première section. Si les chemins d'accès ne commencent pas par le même segment, une erreur est renvoyée.

annotation_options

AnnotationOptions

Obligatoire. Attributs de données dynamiques demandés à ajouter aux chemins d'entrée. Si ce champ est vide, la requête ne sera pas annotée.

AnnotatePathsResponse

AnnotatePathsResponse contient les chemins d'entrée avec des données supplémentaires ajoutées pour toutes les annotations demandées.

Champs
annotated_paths[]

AnnotatedPath

Chemins d'accès à partir de l'entrée annotée avec les attributs demandés.

AnnotatedPath

Copie d'un chemin d'entrée renvoyé avec des attributs prédits.

Champs
annotated_segments[]

AnnotatedSegment

Liste numérotée de segments qui constituent le chemin principal, annotée avec les attributs demandés.

AnnotatedSegment

Il s'agit d'un segment qui constitue un chemin, annoté avec des attributs de données dynamiques.

Champs
segment

Segment

Informations sur le segment permettant de le distinguer des autres

segment_span_attributes[]

SegmentSpanAttribute

Attributs attribués au segment. Ces attributs peuvent varier en fonction du chemin emprunté par un segment. Un segment peut couvrir l'intégralité du segment. Les segments des attributs seront dans l'ordre suivant, de l'emplacement du véhicule jusqu'à la fin du trajet.

AnnotationOptions

Annotations demandées pour les chemins d'entrée.

Champs
include_level_of_service

bool

Facultatif. Lorsque ce paramètre est défini sur "true", les segments de la réponse sont annotés avec les valeurs de trafic prévues. Le terme "niveau de service" est généralement utilisé pour décrire la catégorisation du flux de trafic, mais les niveaux de service définis dans cette API n'appartiennent qu'à cette API.

ComputeRouteMatrixRequest

Message de requête ComputeRouteMatrix

Champs
origins[]

RouteMatrixOrigin

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

  • La somme du nombre de points de départ et du nombre de destinations spécifiées dans place_id ou address ne doit pas être supérieure à 50.
  • Le produit du nombre de points de départ × le nombre de destinations ne doit pas être supérieur à 625.
  • Le produit du nombre de points de départ × le nombre de destinations ne doit pas être supérieur à 100 si routage_preference est défini sur TRAFFIC_AWARE_OPTIMAL.
  • Le produit du nombre de points de départ x le nombre de destinations ne doit pas être supérieur à 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 la route. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer la route. Si la préférence de routage génère une erreur ou une latence plus longue, une erreur est renvoyée. 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 correspond par défaut à l'heure à laquelle vous avez effectué la requête. REMARQUE: Vous ne pouvez spécifier une 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 la section Identifiant de paramètres régionaux Unicode. Consultez la page Langues acceptées pour obtenir la liste des langues disponibles. Si vous ne renseignez pas cette valeur, la langue d'affichage est déduite de l'emplacement de la première source.

region_code

string

Facultatif. Code régional, spécifié sous forme de valeur ccTLD ("domaine de premier niveau") à deux caractères. Pour en savoir plus, consultez Domaines de premier niveau de premier niveau de code pays.

units

Units

Facultatif. Spécifie les unités de mesure des champs d'affichage.

extra_computations[]

ExtraComputation

Facultatif. Liste des calculs supplémentaires pouvant être utilisés pour finaliser la requête. 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 pour calculer le temps de trajet. Ce paramètre affecte la valeur renvoyée dans le champ de durée de l'élément RouteMatrixElement, qui contient le temps de trajet prévu en fonction des moyennes historiques. De RoutingPreference à TRAFFIC_AWARE_OPTIMAL et de RouteTravelMode à 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 la route renvoyée pour les routes 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 requête.

Enums
EXTRA_COMPUTATION_UNSPECIFIED Non utilisé. Les requêtes contenant cette valeur échoueront.
TOLLS Informations sur les péages pour 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 sur l'itinéraire (à l'exclusion des terminaux) permettant de s'arrêter à ou de passer. Jusqu'à 25 points de cheminement intermédiaires sont acceptés.

travel_mode

RouteTravelMode

Facultatif. Spécifie le mode de transport.

routing_preference

RoutingPreference

Facultatif. Indique comment calculer la route. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer la route. Si la préférence de routage génère une erreur ou une latence plus longue, une erreur est renvoyée. Vous ne pouvez spécifier cette option que lorsque travel_mode est défini sur DRIVE ou TWO_WHEELER. Sinon, la requête échoue.

polyline_quality

PolylineQuality

Facultatif. Spécifie votre préférence pour la qualité de la polyligne.

polyline_encoding

PolylineEncoding

Facultatif. Spécifie l'encodage préféré pour la polyligne.

departure_time

Timestamp

Facultatif. Heure de départ. Si vous ne définissez pas cette valeur, elle correspond par défaut à l'heure à laquelle vous avez effectué la requête. REMARQUE: Vous ne pouvez spécifier une departure_time dans le passé que lorsque RouteTravelMode est défini sur TRANSIT. Les trajets en transports en commun sont disponibles pour les 7 jours qui précèdent ou les 100 jours à venir.

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. Les trajets en transports en commun sont disponibles pour les 7 jours qui précèdent ou les 100 jours à venir.

compute_alternative_routes

bool

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

route_modifiers

RouteModifiers

Facultatif. Ensemble de conditions à remplir qui affectent la façon dont les itinéraires sont calculés.

language_code

string

Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la section Identifiant de paramètres régionaux Unicode. Consultez la page Langues acceptées pour obtenir la liste des langues disponibles. Si vous ne fournissez pas cette valeur, la langue d'affichage est déduite de l'emplacement de la requête d'itinéraire.

region_code

string

Facultatif. Code régional, spécifié sous forme de valeur ccTLD ("domaine de premier niveau") à deux caractères. Pour en savoir plus, consultez Domaines de premier niveau de premier niveau de code pays.

units

Units

Facultatif. Spécifie les unités de mesure des champs d'affichage. Ces champs incluent le champ instruction dans NavigationInstruction. Les unités de mesure utilisées pour l'itinéraire, la section, la distance de pas et la durée ne sont pas affectées par cette valeur. Si vous n'indiquez pas cette valeur, les unités d'affichage sont déduites de l'emplacement de la première origine.

optimize_waypoint_order

bool

Facultatif. Si cette règle est définie sur "true", le service tente de réduire 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 ComputeRoutesResponseroutes.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 routes de référence à calculer dans le cadre de la requête, en plus de la route 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 permettant de générer un itinéraire optimal économe en carburant.

extra_computations[]

ExtraComputation

Facultatif. Liste des calculs supplémentaires pouvant être utilisés pour finaliser la requête. 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.

route_token
(deprecated)

string

Facultatif. Obsolète: utilisez plutôt route_token_options.route_token.

route_token_options

RouteTokenOptions

Facultatif. Les jetons de route permettent à une requête de dépendre d'une route précédemment sélectionnée.

traffic_model

TrafficModel

Facultatif. Spécifie les hypothèses à utiliser pour calculer le temps de trajet. Ce paramètre affecte la valeur renvoyée dans le champ de durée de Route et RouteLeg, qui contient le temps de trajet prévu en fonction des moyennes historiques. TrafficModel n'est disponible que pour les requêtes qui ont défini RoutingPreference 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 la route renvoyée pour les routes TRANSIT. REMARQUE: Vous ne pouvez spécifier un transit_preferences que lorsque RouteTravelMode est défini sur TRANSIT.

navigation_session_id

string

Facultatif. ID de session de navigation généré par le client et utilisé pour associer cette requête d'itinéraire aux journaux de navigation du client pour l'analyse de la navigation. Il doit s'agir d'un UUID conforme à la norme RFC 4122 et généré de manière aléatoire, et spécifique à une session de navigation spécifique.

ExtraComputation

Calculs supplémentaires à effectuer pour traiter la requête.

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 de l'itinéraire.
TRAFFIC_ON_POLYLINE Polylignes tenant compte du trafic pour les itinéraires
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions présenté sous la forme d'une chaîne de texte HTML mise en forme. Ce contenu est destiné à être lu tel quel. Il n'est destiné qu'à être affiché. Ne l'analysez pas par programmation.
PREDICTED_SPEED_ON_POLYLINE_20KPH_BUCKETS Buckets de vitesse prévue de 20 km/h. Résultats suivants : predicted_speed_intervals : [0, 10) km/h, [10, 30) km/h, ... [110, 130) km/h, [130, inf) km/h.
PREDICTED_SPEED_ON_POLYLINE_10KPH_BUCKETS Vitesse prévue pour les buckets 10 km/h. Résultats aux predicted_speed_intervals suivants: [0, 10) km/h, [10, 20) km/h, ... [120, 130) km/h, [130, inf) km/h.

ReferenceRoute

Route de référence compatible sur ComputeRoutesRequest.

Enums
REFERENCE_ROUTE_UNSPECIFIED Non utilisé. Les requêtes contenant cette valeur échouent.
FUEL_EFFICIENT Itinéraire économe en carburant. Les itinéraires associés à cette valeur sont déterminés comme optimisés pour des paramètres tels que la consommation de carburant.

ComputeRoutesResponse

ComputeRoute le message de réponse.

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 faites pas. Lorsque ce tableau contient plusieurs entrées, la première est l'itinéraire le plus recommandé. Si le tableau est vide, cela signifie qu'aucune route n'a été trouvée.

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

Contient les informations de réponse de geocoding pour les points de cheminement spécifiés en tant qu'adresses.

FallbackInfo

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

Champs
routing_mode

FallbackRoutingMode

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

reason

FallbackReason

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

FallbackReason

Pourquoi utiliser une réponse de remplacement ?

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

FallbackRoutingMode

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

Enums
FALLBACK_ROUTING_MODE_UNSPECIFIED Non utilisé.
FALLBACK_TRAFFIC_UNAWARE Indique que la RoutingPreference TRAFFIC_UNAWARE a été utilisée pour calculer la réponse.
FALLBACK_TRAFFIC_AWARE Indique que la RoutingPreference TRAFFIC_AWARE a été utilisée pour calculer la réponse.

GeocodedWaypoint

Détails sur les emplacements utilisés comme points de cheminement. Renseigné uniquement pour les points de cheminement d'adresse. Comprend des détails sur les résultats de geocoding afin de déterminer à quel endroit l'adresse a été géocodée.

Champs
geocoder_status

Status

Indique le code d'état résultant de l'opération de geocoding.

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 Renseigné uniquement si le point de cheminement correspondant est un point de cheminement intermédiaire.

GeocodingResults

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

Champs
origin

GeocodedWaypoint

Point de cheminement géocodé à l'origine.

destination

GeocodedWaypoint

Point de cheminement géocodé de la destination.

intermediates[]

GeocodedWaypoint

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

LevelOfService

des valeurs de bucket de trafic prévues, à utiliser pour la fonctionnalité ADAS, qui correspondent aux niveaux généraux de trafic. Les valeurs renvoyées par cette API sont indépendantes et ne doivent pas correspondre à d'autres API.

Enums
LEVEL_OF_SERVICE_UNSPECIFIED Valeur par défaut. Cette valeur signifie qu'aucune valeur de trafic prévue n'est disponible.
LEVEL_OF_SERVICE_STOPPED Le trafic est arrêté.
LEVEL_OF_SERVICE_STOP_AND_GO Les embouteillages se font de façon spontanée.
LEVEL_OF_SERVICE_SLOW Un ralentissement est prévu, mais aucun embouteillage n'est prévu.
LEVEL_OF_SERVICE_NORMAL Vitesse normale, aucun ralentissement prévu.

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 en-tête facultatif).

Champs
lat_lng

LatLng

Coordonnées géographiques du point de cheminement

heading

Int32Value

Direction associée au sens du flux de circulation. Cette valeur permet d'indiquer le côté de la route à partir duquel les usagers peuvent monter et descendre. Les valeurs de titre peuvent être comprises entre 0 et 360, où 0 correspond à un cap vers le nord, 90 à un cap vers l'est, et ainsi de suite. Vous ne pouvez utiliser ce champ que pour DRIVE et TWO_WHEELER RouteTravelMode.

Manœuvre

Ensemble de valeurs qui spécifient l'action de navigation à effectuer pour l'étape actuelle (par exemple, tourner à gauche, fusionner ou droite).

Enums
MANEUVER_UNSPECIFIED Non utilisé.
TURN_SLIGHT_LEFT Tournez légèrement vers la gauche.
TURN_SHARP_LEFT Tournez brusquement vers la gauche.
UTURN_LEFT Faites demi-tour sur la gauche.
TURN_LEFT Tournez à gauche.
TURN_SLIGHT_RIGHT Tournez légèrement sur la droite.
TURN_SHARP_RIGHT Tournez brusquement vers la droite.
UTURN_RIGHT Faites demi-tour sur la droite.
TURN_RIGHT Tournez à droite.
STRAIGHT Allez tout droit.
RAMP_LEFT Prendre la rampe à gauche.
RAMP_RIGHT Prenez la rampe à droite.
MERGE Fusionner dans le trafic.
FORK_LEFT Prenez la bifurcation à gauche.
FORK_RIGHT Prenez la droite.
FERRY Prendre le ferry.
FERRY_TRAIN Prenez le train qui mène au ferry.
ROUNDABOUT_LEFT Au rond-point, tournez à gauche.
ROUNDABOUT_RIGHT Au rond-point, tournez à droite.
DEPART Manœuvre initiale.
NAME_CHANGE Utilisé pour indiquer un changement de nom de rue.

Encapsule les instructions de navigation pour un RouteLegStep.

Champs
maneuver

Maneuver

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

instructions

string

Instructions pour effectuer cette étape.

Chemin d'accès

Chemin d'accès sur lequel les attributs dynamiques sont demandés.

Un tracé doit comporter des segments reliés et praticables. Les segments d'un chemin sont supposés suivre un itinéraire logique. Si aucun itinéraire n'est trouvé sur les segments d'entrée, une erreur est renvoyée. Par exemple, si les segments d'un chemin n'ont pas d'extrémité de connexion ou si un chemin est vide, cela génère une erreur.

La longueur actuelle d'un trajet est limitée à 15 km. Le trajet est mesuré à partir du début de la première section, à savoir la position supposée du véhicule. Une erreur s'affiche si une section commence à plus de 15 km du début de la première section. La dernière section peut commencer avant 15 km et se terminer après 15 km. Aucune réponse partielle ne sera renvoyée.

Un chemin peut contenir les mêmes segments qu'un autre chemin, mais il est possible que les annotations de segment contiennent des réponses différentes en fonction des différences dans d'autres parties du chemin.

Champs
segments[]

Segment

Obligatoire. Liste ordonnée de segments qui forme le chemin.

Polyline

Encapsule une polyligne encodée.

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

string

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

geo_json_linestring

Struct

Spécifie une polyligne au format LineString GeoJSON.

PolylineDetails

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

Champs
altitude_info[]

AltitudeInfo

Détails d'altitude le long de la polyligne.

incident_info[]

IncidentInfo

Détails de l'incident le long de la polyligne.

segment_info[]

SegmentInfo

Segmentez les détails le long de la polyligne.

ferry_info[]

FerryInfo

Informations sur le ferry le long de la polyligne. Ce champ n'est renseigné que si une requête spécifie le modificateur de route avoid_ferries et que la route résultante ne parvient pas à les éviter. Sinon, ce champ n'est pas utilisé.

highway_info[]

HighwayInfo

Détails de l'autoroute le long de la polyligne. Ce champ n'est renseigné que si une requête spécifie le modificateur de route avoid_highways et que la route résultante ne parvient pas à les éviter. Sinon, ce champ n'est pas utilisé.

toll_info[]

TollInfo

Détails du péage le long de la polyligne. Ce champ n'est renseigné que si une requête spécifie le modificateur de route avoid_tolls et que la route résultante ne parvient pas à les éviter. Sinon, ce champ n'est pas utilisé.

tunnel_info[]

TunnelInfo

Détails du tunnel le long de la polyligne. Ce champ n'est renseigné que si une requête spécifie le modificateur de route avoid_tunnels et que la route résultante ne parvient pas à les éviter. Sinon, ce champ n'est pas utilisé.

vignette_info[]

VignetteInfo

Détails du vignetage le long de la polyligne. Ce champ n'est renseigné que si une requête spécifie le modificateur de route avoid_vignettes et que la route résultante ne parvient pas à les éviter. Sinon, ce champ n'est pas utilisé.

hov_info[]

HovInfo

Détails Hov le long de la polyligne. Ce champ n'est renseigné que si une requête spécifie le modificateur de route allow_hov et que la route résultante les contient. Sinon, ce champ n'est pas utilisé.

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 de route vehicle_info et que la route obtenue contient une restriction applicable. Sinon, ce champ n'est pas utilisé.

predicted_speeds[]

PredictedSpeedInfo

Segments de vitesse prévus le long de la polyligne.

AltitudeInfo

Encapsule les informations sur l'altitude le long de la polyligne.

Champs
polyline_point_index

PolylinePointIndex

Emplacement de la mesure de l'altitude le long de la polyligne.

altitude_meters

double

Altitude en mètres par rapport à l'ellipsoïde WGS-84.

FerryInfo

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

Champs
ferry_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

Emplacement des informations relatives au ferry le long de la polyligne.

HighwayInfo

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

Champs
highway_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

Emplacement des informations relatives à l'autoroute le long de la polyligne.

HovInfo

Encapsule les informations sur les sections/voies VMO le long de la polyligne.

Champs
hov_presence

RoadFeatureState

Uniquement en sortie. Indique s'il existe une route ou une voie VMO pour une portion donnée de la polyligne.

polyline_point_index

PolylinePointIndex

Emplacement des informations VMO le long de la polyligne.

IncidentInfo

Encapsule les informations sur un incident le long de la polyligne.

Champs
incident_type

IncidentType

Type d'incident

estimated_delay

Duration

Délai estimé par rapport à la durée de balayage normale. Uniquement renvoyé pour INCIDENT_JAM.

polyline_point_index

PolylinePointIndex

Emplacement de l'incident le long de la polyligne.

IncidentType

Types d'incidents

Enums
INCIDENT_TYPE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
INCIDENT_ROAD_CLOSED Route fermée.
INCIDENT_CRASH Un accident.
INCIDENT_CONSTRUCTION Travaux.
INCIDENT_JAM Embouteillage.

PolylinePointIndex

Encapsule les index de début et de fin pour les détails d'une 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.

PredictedSpeedInfo

Encapsule les informations sur les vitesses prédites le long de la polyligne.

Champs
predicted_speed_interval

PredictedSpeedInterval

Plage de vitesses prédites sur cette partie de la polyligne.

polyline_point_index

PolylinePointIndex

Emplacement de l'intervalle de vitesse prévu le long de la polyligne.

PredictedSpeedInterval

Intervalle de vitesse prévue flexible, représentant les vitesses en [lower_bound_kph_inclusive, upper_bound_kph_exclusive). Les intervalles renvoyés dépendent des extra_computations spécifiés dans la requête.

Champs
lower_bound_kph_inclusive

int32

Limite inférieure incluse.

upper_bound_kph_exclusive

int32

Limite supérieure exclusive. Représente l'infini lorsqu'il n'est pas renseigné.

RestrictionInfo

Encapsule les informations sur les différentes restrictions le long de la polyligne.

Champs
restriction_presence

RoadFeatureState

Uniquement en sortie. Indique si une restriction existe pour un étirement donné de la polyligne.

polyline_point_index

PolylinePointIndex

Emplacement des informations liées aux restrictions le long de la polyligne.

Champ d'union restriction. Encapsule les types de restrictions qui peuvent s'appliquer à un étirement donné de la polyligne. restriction ne peut être qu'un des éléments suivants :
restricted_height_mm

int64

Limite de hauteur, en millimètres. Ce champ est renseigné lorsque la hauteur limitée empêche le passage ou entraîne une faible marge pour le véhicule spécifié.

RoadFeatureState

Encapsule les états des éléments géographiques de la route (autoroutes, ferries, etc.) le long d'une portion de polyligne.

Enums
ROAD_FEATURE_STATE_UNSPECIFIED L'état de l'élément routier n'a pas été calculé (valeur par défaut).
EXISTS L'élément de route existe.
DOES_NOT_EXIST L'élément géographique de route n'existe pas.

SegmentInfo

Encapsule les informations concernant les segments situés le long de la polyligne.

Champs
place_id

string

ID de lieu pour cette section de route.

polyline_point_index

PolylinePointIndex

Emplacement du segment le long de la polyligne.

TollInfo

Encapsule les informations sur les péages le long de la polyligne.

Champs
toll_presence

RoadFeatureState

Uniquement en sortie. Indique s'il existe un péage pour un tronçon donné de la polyligne.

polyline_point_index

PolylinePointIndex

Emplacement des informations relatives aux péages le long de la polyligne.

TunnelInfo

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

Champs
tunnel_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

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

VignetteInfo

Encapsule les informations concernant les vignettes le long de la polyligne.

Champs
vignette_presence

RoadFeatureState

Uniquement en sortie. Indique si un vignetage existe pour un étirement donné de la polyligne.

polyline_point_index

PolylinePointIndex

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

PolylineEncoding

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

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

PolylineQuality

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

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

Route

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

Champs
route_labels[]

RouteLabel

Libellés pour Route utiles pour identifier les propriétés spécifiques de l'itinéraire afin de les comparer aux autres.

legs[]

RouteLeg

Ensemble de sections (segments de chemin entre des points de cheminement) qui constituent l'itinéraire. Chaque section correspond au trajet entre deux Waypoints non-via. Par exemple, un itinéraire sans point de cheminement intermédiaire ne comporte qu'une section. Un itinéraire qui inclut un point de cheminement intermédiaire non-via comporte deux sections. Un itinéraire qui inclut un point de cheminement intermédiaire via comporte une section. L'ordre des étapes correspond à l'ordre des points de cheminement de origin à intermediates, puis à destination.

distance_meters

int32

Distance parcourue en mètres.

duration

Duration

Temps nécessaire pour parcourir l'itinéraire. Si vous définissez routing_preference sur TRAFFIC_UNAWARE, cette valeur est identique à static_duration. Si vous définissez routing_preference sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, cette valeur est calculée en tenant compte des conditions de circulation.

static_duration

Duration

Durée du trajet sur l'itinéraire sans tenir compte des conditions de circulation.

polyline

Polyline

Polyligne globale de l'itinéraire. Cette polyligne 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 l'entrée Origine: Los Angeles ; Points de cheminement intermédiaires: Dallas, Bangor, Phoenix ; Destination: New York ; et que l'ordre de point de cheminement intermédiaire optimisé est Phoenix, Dallas, Bangor, ce champ contient les valeurs [2, 0, 1]. L'index commence par 0 pour le premier point de cheminement intermédiaire fourni dans l'entrée.

localized_values

RouteLocalizedValues

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

route_token

string

Jeton d'itinéraire encodé en base64 et adapté au Web, qui peut être transmis au SDK Navigation, qui permet à ce dernier de reconstruire l'itinéraire pendant la navigation et, en cas de réitinéraire, d'honorer l'intention initiale lorsque vous avez créé l'itinéraire en appelant ComputeRoutes. Les clients doivent traiter ce jeton comme un blob opaque. Ne comparez pas sa valeur entre les requêtes. Ce jeton peut changer même si exactement le même itinéraire a été renvoyé. REMARQUE: Route.route_token n'est disponible que pour les requêtes qui ont défini ComputeRoutesRequest.routing_preference sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL. Route.route_token n'est pas compatible avec les requêtes contenant des points de cheminement via.

route_token_update_fidelity

RouteTokenUpdateFidelity

Pour ComputeRouteRequests contenant un route_token, ce champ identifie la relation entre cette route et le jeton d'entrée.

polyline_details

PolylineDetails

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

RouteLocalizedValues

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

Champs
distance

LocalizedText

Distance de trajet représentée au format texte.

duration

LocalizedText

Durée tenant compte des conditions de circulation, représentée sous forme de texte. Remarque: Si vous n'avez pas demandé d'informations sur le trafic, cette valeur sera identique à static_duration.

static_duration

LocalizedText

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

transit_fare

LocalizedText

Tarif de transports en commun représenté au format texte.

RouteTokenUpdateFidelity

Pour les requêtes utilisant route_token_behavior GET_ROUTE_UPDATES, identifie les routes construites à partir du jeton route_token associé. (Sans rapport avec l'élément route_token de ce message.)

Enums
ROUTE_TOKEN_UPDATE_FIDELITY_UNSPECIFIED Cette route n'a pas été générée à partir d'un jeton de route.
APPROXIMATE Cet itinéraire est reconstitué à partir d'un jeton d'itinéraire et est équivalent sur le plan logique, mais sa géométrie n'est pas identique.
IDENTICAL Cet itinéraire est géométriquement identique à un jeton de route.

RouteLabel

Libellés pour Route utiles pour identifier les propriétés spécifiques de l'itinéraire afin de les comparer aux autres.

Enums
ROUTE_LABEL_UNSPECIFIED Par défaut : non utilisé.
DEFAULT_ROUTE La "meilleure" route par défaut renvoyée pour le calcul du routage.
DEFAULT_ROUTE_ALTERNATE Une alternative à la "meilleure" route par défaut. Des 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 déterminés comme étant optimisés pour des paramètres éco tels que la consommation de carburant.

RouteLeg

Contient un segment entre des points de cheminement autres que via.

Champs
distance_meters

int32

Distance de trajet de la section de l'itinéraire, exprimée en mètres.

duration

Duration

Temps nécessaire pour parcourir l'étape. Si route_preference est défini sur TRAFFIC_UNAWARE, cette valeur est identique à static_duration. Si route_preference est TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, cette valeur est calculée en tenant compte des conditions de circulation.

static_duration

Duration

Durée du trajet du trajet, calculée sans tenir compte des conditions de circulation.

polyline

Polyline

Polyligne globale de cette section, qui inclut les polylignes de chaque step.

start_location

Location

Lieu de départ de cette section. Cet emplacement peut être différent du origin fourni. Par exemple, lorsque le origin fourni ne se trouve pas à proximité d'une route, il s'agit d'un point sur la route.

end_location

Location

Lieu d'arrivée de cette section. Cet emplacement peut être différent du destination fourni. Par exemple, lorsque le destination fourni ne se trouve pas à proximité d'une route, il s'agit d'un point sur la route.

steps[]

RouteLegStep

Tableau des étapes indiquant les segments de cette section. Chaque étape représente une instruction de navigation.

travel_advisory

RouteLegTravelAdvisory

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

localized_values

RouteLegLocalizedValues

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

steps_overview

StepsOverview

Présentation des informations sur les étapes dans ce RouteLeg. Ce champ n'est renseigné que pour les itinéraires de type TRANSIT.

RouteLegLocalizedValues

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

Champs
distance

LocalizedText

Distance de trajet représentée au format texte.

duration

LocalizedText

Durée en tenant compte des conditions de circulation représentées au format texte. Remarque: Si vous n'avez pas demandé d'informations sur le trafic, cette valeur sera identique à "static_duration".

static_duration

LocalizedText

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

StepsOverview

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

Champs
multi_modal_segments[]

MultiModalSegment

Résumé des informations concernant 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 les différents segments multimodaux de RouteLeg.steps. Un segment multimodal est défini comme un ou plusieurs éléments 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

L'index RouteLegStep correspondant au début d'un segment multimodal.

step_end_index

int32

L'index RouteLegStep correspondant à la fin d'un segment multimodal.

RouteLegStep

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

Champs
distance_meters

int32

Distance de trajet de cette étape, en mètres. Dans certains cas, il est possible que ce champ ne contienne pas de valeur.

static_duration

Duration

Durée du trajet pour cette étape, sans tenir compte des conditions de circulation. Dans certains cas, il est possible que ce champ ne contienne pas de valeur.

polyline

Polyline

Polyligne associée à cette étape.

start_location

Location

Lieu de départ de cette étape.

end_location

Location

Fin de cette étape.

navigation_instruction

NavigationInstruction

Instructions de navigation.

travel_advisory

RouteLegStepTravelAdvisory

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

localized_values

RouteLegStepLocalizedValues

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

transit_details

RouteLegStepTransitDetails

Informations sur cette étape si le mode de transport est TRANSIT.

travel_mode

RouteTravelMode

Mode de transport utilisé pour cette étape.

RouteLegStepLocalizedValues

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

Champs
distance

LocalizedText

Distance de trajet représentée au format texte.

static_duration

LocalizedText

Durée sans tenir compte des conditions de circulation, 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 pour l'étape.

localized_values

TransitDetailsLocalizedValues

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

headsign

string

Indique le sens du trajet sur cette ligne, tel qu'indiqué sur le véhicule ou à l'arrêt de départ. La direction est souvent la station terminus.

headway

Duration

Spécifie l'heure prévue en tant que durée entre les départs depuis le même arrêt à l'heure actuelle. Par exemple, avec une valeur de 600 secondes d'intervalle entre les passages, vous vous attendez à une attente de 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 exclut celui de départ. Par exemple, si votre itinéraire part de l'arrêt A, passe par les arrêts B et C, et arrive à l'arrêt D, stop_count renvoie 3.

trip_short_text

string

Texte qui apparaît sur les horaires et les panneaux d'affichage pour permettre aux usagers d'identifier un trajet en transports en commun. Le texte doit identifier de manière unique un trajet au cours d'une journée de service. Par exemple, "538" est le trip_short_text du train Amtrak qui part de San Jose en Californie à 15 h 10 en semaine pour Sacramento, en Californie.

TransitDetailsLocalizedValues

Descriptions localisées des valeurs pour RouteTransitDetails.

Champs
arrival_time

LocalizedTime

Heure dans sa représentation textuelle mise en forme avec le fuseau horaire correspondant.

departure_time

LocalizedTime

Heure dans sa représentation textuelle mise en forme avec le fuseau horaire correspondant.

TransitStopDetails

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

Champs
arrival_stop

TransitStop

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

arrival_time

Timestamp

Heure d'arrivée estimée de 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 de 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 de l'itinéraire.

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é lors d'une étape de l'étape, comme les éventuelles restrictions de zone de trafic.

Champs
toll_info

TollInfo

Contient des informations sur les péages pour le RouteLeg spécifique. Ce champ n'est renseigné que si des péages sont prévus sur le RouteLeg. Si ce champ est défini, mais que le sous-champ "estimated_price" n'est pas renseigné, il est normal que la route contienne des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'existe pas, le RouteLeg n'entraîne pas de péage.

speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture de la vitesse indiquant la densité du trafic Applicable dans le cas des préférences de routage TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent la totalité de la polyligne de l'élément RouteLeg sans chevauchement. Le point de début d'un intervalle spécifié est identique au point de fin de l'intervalle précédent.

Exemple :

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

RouteMatrixDestination

Une seule destination pour ComputeRouteMatrixRequest

Champs
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é en streaming vers le 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épendant du statut.

distance_meters

int32

Distance parcourue en mètres.

duration

Duration

Temps nécessaire pour parcourir l'itinéraire. Si vous définissez routing_preference sur TRAFFIC_UNAWARE, cette valeur est identique à static_duration. Si vous définissez routing_preference sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, cette valeur est calculée en tenant compte des conditions de circulation.

static_duration

Duration

Durée du trajet sur l'itinéraire sans tenir compte des conditions de circulation.

travel_advisory

RouteTravelAdvisory

Informations supplémentaires sur l'itinéraire. Par exemple: restrictions et informations sur les péages

fallback_info

FallbackInfo

Dans certains cas, lorsque le serveur n'est pas en mesure de calculer la route avec les préférences données pour cette paire point de départ/destination spécifique, il peut choisir d'utiliser un autre mode de calcul. Lorsque le mode de remplacement est utilisé, ce champ contient des informations détaillées sur la réponse de remplacement. Sinon, ce champ n'est pas défini.

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 au format texte.

duration

LocalizedText

Durée représentée sous forme de texte en tenant compte des conditions de circulation. Remarque: Si les informations sur le trafic n'ont pas été demandées, cette valeur est identique à "static_duration".

static_duration

LocalizedText

Durée représentée au format texte sans tenir compte des conditions de circulation.

transit_fare

LocalizedText

Tarif de transports en commun représenté au format texte.

RouteMatrixElementCondition

La condition de la route renvoyée.

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

RouteMatrixOrigin

Une seule origine pour ComputeRouteMatrixRequest

Champs
waypoint

Waypoint

Obligatoire. Point de cheminement de départ

route_modifiers

RouteModifiers

Facultatif. Modificateurs pour chaque itinéraire qui l'utilise comme point de départ

RouteModifiers

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

Champs
avoid_tolls

bool

Lorsque cette option est définie sur "True", évite les routes à péage dans la mesure du possible, en privilégiant les itinéraires qui ne contiennent pas de routes à péage. S'applique uniquement aux RouteTravelMode DRIVE et TWO_WHEELER.

avoid_highways

bool

Lorsque la valeur est définie sur "true", permet d'éviter les autoroutes dans la mesure du possible, en privilégiant les routes qui ne contiennent pas d'autoroute. S'applique uniquement aux RouteTravelMode DRIVE et TWO_WHEELER.

avoid_ferries

bool

Lorsque la valeur est définie sur "true", évite les ferries lorsque cela est raisonnable, en donnant la priorité aux itinéraires ne contenant pas de ferries. S'applique uniquement aux RouteTravelMode DRIVE et TWO_WHEELER.

avoid_indoor

bool

Lorsque cette règle est définie sur "True", évite de naviguer en intérieur dans la mesure du possible, en privilégiant les itinéraires ne comportant pas de navigation en intérieur. S'applique uniquement à l'élément RouteTravelMode WALK.

vehicle_info

VehicleInfo

Spécifie les informations sur le véhicule.

toll_passes[]

TollPass

Encapsule les informations sur les pass de péage. Si des pass de péage sont fournis, l'API tente de renvoyer le prix du titre de transport. Si aucun pass de péage n'est fourni, l'API considère qu'il s'agit d'un titre inconnu et tente de renvoyer le prix en espèces. S'applique uniquement aux RouteTravelMode DRIVE et TWO_WHEELER.

avoid_tunnels

bool

Si la valeur est "true", évite les tunnels dans la mesure du raisonnable, en donnant la préférence aux routes ne contenant aucun tunnel. S'applique uniquement aux RouteTravelMode DRIVE et TWO_WHEELER. RoutingPreference doit être défini sur TRAFFIC_AWARE_OPTIMAL. Ce champ n'est pas compatible avec ComputeRouteMatrix.

avoid_vignettes[]

string

Lorsque cette option est définie sur "True", évite les routes avec vignettes dans certains pays, dans la mesure du raisonnable, en privilégiant les itinéraires ne comportant pas de vignettes dans les pays listés comme proposant cette fonctionnalité. S'applique uniquement aux RouteTravelMode DRIVE et TWO_WHEELER. RoutingPreference doit être défini sur TRAFFIC_AWARE_OPTIMAL. Les pays doivent être spécifiés dans les codes de région CLDR au format Unicode. Les pays acceptés sont l'AT, la Suisse, la Suisse, la Suisse, la Suisse, le SK, le SK. Ce champ n'est pas compatible avec ComputeRouteMatrix.

hov_preference

HOVPreference

Indique si l'itinéraire doit être modifié en fonction de la présence de routes éligibles au covoiturage. Ce champ n'est pas compatible avec ComputeRouteMatrix.

HOVPreference

Indique si l'itinéraire doit être modifié en fonction de la présence de routes ou de voies VMO.

Champs
allow_hov

bool

Indique si les itinéraires sont autorisés sur les routes réservées aux VMO, en plus des sections de route qui partagent des voies VMO. Par défaut, la préférence est donnée aux itinéraires qui ne comportent pas de routes réservées aux VMO. RoutingPreference doit être défini sur TRAFFIC_AWARE_OPTIMAL.

RouteTokenOptions

Options liées aux jetons de route.

Champs
route_token

string

Facultatif. S'il est défini, une route "semblable" à la route associée au jeton est générée si possible. Vous devez toujours fournir les paramètres de requête d'origine (par exemple, point de départ, destination, etc.).

route_token_behavior

RouteTokenBehavior

Facultatif. Indication sur la manière de traiter route_token.

RouteTokenBehavior

Modes pris en charge pour les jetons de route.

Enums
ROUTE_TOKEN_BEHAVIOR_UNSPECIFIED Traité comme GET_ROUTE_UPDATES pour des raisons de compatibilité.
GET_ROUTE_UPDATES Si |origin| se trouve sur l'itinéraire représenté par route_token, l'une des routes résultantes est celle représentée par route_token. Les routes restantes ne sont pas liées. Les mises à jour sont plus efficaces lorsque |origin| est proche du début de route_token, c'est-à-dire que l'utilisateur ne s'est pas éloigné de l'endroit où route_token a été généré.
GET_SIMILAR_ROUTES La route représentée par route_token n'est pas incluse dans la réponse, mais les autres routes incluent une similarité avec route_token en tant que facteur de pondération dans leur classement.

RouteTravelAdvisory

Contient les informations supplémentaires dont l'utilisateur doit être informé, telles que d'é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 attendus sur l'itinéraire. Si ce champ est défini, mais que le sous-champ estimatedPrice n'est pas renseigné, l'itinéraire contient des péages, mais le prix estimé est inconnu. Si ce champ n'est pas défini, aucun péage n'est attendu sur l'itinéraire.

vignette_info

VignetteInfo

Encapsule les champs de données pour les vignettes. Le service ne remplit ce champ que si les conditions suivantes sont remplies:

  • La requête elle-même doit spécifier le modificateur de route avoid_vignettes.
  • L'itinéraire ainsi obtenu ne peut pas éviter le vignetage.

Dans ce cas, le champ contient des détails sur la vignette, par exemple le pays dans lequel la vignette est inévitable.

speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture de la vitesse indiquant la densité du trafic Applicable dans le cas des préférences de routage TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent toute la polyligne de l'itinéraire, sans chevauchement. Le point de début d'un intervalle spécifié est identique au point de fin de l'intervalle précédent.

Exemple :

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

int64

Consommation de carburant prévue en microlitres.

route_restrictions_partially_ignored

bool

L'itinéraire renvoyé peut présenter des restrictions qui ne conviennent pas au mode de transport demandé ni aux modificateurs d'itinéraire.

transit_fare

Money

Si ce champ est présent, contient le total du tarif ou du prix des billets pour cet itinéraire. Cette propriété n'est renvoyée que pour les requêtes TRANSIT et uniquement pour les itinéraires pour lesquels les informations tarifaires sont disponibles pour toutes les étapes de transports en commun.

VignetteInfo

Encapsule les informations de vignetage le long d'un itinéraire.

Champs
country_vignettes_used[]

string

Pays dans lesquels les vignettes sont utilisées. Les pays sont spécifiés dans les codes de région CLDR au format Unicode. Les pays acceptés sont l'AT, la Suisse, la Suisse, la Suisse, la Suisse, le SK, le SK.

RouteTravelMode

Ensemble de valeurs permettant de spécifier le mode de transport. REMARQUE: Les itinéraires WALK, BICYCLE et TWO_WHEELER sont en version bêta, et il peut arriver qu'il manque des trottoirs, des voies piétonnes ou des pistes cyclables dégagés. Vous devez présenter cet avertissement à l'utilisateur pour tous les itinéraires à pied, à vélo ou en deux-roues que vous affichez dans votre application.

Enums
TRAVEL_MODE_UNSPECIFIED Aucun mode de transport spécifié. La valeur par défaut est DRIVE.
DRIVE Déplacements en voiture à passagers.
BICYCLE Se déplacer à vélo.
WALK Déplacements à pied.
TWO_WHEELER Véhicule motorisé à deux roues. Exemple : moto. Notez que cela diffère du mode de transport BICYCLE, qui couvre le mode manuel.
TRANSIT Emprunter des itinéraires en transports en commun (si disponible)

RoutingPreference

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

Enums
ROUTING_PREFERENCE_UNSPECIFIED Aucune préférence de routage spécifiée. Valeur par défaut : TRAFFIC_UNAWARE
TRAFFIC_UNAWARE Calcule les itinéraires sans tenir compte des conditions de circulation en temps réel. Convient lorsque les conditions de circulation n'ont pas d'importance ou ne sont pas applicables. L'utilisation de cette valeur produit 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 distribué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 des 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. L'utilisation de cette valeur produit la latence la plus élevée.

Segment

Segment appartenant à un chemin.

Champs
polyline

Polyline

Obligatoire. Polyligne du segment, qui peut être utilisée pour identifier le segment si son ID est introuvable, et pour différencier deux segments s'ils ont le même ID. La polyligne est encodée selon le format d'algorithme standard des polylignes encodées dans Google Maps Platform.

Champ d'union id. Utilisé pour identifier ce segment dans un espace d'ID. Obligatoire. id ne peut être qu'un des éléments suivants :
place_id

string

ID de lieu pour cette section de route. Utilisé pour toutes les API

SegmentSpan

Utilisé pour délimiter une sous-section d'un segment. Si un tronçon couvre la totalité de la section, la valeur start_meters correspond à 0 et la valeur end_meters correspond à la longueur de la section.

Champs
start_meters

int32

Le début de l'étendue correspond au point de départ de la polyligne du segment.

end_meters

int32

L'extrémité de l'étendue est située à partir du point de départ de la polyligne du segment.

SegmentSpanAttribute

Un SegmentSpanAttribute contient les annotations renvoyées par l'API.

Champs
segment_span

SegmentSpan

Décrit l'emplacement où les annotations s'appliquent sur le segment.

level_of_service

LevelOfService

Niveau de trafic prévu pour cette section, défini par les vitesses de circulation prévues sur cette section lorsque le véhicule arrive au début de celle-ci.

SpeedReadingInterval

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

Champs
start_polyline_point_index

int32

Index de départ 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.

speed_type ne peut être qu'un des éléments suivants :

speed

Speed

Vitesse du trafic pour cet intervalle.

Vitesse

Classification de la vitesse d'une polyligne en fonction des données de trafic.

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

TollInfo

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

Champs
estimated_price[]

Money

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

TollPass

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

Enums
TOLL_PASS_UNSPECIFIED Non utilisé. Si cette valeur est utilisée, la requête échoue.
AU_ETOLL_TAG Péage de Sydney. Pour en savoir plus, consultez le site https://www.myetoll.com.au.
AU_EWAY_TAG Péage de Sydney. Pour en savoir plus, consultez le site https://www.tollpay.com.au.
AU_LINKT Péage traversant l'Australie. Pour en savoir plus, consultez le site https://www.linkt.com.au/.
AR_TELEPASE Pass de péage Argentine. Pour en savoir plus, consultez https://telepase.com.ar.
BR_AUTO_EXPRESO Pass de péage pour le Brésil. Pour en savoir plus, consultez la page https://www.autoexpreso.com.
BR_CONECTCAR Pass de péage pour le Brésil. Pour en savoir plus, consultez https://conectcar.com.
BR_MOVE_MAIS Pass de péage pour le Brésil. Pour en savoir plus, consultez le site https://movemais.com.
BR_PASSA_RAPIDO Pass de péage pour le Brésil. Pour en savoir plus, consultez https://pasorapido.gob.do/.
BR_SEM_PARAR Pass de péage pour le Brésil. Pour en savoir plus, consultez le site https://www.semparar.com.br.
BR_TAGGY Pass de péage pour le Brésil. Pour en savoir plus, consultez le site https://taggy.com.br.
BR_VELOE Pass de péage pour le Brésil. Pour en savoir plus, consultez la page https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Passage frontalier entre le Canada et les États-Unis.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Passage frontalier entre le Canada et les États-Unis.
CA_US_BLUE_WATER_EDGE_PASS Poste-frontière entre l'Ontario, le Canada et le Michigan, aux États-Unis.
CA_US_CONNEXION Poste-frontière entre l'Ontario, le Canada et le Michigan, aux États-Unis.
CA_US_NEXUS_CARD Passage frontalier entre le Canada et les États-Unis.
ID_E_TOLL Indonésie. Carte électronique fournie par plusieurs banques et utilisée pour payer les péages. Toutes les cartes électroniques émises par les banques sont facturées de la même manière. Une seule valeur enum est donc nécessaire. Exemple : Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG India.
IN_LOCAL_HP_PLATE_EXEMPT Exemption de plaque d'immatriculation de l'État de l'Inde (HP)
JP_ETC ETC au Japon. Système sans fil électronique pour collecter les péages. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. Nouvelle version de l'ETC avec une remise supplémentaire et une communication bidirectionnelle entre les appareils sur les véhicules et les antennes sur la route. https://www.go-etc.jp/etc2/index.html
MX_IAVE Péage pour le 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 Entreprise de télépéage au Mexique. C'est l'un des nombreux établissements opérant à Mexico. Pour en savoir plus, consultez https://www.televia.com.mx.
MX_TELEVIA Entreprise de télépéage au Mexique. L'un des nombreux établissements opérant à Mexico. https://www.televia.com.mx
MX_VIAPASS Pass de péage au Mexique. Pour en savoir plus, consultez la page https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS Alabama, États-Unis.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, États-Unis.
US_CA_FASTRAK en Californie, États-Unis.
US_CA_FASTRAK_CAV_STICKER Indique que le conducteur possède un pass FasTrak en plus de l'autocollant CAV délivré par le DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL Colorado, États-Unis.
US_CO_GO_PASS Colorado, États-Unis.
US_DE_EZPASSDE Allemagne, États-Unis
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS Floride, États-Unis.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD Floride, États-Unis.
US_FL_EPASS Floride, États-Unis.
US_FL_GIBA_TOLL_PASS Floride, États-Unis.
US_FL_LEEWAY Floride, États-Unis.
US_FL_SUNPASS Floride, États-Unis.
US_FL_SUNPASS_PRO Floride, États-Unis.
US_IL_EZPASSIL Illinois, États-Unis.
US_IL_IPASS Illinois, États-Unis.
US_IN_EZPASSIN en Inde, aux États-Unis.
US_KS_BESTPASS_HORIZON Kansas, États-Unis.
US_KS_KTAG Kansas, États-Unis.
US_KS_NATIONALPASS Kansas, États-Unis.
US_KS_PREPASS_ELITEPASS Kansas, États-Unis.
US_LA_GEAUXPASS Los Angeles, États-Unis.
US_LA_TOLL_TAG Los Angeles, États-Unis.
US_MA_EZPASSMA Massachusetts, États-Unis.
US_MD_EZPASSMD MD, États-Unis.
US_ME_EZPASSME ME, États-Unis.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD Michigan, États-Unis.
US_MI_BCPASS Michigan, États-Unis.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG Michigan, États-Unis.
US_MI_IQ_PROX_CARD

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

US_MI_IQ_TAG Michigan, États-Unis.
US_MI_MACKINAC_BRIDGE_MAC_PASS Michigan, États-Unis.
US_MI_NEXPRESS_TOLL Michigan, États-Unis.
US_MN_EZPASSMN Minnesota, États-Unis.
US_NC_EZPASSNC Caroline du Nord, États-Unis.
US_NC_PEACH_PASS Caroline du Nord, États-Unis.
US_NC_QUICK_PASS Caroline du Nord, États-Unis.
US_NH_EZPASSNH New York, États-Unis.
US_NJ_DOWNBEACH_EXPRESS_PASS New Jersey, États-Unis.
US_NJ_EZPASSNJ New Jersey, États-Unis.
US_NY_EXPRESSPASS New York, États-Unis.
US_NY_EZPASSNY New York, États-Unis.
US_OH_EZPASSOH Ohio, États-Unis.
US_PA_EZPASSPA Pennsylvanie, États-Unis.
US_RI_EZPASSRI Rhode Island, États-Unis.
US_SC_PALPASS Caroline du Sud, États-Unis.
US_TX_AVI_TAG Texas, États-Unis.
US_TX_BANCPASS Texas, États-Unis.
US_TX_DEL_RIO_PASS Texas, États-Unis.
US_TX_EFAST_PASS Texas, États-Unis.
US_TX_EAGLE_PASS_EXPRESS_CARD Texas, États-Unis.
US_TX_EPTOLL Texas, États-Unis.
US_TX_EZ_CROSS Texas, États-Unis.
US_TX_EZTAG Texas, États-Unis.
US_TX_FUEGO_TAG Texas, États-Unis.
US_TX_LAREDO_TRADE_TAG Texas, États-Unis.
US_TX_PLUSPASS Texas, États-Unis.
US_TX_TOLLTAG Texas, États-Unis.
US_TX_TXTAG Texas, États-Unis.
US_TX_XPRESS_CARD Texas, États-Unis.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD Utah, États-Unis.
US_VA_EZPASSVA Virginie, États-Unis.
US_WA_BREEZEBY Washington, États-Unis.
US_WA_GOOD_TO_GO Washington, États-Unis.
US_WV_EZPASSWV Virginie-Occidentale, États-Unis.
US_WV_MEMORIAL_BRIDGE_TICKETS Virginie-Occidentale, États-Unis.
US_WV_MOV_PASS Virginie-Occidentale, États-Unis
US_WV_NEWELL_TOLL_BRIDGE_TICKET Virginie-Occidentale, États-Unis.

TrafficModel

Spécifie les hypothèses à utiliser pour calculer le temps de trajet. Ce paramètre affecte la valeur renvoyée dans le champ duration de la réponse, qui contient le temps de trajet prévu en fonction des moyennes historiques.

Enums
TRAFFIC_MODEL_UNSPECIFIED Non utilisé. Si spécifié, la valeur par défaut est BEST_GUESS.
BEST_GUESS Indique que la valeur duration renvoyée 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ù les conditions de circulation sont particulièrement difficiles, la valeur peut être supérieure à cette valeur.
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 délai peut être plus court.

TransitAgency

Agence de transports en commun gérant 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 au format régional de l'agence de transports en commun.

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 gère cette ligne de transports en commun.

name

string

Nom complet de cette ligne de transports en commun (par exemple, "8 Avenue des Champs-Élysées").

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 la signalisation de 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. Ce nom correspond généralement à un numéro de ligne, tel que "M7" ou "355".

text_color

string

Couleur couramment utilisée dans le texte de la signalisation associée à cette ligne. Représenté au format hexadécimal.

vehicle

TransitVehicle

Type de véhicule circulant 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 transport à utiliser pour obtenir un itinéraire TRANSIT. La valeur par défaut correspond à tous les modes de transport acceptés.

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 spécifié.
BUS Déplacements en bus.
SUBWAY Déplacements en métro.
TRAIN Voyager en train.
LIGHT_RAIL Trajet en tramway ou en métro léger.
RAIL 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 en transports en commun.

Champs
name

LocalizedText

Nom du véhicule, en majuscules.

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, en fonction des panneaux de transports en commun locaux.

TransitVehicleType

Type de véhicule pour les itinéraires en 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 spécifiant l'unité de mesure à utiliser sur l'écran.

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

VehicleEmissionType

Ensemble de valeurs décrivant le type d'émission du véhicule. S'applique uniquement à l'élément RouteTravelMode DRIVE.

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

VehicleInfo

Contient les informations du véhicule, telles que son type d'émission

Champs
emission_type

VehicleEmissionType

Décrit le type d'émission du véhicule. S'applique uniquement à l'élément RouteTravelMode DRIVE.

total_axle_count

int32

Nombre total d'essieux. Doit être supérieur ou égal à 2 s'il est défini. Doit être configuré pour déclencher le passage d'un camion, mais est facultatif pour le transport routier. Ce champ n'est pas pris en charge dans ComputeRouteMatrix lorsque RouteTravelMode est défini sur DRIVE.

total_height_mm

int64

Hauteur du véhicule, y compris la hauteur de toute remorque attachée. Doit être configuré pour que le déclenchement soit déclenché par les camions ou les remorques. Ce champ n'est pas pris en charge dans ComputeRouteMatrix lorsque RouteTravelMode est défini sur DRIVE.

total_length_mm

int64

Longueur du véhicule, y compris la longueur de toute remorque attelée. Doit être configuré pour que le déclenchement soit déclenché par les camions ou les remorques. Ce champ n'est pas pris en charge dans ComputeRouteMatrix lorsque RouteTravelMode est défini sur DRIVE.

total_width_mm

int64

la largeur du véhicule, y compris la largeur de toute remorque associée ; Doit être configuré pour que le déclenchement soit déclenché par les camions ou les remorques. Ce champ n'est pas pris en charge dans ComputeRouteMatrix lorsque RouteTravelMode est défini sur DRIVE.

total_weight_kg

int64

Poids du véhicule, y compris le poids des remorques attachées. Dans ce contexte, le poids fait référence au poids réel, et non au poids. Doit être configuré pour que le déclenchement soit déclenché par les camions ou les remorques. Ce champ n'est pas pris en charge dans ComputeRouteMatrix lorsque RouteTravelMode est défini sur DRIVE.

trailer_info[]

TrailerInfo

Contient une entrée pour chaque bande-annonce. Si des informations sur la caravane sont fournies, RoutingPreference doit être défini sur TRAFFIC_AWARE_OPTIMAL. Ce champ n'est pas pris en charge dans ComputeRouteMatrix lorsque RouteTravelMode est défini sur DRIVE.

TrailerInfo

Informations sur les remorques individuelles attachées au véhicule. La longueur de chaque remorque doit être indiquée pour le transport routier. Les autres attributs sont facultatifs. Le nombre total d'attributs doit inclure les attributs de toutes les 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 caravane. Dans ce contexte, le poids fait référence au poids réel, et non au poids.

Repère

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

Champs
via

bool

Marque ce point de cheminement comme un jalon plutôt que comme un point d'arrêt. Pour chaque point de cheminement non via de la requête, la réponse ajoute une entrée au tableau legs afin de fournir les détails des arrêts de cette section du trajet. Définissez cette valeur sur "true" si vous souhaitez que l'itinéraire passe par ce point de cheminement sans s'arrêter. Les points de cheminement via des points de cheminement n'entraînent pas l'ajout d'une entrée au tableau legs, mais ils guident le trajet par le point de cheminement. Vous ne pouvez définir cette valeur que sur des points de cheminement intermédiaires. La requête échoue si vous définissez ce champ sur les points de cheminement terminaux. Si ComputeRoutesRequest.optimize_waypoint_order est défini sur "true", ce champ ne peut pas être défini sur "true". Sinon, la requête échoue.

vehicle_stopover

bool

Indique que le point de cheminement est destiné à l'arrêt des véhicules, lorsque le but est de monter ou de descendre. Lorsque vous définissez cette valeur, l'itinéraire calculé n'inclut pas les points de cheminement non-via sur les routes non adaptées aux montées et aux descentes. Cette option ne fonctionne que pour les modes de transport DRIVE et TWO_WHEELER, et lorsque la valeur de location_type est Location.

side_of_road

bool

Indique que l'emplacement de ce point de cheminement doit être prioritaire pour que le véhicule s'arrête à un côté de la route en particulier. Lorsque vous définissez cette valeur, l'itinéraire passe par l'emplacement afin que le véhicule puisse s'arrêter sur le côté de la route vers lequel l'emplacement est orienté à partir du centre. Cette option ne fonctionne que pour DRIVE et TWO_WHEELER RouteTravelMode.

Champ d'union location_type. Différentes manières de représenter un lieu. location_type ne peut être qu'un des éléments suivants :
location

Location

Point spécifié à l'aide de coordonnées géographiques, y compris un en-tête facultatif.

place_id

string

ID de lieu du POI associé au point de cheminement.

address

string

Adresse lisible ou plus code. Pour en savoir plus, consultez https://plus.codes.