Package google.maps.routing.v2

Index

Routes

L'API Routes

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

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

Par exemple, dans cette méthode:

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

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

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

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

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

Par exemple, dans cette méthode:

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

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

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

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. Spécifie comment calculer la route. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer la route. Si la préférence de routage génère une erreur ou une latence plus longue, une erreur est renvoyée. 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. Spécifie comment calculer la route. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer la route. Si la préférence de routage génère une erreur ou une latence plus longue, une erreur est renvoyée. 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 ne fournissez pas cette valeur, les unités d'affichage sont déduites de l'emplacement de la première origine.

optimize_waypoint_order

bool

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

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.

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. Ce contenu n'est destiné qu'à être affiché. Ne l'analysez pas par programmation.

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 pu être trouvée.

fallback_info

FallbackInfo

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

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.

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. Exemple : « America/New_York ».

Lieu

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 pour les lieux de prise en charge et de dépose. Les valeurs d'en-tête peuvent être comprises entre 0 et 360, où 0 correspond à un cap dans le nord, 90 à un en-tête à 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.

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.

PolylineEncoding

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

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

PolylineQuality

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

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

Itinéraire

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 indiquez l'entrée "Origin" : LA ; 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, alors 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.

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.

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 valeur par défaut "best" pour le calcul de la route.
DEFAULT_ROUTE_ALTERNATE Une alternative au "meilleur" par défaut via un routage réseau. 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. Exemple : "538" est le trip_short_text du train Amtrak qui part de San Jose en Californie à 15h10 en semaine pour Sacramento, en Californie.

TransitDetailsLocalizedValues

Descriptions localisées des valeurs pour RouteTransitDetails.

Champs
arrival_time

LocalizedTime

Heure dans sa représentation textuelle 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 ce paramètre est défini sur "true", cela 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.

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.

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.

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.

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 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 Japan ETC. Système électronique sans fil 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 Pass de péage au Mexique. https://iave.capufe.gob.mx/#/
MX_PASE Mexique https://www.pase.com.mx
MX_QUICKPASS Mexique : https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Mexique
MX_TAG_TELEVIA 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. C'est 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 dispose d'une carte FasTrak en plus de l'autocollant CAV émis par le DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL Colorado, États-Unis.
US_CO_GO_PASS Colorado, États-Unis.
US_DE_EZPASSDE Allemagne, États-Unis
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS Floride, États-Unis.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD Floride, États-Unis.
US_FL_EPASS Floride, États-Unis.
US_FL_GIBA_TOLL_PASS Floride, États-Unis.
US_FL_LEEWAY Floride, États-Unis.
US_FL_SUNPASS Floride, États-Unis.
US_FL_SUNPASS_PRO Floride, États-Unis.
US_IL_EZPASSIL Illinois, États-Unis.
US_IL_IPASS Illinois, États-Unis.
US_IN_EZPASSIN en Inde, aux États-Unis.
US_KS_BESTPASS_HORIZON Kansas, États-Unis.
US_KS_KTAG Kansas, États-Unis.
US_KS_NATIONALPASS Kansas, États-Unis.
US_KS_PREPASS_ELITEPASS Kansas, États-Unis.
US_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.

Repère

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

Champs
via

bool

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

vehicle_stopover

bool

Indique que le point de cheminement est destiné aux véhicules, et que l'intention est de monter ou de descendre. Lorsque vous définissez cette valeur, l'itinéraire calculé n'inclut pas les points de cheminement autres que via sur les routes non adaptées aux lieux de prise en charge et de dépose. Cette option ne fonctionne que pour les modes de transport DRIVE et TWO_WHEELER, et lorsque la valeur de location_type est Location.

side_of_road

bool

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