Package google.maps.routing.v2

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Index

Routes

API Routes

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

REMARQUE:Cette méthode nécessite que vous spécifiiez un masque de champ de réponse dans l'entrée. Vous pouvez spécifier 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 (consultez la section En-têtes et paramètres d'URL disponibles). La valeur correspond à une liste de chemins d'accès de champ 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, avec cette méthode:

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

Il est essentiel d'inclure status dans votre masque de champ, sinon tous les messages seront corrects. Google déconseille l'utilisation du masque de champ de réponse générique (*) pour les raisons suivantes:

  • Sélectionner uniquement les champs dont vous avez besoin aide notre serveur à enregistrer 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 tâche de production garantit des performances de latence stables. À l'avenir, nous ajouterons peut-être d'autres champs de réponse, et ces nouveaux champs nécessiteront peut-être davantage de temps de calcul. Si vous sélectionnez tous les champs ou si vous sélectionnez tous les champs au niveau supérieur, vous constaterez peut-être une baisse des performances, car tout nouveau champ que nous ajouterons sera automatiquement inclus dans la réponse.
  • Si vous ne sélectionnez que les champs dont vous avez besoin, la taille de la réponse est réduite et le débit du réseau est plus élevé.
Routes Compute

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Renvoie l'itinéraire principal ainsi que les autres itinéraires possibles, en fonction d'un ensemble de points de cheminement terminal 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 à l'aide d'un en-tête HTTP/gRPC X-Goog-FieldMask (consultez la section En-têtes et paramètres d'URL disponibles). La valeur correspond à une liste de chemins d'accès de champ 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, avec 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 d'utiliser le masque de champ de réponse générique (*) ou de spécifier le masque de champ à la racine (routes) pour les raisons suivantes:

  • Sélectionner uniquement les champs dont vous avez besoin aide notre serveur à enregistrer 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 tâche de production garantit des performances de latence stables. À l'avenir, nous ajouterons peut-être d'autres champs de réponse, et ces nouveaux champs nécessiteront peut-être davantage de temps de calcul. Si vous sélectionnez tous les champs ou si vous sélectionnez tous les champs au niveau supérieur, vous constaterez peut-être une baisse des performances, car tout nouveau champ que nous ajouterons sera automatiquement inclus dans la réponse.
  • Si vous ne sélectionnez que les champs dont vous avez besoin, la taille de la réponse est réduite et le débit du réseau est plus élevé.

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:

  • Le nombre d'éléments (origines/destinations) ne doit en aucun cas être supérieur à 625.
  • Le nombre d'éléments (origines/destinations) ne doit pas être supérieur à 100 si le paramètre "route_preference" est défini sur TRAFFIC_AWARE_OPTIMAL.
  • Le nombre de points de cheminement (origines et destinations) spécifié en tant que place_id ne doit pas dépasser 50.
destinations[]

RouteMatrixDestination

Obligatoire. Tableau de destinations, qui détermine les colonnes de la matrice de réponse.

travel_mode

RouteTravelMode

Facultatif. Spécifie le mode de transport.

routing_preference

RoutingPreference

Facultatif. Spécifie le mode de calcul de l'itinéraire. 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 très longue, une erreur est renvoyée. Vous ne pouvez spécifier cette option que lorsque travel_mode est défini sur DRIVE ou TWO_WHEELER. Sinon, la requête échoue.

departure_time

Timestamp

Facultatif. Heure de départ. Si vous ne définissez pas cette valeur, la valeur par défaut est l'heure à laquelle vous avez effectué la requête. Si vous définissez cette valeur sur une heure déjà passée, la requête échoue.

language_code

string

Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. 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 zone géographique de la première origine.

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 la page https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains

extra_computations[]

ExtraComputation

Facultatif. Liste de calculs supplémentaires pouvant être utilisés pour traiter 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.

Extracalcul

Calculs supplémentaires à effectuer lors de l'exécution de la requête.

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

Requête ComputeRoutes

Message de requête ComputeRoutes.

Champs
origin

Waypoint

Obligatoire. Point de cheminement d'origine.

destination

Waypoint

Obligatoire. Point de cheminement à destination.

intermediates[]

Waypoint

Facultatif. Ensemble de points de cheminement le long de l'itinéraire (hors points de terminaison) pour s'arrêter ou 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 le mode de calcul de l'itinéraire. 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 très longue, une erreur est renvoyée. Vous ne pouvez spécifier cette option que lorsque travel_mode est défini sur DRIVE ou TWO_WHEELER. Sinon, la requête échoue.

polyline_quality

PolylineQuality

Facultatif. Spécifie votre préférence de 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. Si vous définissez cette valeur sur une heure déjà passée, la requête échoue.

compute_alternative_routes

bool

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

language_code

string

Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. 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 forme de valeur ccTLD (« domaine de premier niveau ») à deux caractères. Pour en savoir plus, consultez la page https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains

units

Units

Facultatif. Spécifie les unités de mesure des champs à afficher. Cela inclut le champ instruction dans NavigationInstruction. Cette valeur ne s'applique pas aux unités de mesure utilisées pour l'itinéraire, la section, 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 de la requête.

requested_reference_routes[]

ReferenceRoute

Facultatif. Spécifie les routes de référence à calculer dans la requête en plus de la route par défaut. Un itinéraire de référence est un itinéraire avec un objectif de calcul d'itinéraire différent de l'itinéraire par défaut. Par exemple, le calcul d'un itinéraire de référence FUEL_EFFICIENT prend en compte divers paramètres qui permettent de générer un itinéraire économe en carburant optimal.

extra_computations[]

ExtraComputation

Facultatif. Liste de calculs supplémentaires pouvant être utilisés pour traiter 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.

Extracalcul

Calculs supplémentaires à effectuer lors de l'exécution de la requête.

Enums
EXTRA_COMPUTATION_UNSPECIFIED Non utilisé. Les requêtes contenant cette valeur échoueront.
TOLLS Informations sur les péages pour les itinéraires
FUEL_CONSUMPTION Estimation de la consommation de carburant des itinéraires.
TRAFFIC_ON_POLYLINE Trafic prenant en charge les polylignes pour l'itinéraire ou les itinéraires.

Route de référence

Route de référence acceptée sur ComputeRoutesRequest.

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

ComputeRoutesResponse

ComputeRoutes, le message de réponse.

Champs
routes[]

Route

Contient un tableau de routes calculées (trois maximum) lorsque vous spécifiez compute_alternatives_routes, et ne contient qu'une seule route si vous ne le spécifiez pas. Lorsque ce tableau contient plusieurs entrées, la première est l'itinéraire le plus recommandé. Si le tableau est vide, cela signifie qu'aucune route n'a pu être trouvée.

fallback_info

FallbackInfo

Dans certains cas, lorsque le serveur ne parvient pas à calculer les résultats de 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.

Informations de remplacement

Informations sur la façon dont un résultat de remplacement a été utilisé, et pourquoi. 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é pour le remplacement.

Champs
routing_mode

FallbackRoutingMode

Mode de routage utilisé pour la réponse. Si une création de remplacement est déclenchée, le mode peut être différent de la préférence de routage définie dans la requête du client d'origine.

reason

FallbackReason

Raison pour laquelle une 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 est renvoyée.

Motif de remplacement

Pourquoi 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é par 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.

Mode FallbackRouting

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 google.maps.routing.v2.RoutingPreference de TRAFFIC_UNAWARE a été utilisée pour calculer la réponse.
FALLBACK_TRAFFIC_AWARE Indique que la valeur RoutingPreference de TRAFFIC_AWARE a été utilisée pour calculer la réponse.

Point géocodéen

Informations détaillées sur les lieux utilisés comme points de cheminement Valeur renseignée seulement pour les points de cheminement d'adresse. Inclut des détails sur les résultats du geocoding pour déterminer l'adresse géocodée.

Champs
geocoder_status

Status

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

type[]

string

Type(s) de résultat, sous la forme de zéro ou de plusieurs tags de type. Types compatibles: https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types

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

GeocodingRésultats

Contient GeocodedWaypoints pour les points de cheminement de départ, de destination et intermédiaires. Valeur renseignée seulement pour les points de cheminement d'adresse.

Champs
origin

GeocodedWaypoint

Point de cheminement d'origine géocodé.

destination

GeocodedWaypoint

Point de cheminement géocodé de destination.

intermediates[]

GeocodedWaypoint

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

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

Direction de la boussole associée au sens de la circulation. Cette valeur permet de spécifier le côté de la route à prendre en charge et à dépose

Manœuvre

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

Enums
MANEUVER_UNSPECIFIED Non utilisé.
TURN_SLIGHT_LEFT Tournez légèrement vers la gauche.
TURN_SHARP_LEFT Tourner complètement à gauche.
UTURN_LEFT Faire demi-tour sur la gauche
TURN_LEFT Tournez à gauche.
TURN_SLIGHT_RIGHT Tournez légèrement vers la droite.
TURN_SHARP_RIGHT Tourner complètement à droite.
UTURN_RIGHT Faites demi-tour sur la droite.
TURN_RIGHT Tournez à droite.
STRAIGHT Allez droit au but.
RAMP_LEFT Prendre la bretelle de gauche
RAMP_RIGHT Prendre la bretelle vers la droite
MERGE Fusionner dans le trafic.
FORK_LEFT Prenez la fourchette de gauche.
FORK_RIGHT Prenez une fourchette.
FERRY Prenez le ferry.
FERRY_TRAIN Prenez le train en direction du ferry.
ROUNDABOUT_LEFT Au rond-point tournez à gauche.
ROUNDABOUT_RIGHT Au rond-point tournez à droite.

Encapsule les instructions de navigation pour une RouteLegStep

Champs
maneuver

Maneuver

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

instructions

string

Instructions pour cette étape.

Polyline

Encapsule une polyligne encodée.

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

string

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

geo_json_linestring

Struct

Spécifie une polyligne en utilisant le format LineString GeoJSON.

Encodage Polyline

Spécifie le type préféré de polyligne à 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 en utilisant le format LineString GeoJSON.

Qualité des polylignes

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

Enums
POLYLINE_QUALITY_UNSPECIFIED Aucune préférence de qualité des polylignes spécifiée. La valeur par défaut est OVERVIEW.
HIGH_QUALITY Spécifie une polyligne de haute qualité, composée de plus de points que OVERVIEW, au prix d'une taille de réponse plus élevée. Utilisez cette valeur lorsque vous avez besoin d'une plus grande précision.
OVERVIEW Spécifie une polyligne d'aperçu, composée d'un petit nombre de points. Cette valeur permet d'afficher un aperçu de l'itinéraire. L'utilisation de cette option a une latence de requête inférieure à celle de l'option HIGH_QUALITY.

Route

Encapsule un itinéraire. Il s'agit d'une série de sections de route reliées par des points de départ (début, fin et intermédiaire).

Champs
route_labels[]

RouteLabel

Étiquettes pour Route permettant d'identifier les propriétés spécifiques de la route à 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 autres que 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 autre que via possède deux sections. Un itinéraire qui inclut un point de cheminement intermédiaire via a une section. L'ordre des tronçons correspond à l'ordre des Waypoints entre origin et intermediates et 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 d'un itinéraire sans tenir compte des conditions de circulation

polyline

Polyline

Polyligne globale de l'itinéraire. Cette polyligne sera 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

Zone de délimitation de la fenêtre d'affichage de la polyligne.

travel_advisory

RouteTravelAdvisory

Informations supplémentaires sur l'itinéraire.

route_token

string

Jeton d'itinéraire encodé en base64 qui peut être transmis au système de navigation, ce qui lui permet de reconstruire l'itinéraire pendant la navigation. En cas de nouvel acheminement, il respecte l'intention initiale lorsque les routes ComputeRoutes sont appelées. Les clients doivent traiter ce jeton comme un blob opaque. 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 non plus compatible avec les requêtes comportant des points de cheminement Via.

Étiquette de route

Étiquettes pour Route permettant d'identifier les propriétés spécifiques de la route à comparer aux autres.

Enums
ROUTE_LABEL_UNSPECIFIED Par défaut - non utilisé.
DEFAULT_ROUTE La "meilleure" route par défaut renvoyée pour le calcul de la route
DEFAULT_ROUTE_ALTERNATE Alternative au meilleur itinéraire par défaut. Les itinéraires de ce type sont renvoyés lorsque compute_alternative_routes est spécifié.
FUEL_EFFICIENT Route économe en carburant Les itinéraires associés à cette valeur sont déterminés pour optimiser les paramètres éco, comme la consommation de carburant.

RouteLeg

Encapsule une section entre les points de cheminement autres que via.

Champs
distance_meters

int32

Distance du trajet par le trajet, en mètres.

duration

Duration

Temps nécessaire pour parcourir la jambe. Si route_preference est défini sur TRAFFIC_UNAWARE, cette valeur est identique à static_duration. Si la valeur de 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 par l'étape, calculée sans prendre en compte les conditions de circulation.

polyline

Polyline

Polyligne globale de cette jambe. Cela inclut la polyligne de chaque step.

start_location

Location

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

end_location

Location

Emplacement d'arrivée de cette section. Elle peut être différente du destination fourni. Par exemple, lorsque le destination fourni n'est pas à proximité d'une route, il s'agit d'un point sur la route.

steps[]

RouteLegStep

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

travel_advisory

RouteLegTravelAdvisory

Encapsule les informations supplémentaires dont l'utilisateur doit être informé, telles qu'une possible zone interdite dans une section de route, etc.

RouteLegStep

Encapsule un segment d'une RouteLeg. Une étape correspond à une seule instruction de navigation. Les étapes de l'itinéraire sont constituées d'étapes.

Champs
distance_meters

int32

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

static_duration

Duration

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

polyline

Polyline

Polyligne associée à cette étape.

start_location

Location

Lieu de départ de cette étape.

end_location

Location

Emplacement de fin de cette étape.

navigation_instruction

NavigationInstruction

Instructions de navigation.

travel_advisory

RouteLegStepTravelAdvisory

Encapsule les informations supplémentaires dont l'utilisateur doit être informé, comme la possible restriction de zone de circulation sur une étape du trajet.

RouteLegStepTravelAdvisory

Encapsule les informations supplémentaires dont l'utilisateur doit être informé, comme la possible restriction de zone de circulation sur une étape du trajet.

Champs
speed_reading_intervals[]

SpeedReadingInterval

REMARQUE: Ce champ n'est actuellement pas renseigné.

RouteLegTravelAdvisory

Encapsule les informations supplémentaires dont l'utilisateur doit être informé, telles qu'une possible zone interdite dans une section de route, etc.

Champs
toll_info

TollInfo

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

speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture de vitesse détaillant la densité du trafic. Applicable aux préférences de routage TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent l'intégralité de la polyligne du RouteLg 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).

DestinationMatrix

Une destination unique pour ComputeRouteMatrixRequest

Champs
waypoint

Waypoint

Obligatoire. Point de cheminement de destination

RouteMatrixElement

Encapsule les informations de routage 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é. Indépendamment 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 d'un itinéraire sans tenir compte des conditions de circulation

travel_advisory

RouteTravelAdvisory

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

fallback_info

FallbackInfo

Dans certains cas, lorsque le serveur ne parvient pas à calculer l'itinéraire avec les préférences données pour cette paire point de départ-destination donnée, il peut 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.

origin_index

int32

Index de base zéro de l'origine dans la requête.

destination_index

int32

Index basé sur zéro de la destination dans la requête.

RouteMatrixElementCondition

État de l'itinéraire affiché.

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 (distance_meters ou duration, par exemple) ne sont pas renseignés dans l'élément.

RouteMatrixOrigin

Une origine unique pour ComputeRouteMatrixRequest

Champs
waypoint

Waypoint

Obligatoire. Point de cheminement d'origine

route_modifiers

RouteModifiers

Facultatif. Modificateurs pour chaque itinéraire qui prend cette route comme point de départ

Modificateurs de route

Encapsule un ensemble de conditions facultatives à remplir lors du calcul des routes.

Champs
avoid_tolls

bool

Indique s'il faut éviter les routes à péage lorsque cela est raisonnable. Une préférence sera donnée aux itinéraires ne comportant pas de routes à péage. S'applique uniquement aux RouteTravelMode de DRIVE et de TWO_WHEELER.

avoid_highways

bool

Indique s'il faut éviter les autoroutes, dans la mesure du possible. Une préférence sera donnée aux itinéraires ne comprenant pas d'autoroutes. S'applique uniquement aux RouteTravelMode de DRIVE et de TWO_WHEELER.

avoid_ferries

bool

Indique s'il faut éviter les ferries lorsque cela est raisonnable. Une préférence sera donnée aux itinéraires ne contenant pas de trajets en ferry. S'applique uniquement aux RouteTravelMode DRIVE et TWO_WHEELER.

avoid_indoor

bool

Indique s'il faut éviter de naviguer en intérieur lorsque cela est raisonnable. Une préférence sera donnée aux itinéraires ne contenant pas de navigation en intérieur. S'applique uniquement au RouteTravelMode WALK.

vehicle_info

VehicleInfo

Spécifie les informations du véhicule.

toll_passes[]

TollPass

Encapsule les informations sur les pass de péage. Si des péages sont fournis, l'API tente de renvoyer le prix du billet. Si les frais de péage ne sont pas fournis, l'API les considère comme inconnus et tente de renvoyer le prix en espèces. S'applique uniquement aux RouteTravelMode de DRIVE et de TWO_WHEELER.

RouteTravelAdvisory

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

Champs
toll_info

TollInfo

Encapsule des informations sur les péages sur l'itinéraire. Ce champ n'est renseigné que si l'itinéraire comporte des péages. Si ce champ est défini, mais que le sous-champ "estimated_price" n'est pas renseigné, nous pensons que la route contient des péages, mais nous ne connaissons pas le prix estimé. Si ce champ n'est pas défini, l'itinéraire ne présente pas de péages.

speed_reading_intervals[]

SpeedReadingInterval

Intervalles de lecture de vitesse détaillant la densité du trafic. Applicable aux 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é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

Prédiction de la consommation de carburant en microlitres.

Mode TravelRouteMode

Ensemble de valeurs utilisé pour spécifier le mode de transport. REMARQUE: Les itinéraires WALK, BICYCLE et TWO_WHEELER sont en version bêta et peuvent parfois ne pas avoir de trottoirs dégagés, de chemins pédestres ou de pistes cyclables. Vous devez afficher cet avertissement auprès de l'utilisateur pour tous les itinéraires à pied, à vélo et à deux roues affichés dans votre application.

Enums
TRAVEL_MODE_UNSPECIFIED Aucun mode de transport spécifié. La valeur par défaut est DRIVE.
DRIVE Voiture.
BICYCLE Voyagez à vélo.
WALK Voyagez à pied.
TWO_WHEELER Véhicule à deux roues motorisé Par exemple, moto. Notez que cela diffère du mode de déplacement BICYCLE, qui couvre le mode manuel.

Préférence de routage

Ensemble de valeurs qui spécifie 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 prendre en compte les conditions de circulation en temps réel. Convient aux conditions de circulation sans importance ou non applicables. L'utilisation de cette valeur génère la latence la plus faible. Remarque: Pour RouteTravelMode DRIVE et TWO_WHEELER le choix de l'itinéraire et la durée dépendent du réseau routier et des conditions de circulation moyennes toutes heures confondues. Les résultats d'une demande donnée peuvent varier au fil du temps en raison des modifications du réseau routier, des nouvelles conditions de circulation moyennes et de la nature distribuée du service. Les résultats peuvent également varier entre des itinéraires presque équivalents à tout moment et à n'importe quelle fréquence.
TRAFFIC_AWARE Calcule les itinéraires en tenant compte des conditions de circulation en temps réel. Contrairement à TRAFFIC_AWARE_OPTIMAL, certaines optimisations sont appliquées pour réduire considérablement la latence.
TRAFFIC_AWARE_OPTIMAL Calcule les itinéraires en tenant compte des conditions de circulation en temps réel, sans appliquer la plupart des optimisations de performances. L'utilisation de cette valeur génère la latence la plus élevée.

Intervalle de lecture de la vitesse

Indicateur de densité de trafic sur une section contiguë d'une polyligne ou d'un tracé. Par rapport à un chemin avec les points P_0, P_1, ... , P_N (indice basé sur zéro), l'intervalle 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 circulation.

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 produit.
TRAFFIC_JAM Embouteillage détecté.

Péage

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

Champs
estimated_price[]

Money

Montant des péages pour les Route ou les RouteLeg correspondants. Cette liste indique un montant pour chaque devise censée être facturée par les péages. En règle générale, cette liste ne contient qu'un article pour les itinéraires avec péages dans une devise. Pour les trajets internationaux, cette liste peut contenir plusieurs éléments pour refléter les péages dans différentes devises.

Péage payant

Liste des pass de péage 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 la page https://www.myetoll.com.au.
AU_EWAY_TAG Péage de Sydney. Pour en savoir plus, consultez la page https://www.tollpay.com.au.
AU_LINKT Péage pour l'Australie. Pour en savoir plus, consultez la page https://www.linkt.com.au/.
AR_TELEPASE Péage pour l'Argentine Pour en savoir plus : https://telepase.com.ar
BR_AUTO_EXPRESO Péage pour le Brésil Pour en savoir plus, consultez https://www.autoexpreso.com.
BR_CONECTCAR Péage pour le Brésil Pour en savoir plus, consultez le site https://conectcar.com.
BR_MOVE_MAIS Péage pour le Brésil Pour en savoir plus, consultez https://movemais.com.
BR_PASSA_RAPIDO Péage pour le Brésil Pour en savoir plus, consultez la page https://pasorapido.gob.do/.
BR_SEM_PARAR Péage pour le Brésil Pour en savoir plus, consultez la page https://www.semparar.com.br.
BR_TAGGY Péage pour le Brésil Pour en savoir plus, consultez https://taggy.com.br.
BR_VELOE 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 Poste-frontière entre l'Ontario, le Canada et le Michigan.
CA_US_CONNEXION Poste-frontière entre l'Ontario, le Canada et le Michigan.
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 pour payer les péages. Toutes les cartes électroniques via les banques sont facturées au même prix. Une seule valeur d'énumération est donc nécessaire. Par exemple : Bank Mandiri https://www.bankmandiri.co.id/e-money – BCA https://www.bca.co.id/flazz – BNI https://www.bni.co.id/e-id/ebanking/tapcash
IN_FASTAG India.
IN_LOCAL_HP_PLATE_EXEMPT Inde, exemption de la plaque d'État de HP.
MX_IAVE Péage mexicain : 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 Compagnie de télépéage au Mexique L'un des nombreux à Mexico. Pour en savoir plus, consultez https://www.televia.com.mx.
MX_TELEVIA Compagnie de télépéage au Mexique Un des nombreux centres d'activité de Mexico. https://www.televia.com.mx
MX_VIAPASS Péage mexicain Pour en savoir plus, consultez la page https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, États-Unis.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, États-Unis.
US_CA_FASTRAK Canada, États-Unis.
US_CA_FASTRAK_CAV_STICKER Indique que le conducteur dispose d'un titre de transport 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 FL, États-Unis.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, États-Unis.
US_FL_EPASS FL, États-Unis.
US_FL_GIBA_TOLL_PASS FL, États-Unis.
US_FL_LEEWAY FL, États-Unis.
US_FL_SUNPASS FL, États-Unis.
US_FL_SUNPASS_PRO FL, États-Unis.
US_IL_EZPASSIL IL, États-Unis.
US_IL_IPASS IL, États-Unis.
US_IN_EZPASSIN en Inde.
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_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG Michigan, États-Unis.
US_MI_IQ_PROX_CARD Michigan, États-Unis.
US_MI_MACKINAC_BRIDGE_MAC_PASS Michigan, États-Unis.
US_MI_NEXPRESS_TOLL Michigan, États-Unis.
US_MN_EZPASSMN MN, É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 NH, É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 OH, États-Unis.
US_PA_EZPASSPA PA, États-Unis.
US_RI_EZPASSRI RI, États-Unis
US_SC_PALPASS SC, É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_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 UT, É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 WV, États-Unis.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, États-Unis.
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, États-Unis.

Unités

Ensemble de valeurs qui spécifie l'unité de mesure utilisée à l'écran.

Enums
UNITS_UNSPECIFIED Unités de mesure non spécifiées. Valeur par défaut : unité de mesure déduite de la requête.
METRIC Unités de mesure des métriques.
IMPERIAL Unités de mesure impériales (anglaises)

Type d'émission du véhicule

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 à essence ou à essence.
ELECTRIC Véhicule électrique.
HYBRID Véhicule à carburant hybride (essence, + électrique, par exemple)
DIESEL Véhicule diesel.

Infos véhicule

Encapsule les informations du véhicule, comme le dernier caractère de la plaque d'immatriculation.

Champs
emission_type

VehicleEmissionType

Décrit le type d'émission du véhicule. S'applique uniquement au mode de transport 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 des arrêts intermédiaires sur l'itinéraire.

Champs
via

bool

Permet de marquer 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 pour fournir les détails des arrêts sur cette section du trajet. Définissez cette valeur sur "true" lorsque 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 au tableau legs, mais ils acheminent le trajet qui le traverse. 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 des points de cheminement de terminal. Si ComputeRoutesRequest.optimize_waypoint_order est défini sur "true", ce champ ne peut pas être défini sur "true". Sinon, la requête échoue.

vehicle_stopover

bool

Indique que le point de cheminement est destiné à un arrêt aux véhicules dont l'objectif est de monter ou descendre. Lorsque vous définissez cette valeur, l'itinéraire calculé ne comprend pas les points de cheminement autres que via sur les routes qui ne conviennent pas aux modes de transport DRIVE et TWO_WHEELER, et lorsque le location_type est défini sur Location.

side_of_road

bool

Indique que l'emplacement de ce point de cheminement est prévu pour que le véhicule s'arrête à un côté de la route. Lorsque vous définissez cette valeur, l'itinéraire passe par le point où le véhicule peut s'arrêter sur le côté de la route orienté vers l'emplacement à partir du centre. Cette option fonctionne uniquement pour « DRIVE » et « TWO_WHEELER ». RouteTravelMode

Champ d'union location_type. Différentes façons de représenter un établissement. 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 titre facultatif.

place_id

string

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

address

string

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