Route

Classe Route

Classe google.maps.routes.Route

Contient un itinéraire, qui se compose d'une série de segments de route connectés qui relient les points de cheminement de départ, d'arrivée et intermédiaires.

Accédez-y en appelant const {Route} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
computeRoutes
computeRoutes(request)
Paramètres : 
Valeur renvoyée : Promise<{
  routes:Array<Route> optional,
  fallbackInfo:FallbackInfo optional,
  geocodingResults:GeocodingResults optional
}>
Renvoie l'itinéraire principal ainsi que d'éventuels itinéraires bis, 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 la requête en définissant la propriété ComputeRoutesRequest.fields. La valeur est une liste de chemins de champ.

Par exemple :
  • Masque de champ de tous les champs disponibles : fields: ['*']
  • Masque de champ de la durée, de la distance et du chemin d'accès au niveau de l'itinéraire : fields: ['durationMillis', 'distanceMeters', 'path']

L'utilisation du masque de champ de réponse générique fields: ['*'] est déconseillée pour les raisons suivantes :
  • En ne sélectionnant que les champs dont vous avez besoin, vous aidez notre serveur à économiser des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
  • En ne sélectionnant que les champs dont vous avez besoin dans votre job de production, vous garantissez des performances de latence stables. Nous pourrons ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourront nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs au niveau supérieur, vous risquez de constater une dégradation des performances, car tout nouveau champ que nous ajouterons sera automatiquement inclus dans la réponse.
  • En ne sélectionnant que les champs dont vous avez besoin, vous obtenez une réponse plus petite et donc un chargement plus rapide sur le réseau.
description
Type : string optional
Description de l'itinéraire.
distanceMeters
Type : number optional
Distance de l'itinéraire, en mètres.
durationMillis
Type : number optional
Durée nécessaire pour parcourir l'itinéraire, en millisecondes. Si vous définissez ComputeRoutesRequest.routingPreference sur TRAFFIC_UNAWARE, cette valeur est identique à Route.staticDurationMillis. Si vous définissez ComputeRoutesRequest.routingPreference sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, cette valeur est calculée en tenant compte des conditions de circulation.

Remarque : Si la durée dépasse 2^53 millisecondes, cette valeur est Number.POSITIVE_INFINITY.
legs
Type : Array<RouteLeg> optional
Ensemble d'étapes (segments de chemin entre des points de cheminement) qui composent l'itinéraire. Chaque étape correspond au trajet entre deux points de cheminement non-via.

Par exemple :
  • Un itinéraire sans point de cheminement intermédiaire ne comporte qu'une seule étape.
  • Un itinéraire qui inclut un point de cheminement intermédiaire non-via comporte deux étapes.
  • 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.
localizedValues
Type : RouteLocalizedValues optional
Représentations textuelles des propriétés de Route.
optimizedIntermediateWaypointIndices
Type : Array<number> optional
Si vous définissez ComputeRoutesRequest.optimizeWaypointOrder sur true, ce champ contient l'ordre optimisé des points de cheminement intermédiaires. Sinon, ce champ est vide. L'index commence par 0 pour le premier point de cheminement intermédiaire fourni dans l'entrée.

Par exemple, si vous fournissez l'entrée suivante :
  • Origine : LA
  • Points de cheminement intermédiaires : Dallas, Bangor, Phoenix
  • Destination : New York
et que l'ordre optimisé des points de cheminement intermédiaires est Phoenix, Dallas, Bangor, ce champ sera [2, 0, 1].
path
Type : Array<LatLngAltitude> optional
Liste des LatLngAltitude de l'itinéraire, qui peut être utilisée pour dessiner une polyligne d'itinéraire. La précision du chemin d'accès peut être contrôlée en définissant ComputeRoutesRequest.polylineQuality.
polylineDetails
Type : PolylineDetails optional
Contient des informations sur les détails le long du chemin.
routeLabels
Type : Array<RouteLabel> optional
Étiquettes de l'itinéraire, utiles pour identifier des propriétés spécifiques ou pour les comparer à d'autres.
routeToken
Type : string optional
Jeton opaque pouvant être transmis au SDK Navigation pour reconstruire l'itinéraire pendant la navigation et, en cas de changement d'itinéraire, respecter l'intention d'origine lors de la création de l'itinéraire. Traitez ce jeton comme un blob opaque. Ne comparez pas sa valeur entre les requêtes, car elle peut changer même si le service renvoie exactement le même itinéraire.

Remarque : routeToken n'est disponible que pour les requêtes dont le paramètre ComputeRoutesRequest.routingPreference est défini sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL. Il n'est pas compatible avec les requêtes comportant des points de cheminement via.
speedPaths
Type : Array<SpeedPath> optional
Regroupements de sections de l'itinéraire avec leur vitesse correspondante. Pour que ce champ soit renseigné, ComputeRoutesRequest.routingPreference doit être défini sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, et ComputeRoutesRequest.extraComputations doit inclure TRAFFIC_ON_POLYLINE.
staticDurationMillis
Type : number optional
Durée du trajet sans tenir compte des conditions de circulation.

Remarque : Si la durée dépasse 2^53 millisecondes, cette valeur est Number.POSITIVE_INFINITY.
travelAdvisory
Type : RouteTravelAdvisory optional
Informations supplémentaires sur l'itinéraire.
viewport
Type : LatLngBounds optional
Cadre de délimitation de la fenêtre d'affichage de l'itinéraire.
warnings
Type : Array<string> optional
Tableau d'avertissements à afficher lors de l'affichage de l'itinéraire.
createPolylines
createPolylines([options])
Paramètres : 
Valeur renvoyée : Array<Polyline>
Crée des polylignes pour l'itinéraire en fonction des données disponibles.

Polylignes multimodales :
  • Conditions requises :
  • Crée une polyligne pour chaque segment d'itinéraire multimodal. Les polylignes sont stylisées en fonction du mode de transport du segment et des données de la ligne de transport en commun, lorsqu'elles sont disponibles. Vous pouvez transmettre des options pour modifier le style de la polyligne en fonction du mode de transport et de la ligne de transports en commun.

Polylignes de trafic :
  • Conditions requises :
  • Crée une polyligne pour chaque intervalle d'itinéraire lorsque la vitesse lue diffère de l'intervalle précédent. Les polylignes ont un style par défaut basé sur la vitesse. Vous pouvez transmettre des options pour modifier le style de la polyligne en fonction de la vitesse.

Polyligne globale :
  • Conditions requises :
  • Crée une seule polyligne pour l'ensemble de l'itinéraire, avec un style par défaut appliqué. Vous pouvez transmettre des options pour modifier le style de la polyligne en fonction du mode de transport de l'itinéraire. Pour une personnalisation plus poussée, créez des polylignes directement à l'aide de Route.path ou RouteLeg.path.
createWaypointAdvancedMarkers
createWaypointAdvancedMarkers([options])
Paramètres : 
Valeur renvoyée : Promise<Array<AdvancedMarkerElement>>
Crée des repères pour l'itinéraire, étiquetés "A", "B", "C", etc. pour chaque point de cheminement. Le style par défaut est appliqué aux repères. Vous pouvez transmettre des options pour modifier le style du repère en fonction de l'index du repère ou des propriétés de l'élément RouteLeg correspondant. Le paramètre WaypointMarkerDetails.leg n'est pas défini si l'itinéraire ne comporte pas d'étapes.

Le champ "legs" doit être demandé dans ComputeRoutesRequest.fields pour que les points de cheminement intermédiaires soient inclus.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Interface ComputeRoutesRequest

google.maps.routes.ComputeRoutesRequest interface

Demande d'itinéraires.
destination
Destination de l'itinéraire. Une valeur transmise sous forme de chaîne peut être une adresse, un Plus Code ou un nom de ressource Place. Les valeurs d'altitude ne sont pas prises en compte pour le calcul des itinéraires.
fields
Type : Iterable<string>
Ensemble de champs à récupérer. Spécifiez ["*"] pour tous les champs.
origin
Origine de l'itinéraire. Une valeur transmise sous forme de chaîne peut être une adresse, un Plus Code ou un nom de ressource Place. Les valeurs d'altitude ne sont pas prises en compte pour le calcul des itinéraires.
arrivalTime optional
Type : Date optional
Heure d'arrivée.

Remarque : Ne peut être défini que si ComputeRoutesRequest.travelMode est défini sur TRANSIT. Vous pouvez spécifier ComputeRoutesRequest.departureTime ou ComputeRoutesRequest.arrivalTime, mais pas les deux. Les trajets en transports en commun sont disponibles jusqu'à sept jours dans le passé ou 100 jours dans le futur.
computeAlternativeRoutes optional
Type : boolean optional
Indique s'il faut calculer des itinéraires bis en plus de l'itinéraire. Aucun itinéraire alternatif n'est renvoyé pour les requêtes comportant des points de cheminement intermédiaires.
departureTime optional
Type : Date optional
Heure de départ. Si vous ne définissez pas cette valeur, elle est définie par défaut sur l'heure à laquelle vous avez effectué la requête.

Remarque : Vous ne pouvez spécifier une heure dans le passé que si ComputeRoutesRequest.travelMode est défini sur TRANSIT. Les trajets en transports en commun sont disponibles jusqu'à sept jours dans le passé ou 100 jours dans le futur.
extraComputations optional
Liste des calculs supplémentaires pouvant être utilisés pour répondre à 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 ComputeRoutesRequest.fields pour être renvoyés dans la réponse.
intermediates optional
Type : Iterable<Waypoint> optional
Ensemble de points de cheminement le long de l'itinéraire (à l'exclusion des points de terminaison), pour s'arrêter ou passer. Vous pouvez ajouter jusqu'à 25 points de cheminement intermédiaires.
language optional
Type : string optional
Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez Unicode Locale Identifier. Consultez la section Langues acceptées pour obtenir la liste des langues disponibles. Si vous ne fournissez pas cette valeur, la langue est déduite des paramètres de localisation de l'API Google Maps JavaScript. Sinon, la langue est déduite de l'emplacement de l'origine.
optimizeWaypointOrder optional
Type : boolean optional
Si la valeur est "true", le service tente de minimiser le coût global de l'itinéraire en réorganisant les points de cheminement intermédiaires spécifiés. La requête échoue si l'un des points de cheminement intermédiaires est un point de cheminement de type "via". Utilisez Route.optimizedIntermediateWaypointIndices dans la réponse pour trouver le nouvel ordre. Si "optimizedIntermediateWaypointIndices" n'est pas demandé dans ComputeRoutesRequest.fields, la requête échoue. Si la valeur est "false", Route.optimizedIntermediateWaypointIndices dans la réponse sera vide.
polylineQuality optional
Type : PolylineQuality optional
Spécifie la préférence pour la qualité de la polyligne.
region optional
Type : string optional
Code régional, spécifié sous la forme d'une valeur ccTLD (TLD pour top-level domain, domaine de premier niveau) à deux caractères. Pour en savoir plus, consultez Domaines nationaux de premier niveau. Si vous ne fournissez pas cette valeur, la région est déduite des paramètres de localisation de l'API Google Maps JavaScript. Sinon, la région est déduite de l'emplacement de l'origine.
requestedReferenceRoutes optional
Type : Iterable<ReferenceRoute> optional
Spécifie les itinéraires de référence à calculer dans le cadre de la requête, en plus de l'itinéraire par défaut. Une route de référence est une route dont l'objectif de calcul est différent de celui de la route par défaut. Par exemple, le calcul d'un itinéraire de référence FUEL_EFFICIENT prend en compte différents paramètres qui génèrent un itinéraire économe en carburant optimal. Lorsque vous utilisez cette fonctionnalité, recherchez Route.routeLabels sur les itinéraires obtenus.
routeModifiers optional
Type : RouteModifiers optional
Ensemble de conditions à remplir qui affectent le calcul des itinéraires. Par exemple, vous pouvez spécifier des éléments à éviter, comme les routes à péage ou les autoroutes.
routingPreference optional
Type : RoutingPreference optional
Spécifie comment calculer l'itinéraire. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer l'itinéraire. Si la préférence de routage entraîne une erreur ou une latence très longue, une erreur est renvoyée. Vous ne pouvez spécifier cette option que lorsque ComputeRoutesRequest.travelMode est défini sur DRIVING ou TWO_WHEELER. Sinon, la requête échoue.
trafficModel optional
Type : TrafficModel optional
Spécifie les hypothèses à utiliser pour calculer le temps de trajet selon le trafic. Ce paramètre influe sur la valeur de Route.durationMillis et RouteLeg.durationMillis, qui contiennent le temps de trajet prévu en fonction des moyennes historiques. ComputeRoutesRequest.trafficModel n'est disponible que pour les requêtes dont le paramètre ComputeRoutesRequest.routingPreference est défini sur TRAFFIC_AWARE_OPTIMAL et le paramètre ComputeRoutesRequest.travelMode sur DRIVING. La valeur par défaut est BEST_GUESS.
transitPreference optional
Type : TransitPreference optional
Spécifie les préférences qui influencent l'itinéraire renvoyé pour les itinéraires TRANSIT.

Remarque : Ne peut être spécifié que si ComputeRoutesRequest.travelMode est défini sur TRANSIT.
travelMode optional
Type : TravelMode optional
Spécifie le mode de transport.
units optional
Type : UnitSystem optional
Spécifie les unités de mesure pour les champs d'affichage, tels que les instructions de navigation. Les unités de mesure utilisées pour l'itinéraire, l'étape, la distance de l'étape 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 du point de départ.

ComputeRoutesExtraComputation constants

google.maps.routes.ComputeRoutesExtraComputation constantes

Calculs supplémentaires à effectuer pour une requête Route.computeRoutes.

Accédez-y en appelant const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
FLYOVER_INFO_ON_POLYLINE Informations sur le survol de la ou des routes. Le champ "polylineDetails" doit être spécifié dans ComputeRoutesRequest.fields pour renvoyer ces informations. Ces données ne seront actuellement renseignées que pour certaines agglomérations en Inde. Cette fonctionnalité est expérimentale, et le SKU/les frais sont susceptibles d'être modifiés.
FUEL_CONSUMPTION Consommation de carburant estimée pour le ou les itinéraires.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS Instructions de navigation présentées sous la forme d'une chaîne de texte HTML mise en forme. Ce contenu est destiné à être lu tel quel et n'est utilisé qu'à des fins d'affichage. Ne l'analysez pas de manière programmatique.
NARROW_ROAD_INFO_ON_POLYLINE Informations sur les routes étroites pour le ou les itinéraires. Le champ "polylineDetails" doit être spécifié dans ComputeRoutesRequest.fields pour renvoyer ces informations. Ces données ne seront actuellement renseignées que pour certaines agglomérations en Inde. Cette fonctionnalité est expérimentale, et le SKU/les frais sont susceptibles d'être modifiés.
TOLLS Informations sur les péages pour le ou les itinéraires.
TRAFFIC_ON_POLYLINE Polylignes prenant en compte le trafic pour le ou les itinéraires.

Interface DirectionalLocationLiteral

google.maps.routes.DirectionalLocationLiteral interface

Les littéraux d'objet sont acceptés à la place des instances DirectionalLocation pour plus de commodité. Elles sont converties en DirectionalLocation lorsque l'API Maps JS les rencontre.

Cette interface étend LatLngAltitudeLiteral.

heading optional
Type : number optional
Orientation de la boussole associée au sens de circulation. Les valeurs de cap peuvent être des nombres compris entre 0 et 360, où 0 indique un cap plein nord, 90 un cap plein est, et ainsi de suite. Vous ne pouvez utiliser ce champ que pour les ComputeRoutesRequest.travelMode DRIVING et TWO_WHEELER.
Hérité : altitude, lat, lng

Classe DirectionalLocation

Classe google.maps.routes.DirectionalLocation

Encapsule un point géographique et un cap facultatif.

Cette classe étend LatLngAltitude.

Cette classe implémente DirectionalLocationLiteral.

Accédez-y en appelant const {DirectionalLocation} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
Hérité : LatLngAltitude
heading
Type : number optional
Orientation de la boussole associée au sens de circulation. Les valeurs de cap peuvent être des nombres compris entre 0 et 360, où 0 indique un cap plein nord, 90 un cap plein est, et ainsi de suite. Vous ne pouvez utiliser ce champ que pour les ComputeRoutesRequest.travelMode DRIVING et TWO_WHEELER.
Hérité : altitude, lat, lng
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : DirectionalLocationLiteral
Convertit en objet.
Hérité : equals

Classe FallbackInfo

Classe google.maps.routes.FallbackInfo

Informations sur la manière dont un résultat de remplacement a été utilisé dans une réponse Route.computeRoutes 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é comme solution de secours.

Accédez-y en appelant const {FallbackInfo} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
reason
Type : FallbackReason optional
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.
routingMode
Type : FallbackRoutingMode optional
Mode de routage utilisé pour la réponse. Si le remplacement a été déclenché, le mode peut être différent de la préférence de routage définie dans la requête client d'origine.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Constantes FallbackReason

google.maps.routes.FallbackReason constantes

Raison pour laquelle une réponse de remplacement a été renvoyée dans une réponse Route.computeRoutes.

Accédez-y en appelant const {FallbackReason} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
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.
SERVER_ERROR Une erreur du serveur s'est produite lors du calcul des itinéraires avec votre mode d'itinéraire préféré, mais nous avons pu renvoyer un résultat calculé par un autre mode.

FallbackRoutingMode

google.maps.routes.FallbackRoutingMode constantes

Mode de routage réel utilisé lorsqu'une réponse de remplacement est renvoyée dans une réponse Route.computeRoutes.

Accédez-y en appelant const {FallbackRoutingMode} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
TRAFFIC_AWARE Indique que le TRAFFIC_AWARE RoutingPreference a été utilisé pour calculer la réponse.
TRAFFIC_UNAWARE Indique que le TRAFFIC_UNAWARE RoutingPreference a été utilisé pour calculer la réponse.

Classe GeocodedWaypoint

Classe google.maps.routes.GeocodedWaypoint

Géocodage des lieux utilisés comme points de cheminement. Renseigné uniquement pour les points de cheminement d'adresse. Inclut des détails sur les résultats de géocodage afin de déterminer à quoi l'adresse a été géocodée.

Accédez-y en appelant const {GeocodedWaypoint} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
geocoderStatus
Type : RPCStatus optional
Indique le code d'état résultant de l'opération de geocoding.
intermediateWaypointRequestIndex
Type : number optional
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.
partialMatch
Type : boolean
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.
placeId
Type : string
ID de lieu pour ce résultat.
types
Type : Array<string>
Type(s) du résultat, sous la forme de zéro ou plusieurs tags de type. Pour connaître les types acceptés, consultez https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe GeocodingResults

Classe google.maps.routes.GeocodingResults

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

Accédez-y en appelant const {GeocodingResults} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
destination
Type : GeocodedWaypoint optional
Point de cheminement géocodé pour la destination.
intermediates
Type : Array<GeocodedWaypoint> optional
Liste de points de cheminement géocodés intermédiaires, chacun contenant un champ d'index correspondant à la position du point de cheminement (en commençant par zéro) dans l'ordre dans lequel ils ont été spécifiés dans la requête.
origin
Type : GeocodedWaypoint optional
Point de cheminement géocodé pour le point de départ.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe MultiModalSegment

Classe google.maps.routes.MultiModalSegment

Fournit des informations récapitulatives sur un segment multimodal de la RouteLeg.steps d'un itinéraire. Un segment multimodal est défini comme un ou plusieurs RouteLegStep contigus ayant le même TravelMode.

Accédez-y en appelant const {MultiModalSegment} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
instructions
Type : string optional
Instructions pour naviguer dans ce segment multimodal.
maneuver
Type : string optional
La manœuvre de navigation à effectuer à cette étape. Consultez Maneuver pour obtenir la liste des valeurs possibles.
stepEndIndex
Type : number
L'index RouteLegStep correspondant qui correspond à la fin d'un segment multimodal.
stepStartIndex
Type : number
Index RouteLegStep correspondant qui correspond au début d'un segment multimodal.
travelMode
Type : TravelMode optional
Mode de transport utilisé pour ce segment multimodal.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe PolylineDetailInfo

Classe google.maps.routes.PolylineDetailInfo

Encapsule les informations sur une caractéristique de route le long d'un segment de polyligne.

Accédez-y en appelant const {PolylineDetailInfo} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
endIndex
Type : number optional
Index de fin de cette caractéristique de route dans la polyligne.
presence
Type : RoadFeatureState optional
Indique si l'élément de route existe le long de la polyligne.
startIndex
Type : number optional
Index de début de cette caractéristique de route dans la polyligne.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe PolylineDetails

Classe google.maps.routes.PolylineDetails

Détails correspondant à un index ou à un segment contigu d'une polyligne. Étant donné une polyligne avec les points P_0, P_1, ... , P_N (index de base zéro), PolylineDetails décrit une caractéristique de route pour un intervalle donné.

Accédez-y en appelant const {PolylineDetails} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
flyoverInfo
Détails du survol le long de la polyligne.
narrowRoadInfo
Détails sur les routes étroites le long de la polyligne.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Constantes PolylineQuality

google.maps.routes.PolylineQuality constantes

Spécifie la qualité de la polyligne.

Accédez-y en appelant const {PolylineQuality} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
HIGH_QUALITY Spécifie une polyligne de haute qualité composée de plus de points que OVERVIEW, au détriment d'une taille de réponse accrue. Utilisez cette valeur lorsque vous avez besoin de plus de précision.
OVERVIEW Spécifie une polyligne de présentation composée d'un petit nombre de points. Cette option offre une latence de requête inférieure à celle de HIGH_QUALITY. Utilisez cette valeur lorsque vous affichez un aperçu de l'itinéraire.

Constantes ReferenceRoute

google.maps.routes.ReferenceRoute constantes

Une route de référence compatible sur un ComputeRoutesRequest.

Accédez-y en appelant const {ReferenceRoute} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
FUEL_EFFICIENT Itinéraire économe en carburant.
SHORTER_DISTANCE Itinéraire avec une distance de trajet plus courte.

Constantes RoadFeatureState

google.maps.routes.RoadFeatureState constantes

Encapsule les états des caractéristiques de la route le long d'un segment de polyligne.

Accédez-y en appelant const {RoadFeatureState} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
DOES_NOT_EXIST La route n'existe pas.
EXISTS La caractéristique de la route existe.

RouteLabel

google.maps.routes.RouteLabel constantes

Étiquettes de la route, utiles pour identifier des propriétés spécifiques à comparer à d'autres.

Accédez-y en appelant const {RouteLabel} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
DEFAULT_ROUTE "Meilleur" itinéraire par défaut renvoyé pour le calcul de l'itinéraire.
DEFAULT_ROUTE_ALTERNATE Alternative au "meilleur" itinéraire par défaut. Les itinéraires de ce type sont renvoyés lorsque ComputeRoutesRequest.computeAlternativeRoutes est spécifié.
FUEL_EFFICIENT Itinéraire économe en carburant. Les itinéraires portant cette étiquette sont considérés comme optimisés pour les paramètres écologiques tels que la consommation de carburant.
SHORTER_DISTANCE Itinéraire avec une distance de trajet plus courte. Cette fonctionnalité est expérimentale.

Classe RouteLeg

Classe google.maps.routes.RouteLeg

Contient un segment entre des points de cheminement non-via.

Accédez-y en appelant const {RouteLeg} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
distanceMeters
Type : number
Distance de l'étape de l'itinéraire, en mètres.
durationMillis
Type : number optional
Durée nécessaire pour parcourir l'étape de l'itinéraire, en millisecondes. Si vous définissez ComputeRoutesRequest.routingPreference sur TRAFFIC_UNAWARE, cette valeur est identique à staticDurationMillis. Si vous définissez ComputeRoutesRequest.routingPreference sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, cette valeur est calculée en tenant compte des conditions de circulation.

Remarque : Si la durée dépasse 2^53 millisecondes, cette valeur est Number.POSITIVE_INFINITY.
endLocation
Type : DirectionalLocation optional
Emplacement de fin de cette étape. Cet emplacement peut être différent de ComputeRoutesRequest.destination. Par exemple, lorsque ComputeRoutesRequest.destination n'est pas à proximité d'une route, il s'agit d'un point sur la route.
localizedValues
Type : RouteLegLocalizedValues optional
Représentations textuelles des propriétés de RouteLeg.
path
Liste des LatLngAltitude de l'étape de l'itinéraire, qui peut être utilisée pour dessiner une polyligne d'étape de l'itinéraire. La précision du chemin d'accès peut être contrôlée en définissant ComputeRoutesRequest.polylineQuality.
speedPaths
Type : Array<SpeedPath>
Regroupements de sections du chemin de l'étape de l'itinéraire avec leur relevé de vitesse correspondant. Pour que ce champ soit renseigné, ComputeRoutesRequest.routingPreference doit être défini sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, et ComputeRoutesRequest.extraComputations doit inclure TRAFFIC_ON_POLYLINE.
startLocation
Type : DirectionalLocation optional
Lieu de départ de cette étape. Cet emplacement peut être différent de ComputeRoutesRequest.origin. Par exemple, lorsque ComputeRoutesRequest.origin n'est pas à proximité d'une route, il s'agit d'un point sur la route.
staticDurationMillis
Type : number optional
Durée du trajet sur l'étape sans tenir compte des conditions de circulation.

Remarque : Si la durée dépasse 2^53 millisecondes, cette valeur est Number.POSITIVE_INFINITY.
steps
Tableau d'étapes indiquant les segments de cette étape. Chaque étape représente une instruction de navigation.
stepsOverview
Type : StepsOverview optional
Présentation des étapes de ce RouteLeg. Ce champ n'est renseigné que pour les routes TRANSIT.
travelAdvisory
Type : RouteLegTravelAdvisory optional
Contient les informations supplémentaires dont l'utilisateur doit être informé, telles que les restrictions possibles de la zone de circulation, sur un segment d'itinéraire.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe RouteLegLocalizedValues

Classe google.maps.routes.RouteLegLocalizedValues

Représentations textuelles de RouteLeg.

Accédez-y en appelant const {RouteLegLocalizedValues} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
distance
Type : string optional
Distance de l'étape de l'itinéraire, au format texte.
distanceLanguage
Type : string optional
Code de langue BCP-47 du texte de la distance, tel que "en-US" ou "sr-Latn".

Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
Type : string optional
Durée, représentée sous forme de texte et localisée dans la région de la requête. Prend en compte les conditions de circulation.
durationLanguage
Type : string optional
Code de langue BCP-47 du texte de la durée, tel que "en-US" ou "sr-Latn".

Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
Type : string optional
Durée sans tenir compte des conditions de circulation, représentée sous forme de texte.
staticDurationLanguage
Type : string optional
Code de langue BCP-47 du texte de durée statique, tel que "en-US" ou "sr-Latn".
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe RouteLegStep

Classe google.maps.routes.RouteLegStep

Contient un segment d'un RouteLeg. Une étape correspond à une instruction de navigation unique. Les étapes d'un itinéraire sont composées de segments.

Accédez-y en appelant const {RouteLegStep} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
distanceMeters
Type : number
Distance de l'étape, en mètres.
endLocation
Type : DirectionalLocation optional
Emplacement de fin de cette étape.
instructions
Type : string optional
Instructions pour naviguer dans cette étape.
localizedValues
Représentations textuelles des propriétés de RouteLegStep.
maneuver
Type : string optional
La manœuvre de navigation à effectuer à cette étape. Consultez Maneuver pour obtenir la liste des valeurs possibles.
path
Liste des LatLngAltitude de l'étape de l'itinéraire, qui peut être utilisée pour dessiner une polyligne de l'étape de l'itinéraire. La précision du chemin d'accès peut être contrôlée en définissant ComputeRoutesRequest.polylineQuality. Le champ "path" doit être demandé dans ComputeRoutesRequest.fields pour que ce champ soit renseigné.
startLocation
Type : DirectionalLocation optional
Emplacement de départ de cette étape.
staticDurationMillis
Type : number optional
Durée de l'étape sans tenir compte des conditions de circulation.

Remarque : Si la durée dépasse 2^53 millisecondes, cette valeur est Number.POSITIVE_INFINITY.
transitDetails
Type : TransitDetails optional
Informations concernant cette étape si le mode de transport est TRANSIT.
travelMode
Type : TravelMode optional
Mode de transport utilisé pour cette étape.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe RouteLegStepLocalizedValues

Classe google.maps.routes.RouteLegStepLocalizedValues

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

Accédez-y en appelant const {RouteLegStepLocalizedValues} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
distance
Type : string optional
Distance de l'étape de l'itinéraire, au format texte.
distanceLanguage
Type : string optional
Code de langue BCP-47 du texte de la distance, tel que "en-US" ou "sr-Latn".

Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
Type : string optional
Durée sans tenir compte des conditions de circulation, représentée sous forme de texte.
staticDurationLanguage
Type : string optional
Code de langue BCP-47 du texte de durée statique, tel que "en-US" ou "sr-Latn".

Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe RouteLegTravelAdvisory

Classe google.maps.routes.RouteLegTravelAdvisory

Contient des informations supplémentaires dont l'utilisateur doit être informé sur un RouteLeg.

Accédez-y en appelant const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
speedReadingIntervals
Type : Array<SpeedReadingInterval> optional
Intervalles de lecture de la vitesse détaillant la densité du trafic. Applicable en cas de TRAFFIC_AWARE et de TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference. Les intervalles couvrent l'intégralité de la polyligne de RouteLeg sans chevauchement. Le point de départ d'un intervalle spécifié est identique au point d'arrivée de l'intervalle précédent.

Exemple : 
  polyline: A ---- B ---- C ---- D ---- E ---- F ---- G 
 speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo
Type : TollInfo optional
Contient des informations sur les péages pour l'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 TollInfo.estimatedPrices n'est pas renseigné, l'étape de l'itinéraire contient des péages, mais le prix estimé est inconnu. Si ce champ est vide, il n'y a pas de péage sur le RouteLeg.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe RouteLocalizedValues

Classe google.maps.routes.RouteLocalizedValues

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

Accédez-y en appelant const {RouteLocalizedValues} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
distance
Type : string optional
Distance de l'itinéraire représentée sous forme de texte.
distanceLanguage
Type : string optional
Code de langue BCP-47 du texte de la distance, tel que "en-US" ou "sr-Latn".

Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
Type : string optional
Durée, représentée sous forme de texte et localisée dans la région de la requête. Prend en compte les conditions de circulation. Remarque : Si vous n'avez pas demandé d'informations sur le trafic, cette valeur est identique à celle de staticDuration.
durationLanguage
Type : string optional
Code de langue BCP-47 du texte de la durée, tel que "en-US" ou "sr-Latn".

Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
Type : string optional
Durée sans tenir compte des conditions de circulation, représentée sous forme de texte.
staticDurationLanguage
Type : string optional
Code de langue BCP-47 du texte de durée statique, tel que "en-US" ou "sr-Latn".
transitFare
Type : string optional
Tarif de transport en commun représenté sous forme de texte.
transitFareLanguage
Type : string optional
Code de langue BCP-47 du texte du tarif de transport en commun, tel que "en-US" ou "sr-Latn".
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Interface RouteModifiers

google.maps.routes.RouteModifiers interface

Encapsule un ensemble de conditions facultatives à remplir lors du calcul des itinéraires.
avoidFerries optional
Type : boolean optional
Lorsque cette option est définie sur true, les ferries sont évités dans la mesure du possible, et les itinéraires sans ferry sont privilégiés. S'applique uniquement aux DRIVING ou TWO_WHEELER TravelMode.
avoidHighways optional
Type : boolean optional
Lorsque la valeur est définie sur true, évite les autoroutes dans la mesure du possible, en privilégiant les itinéraires qui n'en comportent pas. S'applique uniquement aux DRIVING ou TWO_WHEELER TravelMode.
avoidIndoor optional
Type : boolean optional
Lorsque cette option est définie sur true, elle évite autant que possible la navigation en intérieur, en privilégiant les itinéraires qui n'en contiennent pas. S'applique uniquement à WALKING TravelMode.
avoidTolls optional
Type : boolean optional
Lorsque la valeur est définie sur true, évite les routes à péage dans la mesure du possible, en privilégiant les itinéraires qui n'en comportent pas. S'applique uniquement aux DRIVING ou TWO_WHEELER TravelMode.
tollPasses optional
Type : Iterable<string> optional
Encapsule les informations sur les badges de télépéage. Si des badges de télépéage sont fournis, l'API tente de renvoyer le prix du badge. Si aucun badge de télépéage n'est fourni, l'API traite le badge de télépéage comme inconnu et tente de renvoyer le prix en espèces. S'applique uniquement aux DRIVING ou TWO_WHEELER TravelMode. Consultez TollPass pour obtenir la liste des valeurs valides.
vehicleInfo optional
Type : VehicleInfo optional
Spécifie les informations sur le véhicule.

Interface RoutePolylineDetails

google.maps.routes.RoutePolylineDetails interface

Détails sur une section d'un itinéraire correspondant à une polyligne qui peut être utilisée pour personnaliser le style de la polyligne.
speed optional
Type : Speed optional
La vitesse de la section de l'itinéraire correspondant à cette polyligne. Renseigné uniquement pour les itinéraires avec des informations sur le trafic.
transitDetails optional
Type : TransitDetails optional
Détails des transports en commun pour la section de l'itinéraire correspondant à cette polyligne. Renseigné uniquement pour les itinéraires avec des informations sur les transports en commun.
travelMode optional
Type : TravelMode optional
Mode de transport de la section de l'itinéraire correspondant à cette polyligne. Vide pour les polylignes de trafic.

Interface RoutePolylineOptions

google.maps.routes.RoutePolylineOptions interface

Options de création de polylignes d'itinéraire.
colorScheme optional
Type : ColorScheme optional
Jeu de couleurs à utiliser pour la polyligne. Si vous spécifiez FOLLOW_SYSTEM alors que le colorScheme de la carte est également FOLLOW_SYSTEM, les polylignes seront dessinées dans le même mode sombre/clair que la carte. Si aucune valeur n'est spécifiée, Route.createPolylines tente d'utiliser le colorScheme de la carte ou utilise le paramètre système par défaut.
polylineOptions optional
Options permettant de personnaliser le style d'une polyligne. Il peut s'agir d'un objet PolylineOptions appliqué à toutes les polylignes de l'itinéraire ou d'une fonction qui utilise les valeurs par défaut PolylineOptions et RoutePolylineDetails, et renvoie l'objet PolylineOptions à appliquer à cette polyligne.

Classe RouteTravelAdvisory

Classe google.maps.routes.RouteTravelAdvisory

Contient des informations supplémentaires dont l'utilisateur doit être informé sur un Route.

Accédez-y en appelant const {RouteTravelAdvisory} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
fuelConsumptionMicroliters
Type : number optional
Consommation de carburant prévue en microlitres.

Remarque : Si la consommation de carburant dépasse 2^53 microlitres, cette valeur est Number.POSITIVE_INFINITY.
routeRestrictionsPartiallyIgnored
Type : boolean optional
Le Route peut être soumis à des restrictions qui ne sont pas adaptées au mode de transport ou aux modificateurs d'itinéraire demandés.
speedReadingIntervals
Type : Array<SpeedReadingInterval> optional
Intervalles de lecture de la vitesse détaillant la densité du trafic. Applicable en cas de TRAFFIC_AWARE et de TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference. Les intervalles couvrent l'intégralité de la polyligne de Route 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 
 speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo
Type : TollInfo optional
Contient des informations sur les péages sur l'Route. Ce champ n'est renseigné que si des péages sont prévus sur le Route. Si ce champ est défini, mais que TollInfo.estimatedPrices n'est pas renseigné, l'itinéraire comporte des péages, mais le prix estimé est inconnu. Si ce champ est vide, il n'y a pas de péage sur le Route.
transitFare
Type : Money optional
Si ce champ est présent, il contient le tarif total ou le prix des billets pour ce Route. Cette propriété n'est renvoyée que pour TRANSIT ComputeRoutesRequest.travelMode et uniquement si les informations tarifaires sont disponibles pour toutes les étapes en transports en commun.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Constantes RoutingPreference

google.maps.routes.RoutingPreference constantes

Facteurs à prendre en compte lors du calcul d'un itinéraire.

Accédez-y en appelant const {RoutingPreference} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
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.
TRAFFIC_UNAWARE Calcule les itinéraires sans tenir compte des conditions de circulation en temps réel. Cette option est adaptée lorsque les conditions de circulation n'ont pas d'importance ou ne s'appliquent pas. L'utilisation de cette valeur produit la latence la plus faible.

Constantes de vitesse

google.maps.routes.Speed constantes

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

Accédez-y en appelant const {Speed} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
NORMAL Vitesse normale, pas de ralentissements.
SLOW Ralentissement détecté, trafic moyen.
TRAFFIC_JAM Retards dus à la circulation.

Interface SpeedPath

google.maps.routes.SpeedPath interface

Regroupe les LatLngAltitude d'un intervalle d'itinéraire avec la vitesse de l'intervalle.
path
Chemin couvert par ce chemin de vitesse.
speed optional
Type : Speed optional
La vitesse de lecture du chemin.

Classe SpeedReadingInterval

Classe google.maps.routes.SpeedReadingInterval

Indicateur de densité du trafic sur un segment contigu d'une polyligne ou d'un tracé. Étant donné un chemin avec les points P_0, P_1, ... , P_N (index basé sur zéro), SpeedReadingInterval décrit la densité du trafic d'un intervalle.

Accédez-y en appelant const {SpeedReadingInterval} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
endPolylinePointIndex
Type : number optional
Index de fin de cet intervalle dans la polyligne.
speed
Type : Speed optional
Vitesse du trafic pendant cet intervalle.
startPolylinePointIndex
Type : number optional
Index de début de cet intervalle dans la polyligne.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : aucune
Convertit en objet.

Classe StepsOverview

Classe google.maps.routes.StepsOverview

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

Accédez-y en appelant const {StepsOverview} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
multiModalSegments
Informations résumées sur les différents segments multimodaux de RouteLeg.steps.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe TollInfo

Classe google.maps.routes.TollInfo

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

Accédez-y en appelant const {TollInfo} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
estimatedPrices
Type : Array<Money> optional
Montant monétaire des péages pour le Route ou le RouteLeg correspondant. Cette liste contient un montant pour chaque devise qui devrait être facturée par les péages. En règle générale, 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.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe TransitAgency

Classe google.maps.routes.TransitAgency

Informations sur une agence de transports en commun.

Accédez-y en appelant const {TransitAgency} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
name
Type : string optional
Nom de cette agence de transports en commun.
phoneNumber
Type : string optional
Numéro de téléphone de l'agence de transports en commun, au format spécifique aux paramètres régionaux.
url
Type : URL optional
URL de l'agence de transports en commun.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

TransitDetails

Classe google.maps.routes.TransitDetails

Informations supplémentaires sur une étape de transport en commun d'un itinéraire.

Accédez-y en appelant const {TransitDetails} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
arrivalStop
Type : TransitStop optional
Informations sur l'arrêt d'arrivée de l'étape.
arrivalTime
Type : Date optional
Heure d'arrivée prévue pour l'étape.
departureStop
Type : TransitStop optional
Informations sur l'arrêt de départ de l'étape.
departureTime
Type : Date optional
Heure de départ estimée pour l'étape.
headsign
Type : string optional
Spécifie 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 le terminus.
headwayMillis
Type : number optional
Indique le temps estimé en millisecondes entre deux départs depuis le même arrêt à l'heure actuelle. Par exemple, si la valeur de l'intervalle est de 600 000, vous attendrez environ 10 minutes si vous manquez votre bus.

Remarque : Si l'intervalle dépasse 2^53 millisecondes, cette valeur est Number.POSITIVE_INFINITY.
stopCount
Type : number
Nombre d'arrêts entre le départ et l'arrivée. Ce nombre inclut l'arrêt d'arrivée, mais exclut l'arrêt 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, stopCount sera égal à 3.
transitLine
Type : TransitLine optional
Informations sur la ligne de transports en commun utilisée à cette étape.
tripShortText
Type : string optional
Texte qui apparaît sur les horaires et les panneaux d'affichage pour identifier un trajet en transports en commun pour les passagers. Le texte identifie de manière unique un trajet au cours d'une journée de service. Par exemple, "538" est le tripShortText du train Amtrak qui part de San Jose (Californie) à 15h10 en semaine pour Sacramento (Californie).
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe TransitLine

Classe google.maps.routes.TransitLine

Informations sur une ligne de transports en commun.

Accédez-y en appelant const {TransitLine} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
agencies
L'agence (ou les agences) de transports en commun qui gère cette ligne de transports en commun.
color
Type : string optional
Couleur couramment utilisée pour désigner cette ligne. Représenté en hexadécimal.
iconURL
Type : URL optional
URL de l'icône associée à cette ligne.
name
Type : string optional
Nom complet de la ligne de transports en commun, par exemple "8 Avenue Local".
shortName
Type : string optional
Nom court de cette ligne de transports en commun. Il s'agit généralement d'un numéro de ligne tel que "M7" ou "355".
textColor
Type : string optional
Couleur couramment utilisée pour le texte sur les panneaux de cette ligne. Représenté en hexadécimal.
url
Type : URL optional
URL de cette ligne de transports en commun fournie par l'agence de transports en commun.
vehicle
Type : TransitVehicle optional
Type de véhicule utilisé sur cette ligne de transports en commun.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

TransitPreference interface

google.maps.routes.TransitPreference interface

Préférences pour les itinéraires basés sur TRANSIT qui influencent l'itinéraire renvoyé.
allowedTransitModes optional
Type : Iterable<TransitMode> optional
Ensemble de modes de transport à utiliser pour obtenir un itinéraire TRANSIT. Par défaut, tous les modes de transport acceptés sont inclus.
routingPreference optional
Type : TransitRoutePreference optional
Préférence de routage qui, lorsqu'elle est spécifiée, influence l'itinéraire TRANSIT renvoyé.

Classe TransitStop

Classe google.maps.routes.TransitStop

Informations sur un arrêt de transports en commun.

Accédez-y en appelant const {TransitStop} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
location
Type : DirectionalLocation optional
Emplacement de l'arrêt exprimé en coordonnées de latitude/longitude et un cap facultatif.
name
Type : string optional
Nom de l'arrêt de transports en commun.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe TransitVehicle

Classe google.maps.routes.TransitVehicle

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

Accédez-y en appelant const {TransitVehicle} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
iconURL
Type : URL optional
URL d'une icône associée à ce type de véhicule.
localIconURL
Type : URL optional
URL de l'icône associée à ce type de véhicule d'après la signalétique locale pour les transports en commun.
name
Type : string optional
Nom de ce véhicule, en majuscules.
nameLanguage
Type : string optional
Code de langue BCP-47 du texte du nom du véhicule, tel que "en-US" ou "sr-Latn".

Pour en savoir plus, consultez https://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
vehicleType
Type : string optional
Type de véhicule utilisé.

Pour obtenir la liste des valeurs possibles, consultez https://developers.google.com/maps/documentation/routes/reference/rpc/google.maps.routing.v2#transitvehicletype.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Constantes VehicleEmissionType

google.maps.routes.VehicleEmissionType constantes

Ensemble de valeurs décrivant le type d'émissions du véhicule. S'applique uniquement au mode de transport DRIVING.

Accédez-y en appelant const {VehicleEmissionType} = await google.maps.importLibrary("routes").
Consultez Bibliothèques de l'API Maps JavaScript.
DIESEL Véhicule diesel.
ELECTRIC Véhicule électrique.
GASOLINE Véhicule à essence.
HYBRID Véhicule à carburant hybride (essence et électricité, par exemple).

Interface VehicleInfo

google.maps.routes.VehicleInfo interface

Contient les informations sur le véhicule, telles que son type d'émission.
emissionType optional
Type : VehicleEmissionType optional
Décrit le type d'émission du véhicule. S'applique uniquement au mode de transport DRIVING.

Waypoint

google.maps.routes.Waypoint interface

Représente un point de cheminement sur un itinéraire.
location
Emplacement du point de cheminement. Une chaîne peut être une adresse, un Plus Code ou un nom de ressource Place.
sideOfRoad optional
Type : boolean optional
Indique que l'emplacement de ce point de cheminement est destiné à indiquer une préférence pour que le véhicule s'arrête d'un côté particulier de la route. Lorsque vous définissez cette valeur, l'itinéraire passe par l'emplacement de sorte que le véhicule puisse s'arrêter du côté de la route vers lequel l'emplacement est orienté par rapport au centre de la route. Cette option ne fonctionne que pour DRIVING et TWO_WHEELER ComputeRoutesRequest.travelMode.
vehicleStopover optional
Type : boolean optional
Indique que le point de cheminement est destiné à l'arrêt des véhicules, dans le but de prendre ou de déposer des passagers. Lorsque vous définissez cette valeur, l'itinéraire calculé n'inclut pas les points de cheminement non-via sur les routes qui ne sont pas adaptées à la prise en charge et à la dépose. Cette option ne fonctionne que pour les ComputeRoutesRequest.travelMode DRIVING et TWO_WHEELER, et lorsque le Waypoint.location n'est pas un string ou un Place.
via optional
Type : boolean optional
Marque ce point de cheminement comme un jalon plutôt que comme un point d'arrêt. Pour chaque point de cheminement non-via dans ComputeRoutesRequest, Route.computeRoutes ajoute une entrée au tableau Route.legs pour fournir les détails des escales 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'y arrêter. Les points de cheminement de passage n'entraînent pas l'ajout d'une entrée au tableau Route.legs, mais ils permettent de faire passer l'itinéraire par le point de cheminement.

Remarques :
  • Vous ne pouvez définir cette valeur que sur les points de cheminement intermédiaires. La requête échoue si vous définissez ce champ sur des points de cheminement de terminal.
  • Si ComputeRoutesRequest.optimizeWaypointOrder est défini sur true, ce champ ne peut pas être défini sur "true". Sinon, la requête échoue.

Interface WaypointMarkerDetails

google.maps.routes.WaypointMarkerDetails interface

Détails sur un point de cheminement pouvant être utilisé pour personnaliser le style du repère.
index
Type : number
Index du repère.
totalMarkers
Type : number
Nombre total de repères sur l'itinéraire.
leg optional
Type : RouteLeg optional
Étape à laquelle appartient le repère. Vide si l'itinéraire ne comporte aucune étape.