Package google.maps.routing.v2

Index

Routes

L'API Routes

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

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

Par exemple, dans cette méthode:

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

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

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

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

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

Par exemple, dans cette méthode:

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

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

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

ComputeRouteMatrixRequest

Message de requête ComputeRouteMatrix

Champs
origins[]

RouteMatrixOrigin

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

  • 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 par le nombre de destinations ne doit en aucun cas être supérieur à 625.
  • Le produit du nombre de points de départ par le nombre de destinations ne doit pas être supérieur à 100 si la valeur de routage_preference est TRAFFIC_AWARE_OPTIMAL.
  • Le produit du nombre de points de départ par le nombre de destinations ne doit pas être supérieur à 100 si le champ "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. Spécifie comment calculer la route. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer la route. Si la préférence de routage génère une erreur ou une latence extra longue, une erreur est renvoyée. Vous ne pouvez spécifier cette option que si travel_mode est défini sur DRIVE ou TWO_WHEELER. Sinon, la requête échoue.

departure_time

Timestamp

Facultatif. Heure de départ. Si vous ne définissez pas cette valeur, elle est définie par défaut sur l'heure à laquelle vous avez effectué la requête. REMARQUE: Vous ne pouvez définir un champ departure_time par le passé que si 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 plus d'informations, consultez la section Identifiant des paramètres régionaux Unicode. Consultez la page Langues acceptées pour obtenir la liste des langues acceptées. Si vous ne fournissez pas cette valeur, la langue d'affichage est déduite de la localisation du premier point de départ.

region_code

string

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

extra_computations[]

ExtraComputation

Facultatif. Une liste de calculs supplémentaires pouvant être utilisés pour finaliser la requête. Remarque: Ces calculs supplémentaires peuvent renvoyer des champs supplémentaires sur 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 a une incidence sur la valeur renvoyée dans le champ "Duration" du RouteMatrixElement, qui contient la prévision du temps de trajet 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 l'itinéraire renvoyé pour les itinéraires TRANSIT. REMARQUE: Vous ne pouvez spécifier un élément transit_preferences que lorsque RouteTravelMode est défini sur TRANSIT.

ExtraComputation

Calculs supplémentaires à effectuer lors du traitement de la requête.

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

travel_mode

RouteTravelMode

Facultatif. Spécifie le mode de transport.

routing_preference

RoutingPreference

Facultatif. Spécifie comment calculer la route. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer la route. Si la préférence de routage entraîne une erreur ou une latence extra longue, une erreur est renvoyée. Vous ne pouvez spécifier cette option que si travel_mode est défini sur DRIVE ou TWO_WHEELER. Sinon, la requête échoue.

polyline_quality

PolylineQuality

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

polyline_encoding

PolylineEncoding

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

departure_time

Timestamp

Facultatif. Heure de départ. Si vous ne définissez pas cette valeur, elle est définie par défaut sur l'heure à laquelle vous avez effectué la requête. REMARQUE: Vous ne pouvez définir un champ departure_time par le passé que si RouteTravelMode est défini sur TRANSIT. Les trajets en transports en commun sont disponibles pour les sept derniers jours ou les 100 prochains jours.

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 sept derniers jours ou les 100 prochains jours.

compute_alternative_routes

bool

Facultatif. Indique si des itinéraires alternatifs doivent être calculés 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 à remplir qui affectent le mode de calcul des itinéraires.

language_code

string

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

region_code

string

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

units

Units

Facultatif. Spécifie les unités de mesure des 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 l'itinéraire, le trajet, la distance de pas et la durée. Si vous ne fournissez pas cette valeur, les unités d'affichage sont déduites de l'emplacement du premier point de départ.

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 rechercher 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. Une route de référence est une route associée à un objectif de calcul différent de celui de la route par défaut. Par exemple, le calcul d'un itinéraire de référence FUEL_EFFICIENT tient compte de différents paramètres permettant de générer un itinéraire économe en carburant optimal.

extra_computations[]

ExtraComputation

Facultatif. Une liste de calculs supplémentaires pouvant être utilisés pour finaliser la requête. Remarque: Ces calculs supplémentaires peuvent renvoyer des champs supplémentaires sur 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 "Duration" des champs Route et RouteLeg, qui contient la durée prévue du trafic en fonction des moyennes historiques. TrafficModel n'est disponible que pour les requêtes dont la valeur RoutingPreference est définie 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 élément transit_preferences que lorsque RouteTravelMode est défini sur TRANSIT.

ExtraComputation

Calculs supplémentaires à effectuer lors du traitement de la requête.

Enums
EXTRA_COMPUTATION_UNSPECIFIED Non utilisé. Les requêtes contenant cette valeur échoueront.
TOLLS Informations sur le péage pour le ou les itinéraires.
FUEL_CONSUMPTION Estimation de la consommation de carburant du ou des itinéraires
TRAFFIC_ON_POLYLINE Polylignes tenant compte du trafic pour le ou 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 est destiné à être affiché uniquement. Ne l'analysez pas de manière programmatique.

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 optimisés en fonction de paramètres tels que la consommation de carburant.

ComputeRoutesResponse

ComputeRoutes le message de réponse.

Champs
routes[]

Route

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

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

Contient des 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é en remplacement un mode de routage différent de votre mode préféré.

Champs
routing_mode

FallbackRoutingMode

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

reason

FallbackReason

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

FallbackReason

Raisons d'utiliser une réponse de remplacement.

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

FallbackRoutingMode

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

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

GeocodedWaypoint

Détails sur les lieux utilisés comme points de cheminement. Renseigné uniquement pour les points de cheminement d'adresse. Comprend des détails sur les résultats du geocoding afin de déterminer sur laquelle 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 ou plusieurs balises de type. Types compatibles: 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é d'origine.

destination

GeocodedWaypoint

Point de cheminement géocodé de la destination.

intermediates[]

GeocodedWaypoint

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

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 lieu (un point géographique et un titre facultatif).

Champs
lat_lng

LatLng

Coordonnées géographiques du point de cheminement.

heading

Int32Value

Orientation de la boussole associée au sens du trafic. Cette valeur indique le côté de la route où monter et descendre. Les valeurs de direction peuvent être comprises entre 0 et 360, où 0 indique une direction en sens nord, 90 indique une direction en sens vers l'est, etc. Vous ne pouvez utiliser ce champ que pour les champs 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 complètement vers la gauche.
UTURN_LEFT Faites un demi-tour à gauche.
TURN_LEFT Tournez à gauche.
TURN_SLIGHT_RIGHT Tournez légèrement vers la droite.
TURN_SHARP_RIGHT Tournez complètement vers la droite.
UTURN_RIGHT Faites un demi-tour vers la droite.
TURN_RIGHT Tournez à droite.
STRAIGHT Allez tout droit.
RAMP_LEFT Prendre la rampe de gauche.
RAMP_RIGHT Prenez la bonne rampe.
MERGE Fusionner dans les embouteillages.
FORK_LEFT Prendre la bifurcation à gauche.
FORK_RIGHT Prenez la bifurcation à droite.
FERRY Prenez le ferry.
FERRY_TRAIN Prendre le train qui mène au ferry.
ROUNDABOUT_LEFT Au rond-point, tournez à gauche.
ROUNDABOUT_RIGHT Au rond-point, tournez à droite.
DEPART Manœuvre initiale.
NAME_CHANGE Indique 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 suivre 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 coded_polyline. polyline_type ne peut être qu'un des éléments suivants :
encoded_polyline

string

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

geo_json_linestring

Struct

Spécifie une polyligne au format GeoJSON LineString.

PolylineEncoding

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

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

PolylineQuality

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

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

Route

Contient un itinéraire composé d'une série de sections de route reliées entre elles par des points de départ, d'arrivée et intermédiaires.

Champs
route_labels[]

RouteLabel

Libellés pour Route permettant d'identifier des propriétés spécifiques de l'itinéraire en vue de les comparer aux 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 non via. Par exemple, un itinéraire sans point de cheminement intermédiaire ne comporte qu'une seule section. Un itinéraire qui comprend un point de cheminement intermédiaire autre que via comporte deux sections. Un itinéraire qui comprend un point de cheminement via intermédiaire comporte une section. L'ordre des étapes correspond à l'ordre des points de cheminement de origin à intermediates, en passant par destination.

distance_meters

int32

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

duration

Duration

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

static_duration

Duration

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

polyline

Polyline

Polyligne de l'itinéraire global. Cette polyligne 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 indiquez les points de cheminement de départ: Los Angeles, Points de cheminement intermédiaires: Dallas, Bangor, Phoenix, Destination: New York, et que l'ordre des points 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 indiqué dans l'entrée.

localized_values

RouteLocalizedValues

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

route_token

string

Jeton d'itinéraire sécurisé en base64 encodé en base64 qui peut être transmis au SDK Navigation. Il permet à ce dernier de reconstruire l'itinéraire pendant la navigation et, en cas de changement d'itinéraire, de respecter l'intention initiale lorsque vous avez créé l'itinéraire en appelant ComputeRoutes. Les clients doivent traiter ce jeton comme un blob opaque. Il n'est pas destiné à lire ou à modifier. REMARQUE: Route.route_token n'est disponible que pour les requêtes pour lesquelles 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.

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 en 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é sous forme de texte.

RouteLabel

Libellés pour Route permettant d'identifier des propriétés spécifiques de l'itinéraire en vue de les comparer aux autres.

Enums
ROUTE_LABEL_UNSPECIFIED Par défaut : non utilisé.
DEFAULT_ROUTE "meilleure" route par défaut renvoyée pour le calcul de l'itinéraire.
DEFAULT_ROUTE_ALTERNATE Alternative au "meilleur" itinéraire par défaut Ce type de route est renvoyé lorsque compute_alternative_routes est spécifié.
FUEL_EFFICIENT Itinéraire économe en carburant. Les itinéraires associés à cette valeur sont optimisés en fonction des paramètres éco comme la consommation de carburant.

RouteLeg

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

Champs
distance_meters

int32

Distance parcourue pour le trajet de l'itinéraire, en mètres.

duration

Duration

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

static_duration

Duration

Durée du trajet pour l'étape, 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

Lieu de départ de cette section. Cet emplacement peut être différent de l'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 de l'destination fourni. Par exemple, lorsque le destination fourni ne se trouve pas à proximité d'une route, il s'agit d'un point sur la route.

steps[]

RouteLegStep

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

travel_advisory

RouteLegTravelAdvisory

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

localized_values

RouteLegLocalizedValues

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

steps_overview

StepsOverview

Informations générales sur la procédure à suivre dans 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 en 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).

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 un résumé des informations sur les différents segments multimodaux de la 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

L'indice RouteLegStep correspondant qui correspond 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 d'itinéraire sont composées d'étapes.

Champs
distance_meters

int32

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

static_duration

Duration

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

polyline

Polyline

Polyligne associée à cette étape.

start_location

Location

Lieu de départ de cette étape.

end_location

Location

Lieu d'arrivée de cette étape.

navigation_instruction

NavigationInstruction

des instructions de navigation ;

travel_advisory

RouteLegStepTravelAdvisory

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

localized_values

RouteLegStepLocalizedValues

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

transit_details

RouteLegStepTransitDetails

Détails concernant 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 sous forme de texte.

static_duration

LocalizedText

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

RouteLegStepTransitDetails

Informations supplémentaires sur le RouteLegStep lié aux 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

Spécifie le sens du trajet sur cette ligne, tel qu'indiqué sur le véhicule ou à l'arrêt de départ. La destination est souvent celle du terminus.

headway

Duration

Spécifie actuellement l'heure prévue sous la forme d'une durée entre deux départs depuis le même arrêt. Par exemple, avec une valeur de 600 secondes d'intervalle entre les passages, vous vous attendez à attendre 10 minutes si vous ratez 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, le champ "stop_count" renvoie la valeur 3.

trip_short_text

string

Texte qui s'affiche sur les tableaux d'horaires et les panneaux d'affichage pour indiquer aux passagers un trajet en transports en commun. Le texte doit identifier de façon unique un trajet au cours d'une journée de service. Par exemple, "538" correspond au trip_short_text du train Amtrak qui part de San Jose (Californie) à 15h10 en semaine à destination de Sacramento (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

Informations sur les arrêts de transport en commun du RouteLegStep.

Champs
arrival_stop

TransitStop

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

arrival_time

Timestamp

Heure d'arrivée estimée pour l'étape.

departure_stop

TransitStop

Informations sur l'arrêt de départ pour 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 circulation sur une étape de l'étape.

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, telles que les éventuelles restrictions de zone de circulation.

Champs
toll_info

TollInfo

Contient des informations sur les péages du RouteLeg en question. Ce champ n'est renseigné que si des péages sont prévus sur la RouteLeg. Si ce champ est défini, mais que le sous-champ "estimated_price" n'est pas renseigné, nous pensons que la route comporte des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'existe pas, le RouteLeg n'est pas payant.

speed_reading_intervals[]

SpeedReadingInterval

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

Exemple :

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

RouteMatrixDestination

Une seule destination pour ComputeRouteMatrixRequest

Champs
waypoint

Waypoint

Obligatoire. Point de cheminement de destination

RouteMatrixElement

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

Champs
status

Status

Code d'état d'erreur pour cet élément.

condition

RouteMatrixElementCondition

Indique si l'itinéraire a été trouvé ou non. Indépendant du statut

distance_meters

int32

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

duration

Duration

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

static_duration

Duration

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

travel_advisory

RouteTravelAdvisory

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

fallback_info

FallbackInfo

Dans certains cas, lorsque le serveur n'est pas en mesure de calculer l'itinéraire avec les préférences définies pour cette paire point de départ-destination, il peut se rabattre d'un autre mode de calcul. Lorsque le mode de remplacement est utilisé, ce champ contient des informations détaillées sur la réponse de remplacement. Sinon, ce champ n'est pas défini.

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 de 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 à "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 de transports en commun représenté 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 correct.
ROUTE_EXISTS Un itinéraire a été trouvé, et les informations correspondantes ont été renseignées pour l'élément.
ROUTE_NOT_FOUND Aucun itinéraire trouvé. Les champs contenant des informations sur l'itinéraire, tels que distance_meters ou duration, ne seront pas renseignés dans l'élément.

RouteMatrixOrigin

Une origine unique pour ComputeRouteMatrixRequest

Champs
waypoint

Waypoint

Obligatoire. Point de cheminement de départ

route_modifiers

RouteModifiers

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

RouteModifiers

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

Champs
avoid_tolls

bool

Lorsque ce paramètre est défini sur "true", évite les routes à péage dans la mesure du possible et privilégie les itinéraires qui ne contiennent pas de routes à péage. S'applique uniquement aux RouteTravelMode DRIVE et TWO_WHEELER.

avoid_highways

bool

Lorsque cette règle est définie sur "true", évite les autoroutes dans la mesure du possible et privilégie les itinéraires qui ne contiennent pas d'autoroutes. S'applique uniquement aux RouteTravelMode DRIVE et TWO_WHEELER.

avoid_ferries

bool

Lorsque cette règle est définie sur "true", évite les ferries dans la mesure du raisonnable et donne la préférence aux itinéraires qui ne contiennent pas de ferries. S'applique uniquement aux RouteTravelMode DRIVE et TWO_WHEELER.

avoid_indoor

bool

Lorsque cette règle est définie sur "True", elle évite les trajets à l'intérieur lorsque cela est raisonnable, et la priorité est donnée aux itinéraires qui ne comportent pas de navigation en intérieur. S'applique uniquement au RouteTravelMode WALK.

vehicle_info

VehicleInfo

Spécifie les informations sur le véhicule.

toll_passes[]

TollPass

Encapsule les informations sur les pass. Si des pass de péage sont fournis, l'API essaie de renvoyer leur prix. Si aucun pass de péage n'est fourni, l'API considère qu'il est inconnu et renvoie le prix en espèces. S'applique uniquement aux RouteTravelMode DRIVE et TWO_WHEELER.

RouteTravelAdvisory

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

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. 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, l'itinéraire ne fait l'objet d'aucun péage.

speed_reading_intervals[]

SpeedReadingInterval

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

Exemple :

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

int64

Estimation de la consommation de carburant en microlitres.

route_restrictions_partially_ignored

bool

L'itinéraire renvoyé peut présenter des restrictions qui ne sont pas adaptées au mode de transport demandé ou aux modificateurs d'itinéraire.

transit_fare

Money

S'il est présent, contient le tarif total ou le coût 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 transport en commun.

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. Par conséquent, il peut arriver qu'ils ne comportent pas de trottoirs, de voies piétonnes ou de pistes cyclables. Vous devez afficher cet avertissement pour tous les itinéraires à pied, à vélo et à 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 Trajet en voiture de tourisme
BICYCLE Déplacez-vous à vélo.
WALK Déplacements à pied.
TWO_WHEELER Véhicule à deux roues électrique. Par exemple, moto. Notez que cela diffère du mode de transport BICYCLE, qui inclut le mode de transport manuel.
TRANSIT Utilisez les itinéraires en transports en commun, le cas échéant.

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. Utiliser 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, des nouvelles moyennes de conditions de circulation 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 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 génère la latence la plus élevée.

SpeedReadingInterval

Indicateur de densité du trafic sur un segment contigu d'une polyligne ou d'un tracé Lorsqu'un chemin comporte des points P_0, P_1, ... , 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é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 dans cet intervalle.

Rapidité

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

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

TollInfo

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

Champs
estimated_price[]

Money

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

TollPass

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

Enums
TOLL_PASS_UNSPECIFIED Non utilisé. Si cette valeur est utilisée, la requête échoue.
AU_ETOLL_TAG 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 https://www.tollpay.com.au.
AU_LINKT Péage sur l'ensemble de l'Australie. Pour en savoir plus, consultez https://www.linkt.com.au/.
AR_TELEPASE Péage pour l'Argentine. Pour en savoir plus, consultez https://telepase.com.ar.
BR_AUTO_EXPRESO Pass de péage pour le Brésil. Pour en savoir plus, consultez https://www.autoexpreso.com.
BR_CONECTCAR Pass de péage pour le Brésil. Pour en savoir plus, consultez https://conectcar.com.
BR_MOVE_MAIS Pass de péage pour le Brésil. Pour en savoir plus, consultez le site https://movemais.com.
BR_PASSA_RAPIDO Pass de péage pour le Brésil. Pour en savoir plus, consultez https://pasorapido.gob.do/.
BR_SEM_PARAR Pass de péage pour le Brésil. Pour en savoir plus, consultez https://www.semparar.com.br.
BR_TAGGY Pass de péage pour le Brésil. Pour en savoir plus, consultez la page https://taggy.com.br.
BR_VELOE Pass de péage pour le Brésil. Pour en savoir plus, consultez la page https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Poste-frontière entre le Canada et les États-Unis.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Poste-frontière entre le Canada et les États-Unis.
CA_US_BLUE_WATER_EDGE_PASS Ontario, Canada et Michigan, États-Unis.
CA_US_CONNEXION Ontario, Canada et Michigan, États-Unis.
CA_US_NEXUS_CARD Poste-frontière entre le Canada et les États-Unis.
ID_E_TOLL Indonésie. Carte électronique fournie par plusieurs banques et utilisée pour le paiement des péages. Les cartes électroniques émises par les banques sont facturées de la même manière. Une seule valeur d'énumération est donc nécessaire. Par exemple, Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG India.
IN_LOCAL_HP_PLATE_EXEMPT Inde, exemption de plaque d'immatriculation HP.
JP_ETC Japon ETC. Système électronique sans fil pour la collecte des péages. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. Nouvelle version de l'ETC avec remise supplémentaire et communication bidirectionnelle entre les appareils des 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 Société mexicaine de télépéage. L'un des nombreux opéras à Mexico. Pour en savoir plus, consultez https://www.televia.com.mx.
MX_TELEVIA Société mexicaine de télépéage. L'une des nombreuses entreprises opérant à Mexico : https://www.televia.com.mx
MX_VIAPASS le télépéage du Mexique. Pour en savoir plus, consultez https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS Alabama, États-Unis.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS Alaska, États-Unis.
US_CA_FASTRAK Californie, États-Unis.
US_CA_FASTRAK_CAV_STICKER Indique que le conducteur dispose d'une vignette FasTrak en plus de l'autocollant "CAV" émis par le DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, États-Unis.
US_CO_GO_PASS CO, États-Unis.
US_DE_EZPASSDE Allemagne, États-Unis.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS Floride, États-Unis.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD Floride, États-Unis.
US_FL_EPASS Floride, États-Unis.
US_FL_GIBA_TOLL_PASS Floride, États-Unis.
US_FL_LEEWAY Floride, États-Unis.
US_FL_SUNPASS Floride, États-Unis.
US_FL_SUNPASS_PRO Floride, États-Unis.
US_IL_EZPASSIL Illinois, États-Unis.
US_IL_IPASS Illinois, États-Unis.
US_IN_EZPASSIN IN, ÉTATS-UNIS.
US_KS_BESTPASS_HORIZON Kansas, États-Unis.
US_KS_KTAG Kansas, États-Unis.
US_KS_NATIONALPASS Kansas, États-Unis.
US_KS_PREPASS_ELITEPASS Kansas, États-Unis.
US_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 Hampshire, États-Unis.
US_NJ_DOWNBEACH_EXPRESS_PASS New Jersey, États-Unis.
US_NJ_EZPASSNJ New Jersey, États-Unis.
US_NY_EXPRESSPASS New York, États-Unis.
US_NY_EZPASSNY New York, États-Unis.
US_OH_EZPASSOH Ohio, États-Unis.
US_PA_EZPASSPA Pennsylvanie, États-Unis.
US_RI_EZPASSRI RI, États-Unis.
US_SC_PALPASS Caroline du Sud, États-Unis.
US_TX_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 cette valeur est spécifiée, elle est définie par défaut sur 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 affiché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 délai peut être supérieur à cette valeur.
OPTIMISTIC Indique que la durée affiché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 bonne, le délai peut être plus court.

TransitAgency

Agence de transports en commun qui gère une ligne de transports en commun.

Champs
name

string

Nom de l'agence de transports en commun.

phone_number

string

Numéro de téléphone au format spécifique aux paramètres régionaux 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 (s) de transports en commun qui dessert cette ligne de transports en commun.

name

string

Nom complet de cette ligne de transports en commun. Par exemple, "8 Avenue Local".

uri

string

URI de cette ligne de transports en commun, tel que fourni par l'agence de transports en commun.

color

string

Couleur couramment utilisée pour la signalisation de cette ligne. Représenté en 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 couramment utilisée dans le texte de la signalétique pour cette ligne. Représenté en hexadécimal.

vehicle

TransitVehicle

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

TransitPreferences

Préférences pour les routes basées sur TRANSIT qui ont une incidence sur l'itinéraire renvoyé.

Champs
allowed_travel_modes[]

TransitTravelMode

Ensemble de modes de transport à utiliser lors de l'obtention d'un itinéraire TRANSIT. Par défaut, tous les modes de transport acceptés sont acceptés.

routing_preference

TransitRoutingPreference

Préférence de routage qui, lorsqu'elle est spécifiée, influence l'itinéraire TRANSIT renvoyé.

TransitRoutingPreference

Spécifie les préférences d'acheminement 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 permettant de spécifier le mode de transport.

Enums
TRANSIT_TRAVEL_MODE_UNSPECIFIED Aucun mode de transport en transports en commun spécifié.
BUS Voyagez en bus.
SUBWAY Prenez le métro.
TRAIN Voyagez en train.
LIGHT_RAIL Vous pouvez vous déplacer en métro léger ou en tramway.
RAIL Déplacez-vous 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

L'emplacement de l'arrêt, exprimé en coordonnées de latitude/longitude.

TransitVehicle

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

Champs
name

LocalizedText

Nom du véhicule, en 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é à ce type de véhicule, en fonction du panneau des transports 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 indiquant l'unité de mesure utilisée sur l'écran.

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

VehicleEmissionType

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

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

VehicleInfo

Contient des informations sur le véhicule, par exemple son type d'émissions.

Champs
emission_type

VehicleEmissionType

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

Repère

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

Champs
via

bool

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

vehicle_stopover

bool

Indique que le point de cheminement est destiné aux véhicules pour qu'ils s'arrêtent lorsqu'ils doivent monter ou descendre du véhicule. Si vous définissez cette valeur, l'itinéraire calculé n'inclut pas les points de cheminement autres que via sur les routes inadaptées aux montées et aux descentes. Cette option ne fonctionne que pour les modes de transport DRIVE et TWO_WHEELER, et lorsque la valeur de location_type est Location.

side_of_road

bool

Indique que l'emplacement de ce point de cheminement doit permettre au véhicule de s'arrêter en priorité sur un côté de la route. Lorsque vous définissez cette valeur, l'itinéraire passe par le lieu pour que le véhicule puisse s'arrêter du côté de la route vers lequel la position est orientée depuis le centre. Cette option ne fonctionne que pour 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, avec un cap facultatif.

place_id

string

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

address

string

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