Route (beta)

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 départ, d'arrivée et de cheminement intermédiaires.

Accédez-y en appelant le 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'autres itinéraires facultatifs, en fonction d'un ensemble de points de cheminement terminaux et intermédiaires.

 Remarque : Cette méthode nécessite que vous spécifiiez un masque de champ de réponse dans 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 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, car :
  • Si vous ne sélectionnez que les champs dont vous avez besoin, notre serveur économise des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
  • Si vous ne sélectionnez 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, les performances peuvent se dégrader, car tout nouveau champ que nous ajoutons sera automatiquement inclus dans la réponse.
  • Si vous ne sélectionnez que les champs dont vous avez besoin, la taille de la réponse sera plus petite et le chargement sur le réseau sera donc plus rapide.
description
Type : string optional
Description de l'itinéraire.
distanceMeters
Type : number optional
Distance du trajet, 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 de sections (segments de chemin entre les points de cheminement) qui composent l'itinéraire. Chaque section 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 section.
  • Un itinéraire qui inclut un point de cheminement intermédiaire non via comporte deux sections.
  • Un itinéraire qui inclut un point de cheminement intermédiaire via comporte une section.
 L'ordre des étapes correspond à l'ordre des points de cheminement de origin à intermediates, puis à destination.
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 chemin intermédiaire fourni dans l'entrée.

 Par exemple, si vous saisissez :
  • 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 peuvent être utilisés 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 du chemin.
routeLabels
Type : Array<RouteLabel> optional
Libellés de la route utiles pour identifier des propriétés spécifiques à 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 initiale 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 pour lesquelles ComputeRoutesRequest.routingPreference est défini sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL. Elle n'est pas compatible avec les requêtes comportant des points de cheminement via.
speedPaths
Type : Array<SpeedPath> optional
Groupes de sections du trajet avec la vitesse correspondante. Pour que ce champ soit rempli, 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 de route multimodal. Les polylignes sont stylisées en fonction du mode de déplacement du segment et des données de la ligne de transport en commun, le cas échéant. Des options peuvent être transmises pour modifier le style de la polyligne en fonction du mode de transport et de la ligne de transport en commun.

 Polylignes de trafic :
  • Conditions requises :
  • Crée une polyligne pour chaque intervalle de route lorsque la lecture de la vitesse diffère de l'intervalle précédent. Un style par défaut basé sur la vitesse est appliqué aux polylignes. Des options peuvent être transmises pour modifier le style de la polyligne en fonction de la vitesse.

 Polyline globale :
  • Conditions requises :
  • Crée une seule polyligne pour l'ensemble de l'itinéraire, avec le style par défaut appliqué. Des options peuvent être transmises pour modifier le style de la polyligne en fonction du mode de déplacement 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])
Valeur renvoyée : Promise<Array<AdvancedMarkerElement>>
Crée des repères pour l'itinéraire A, B, C, etc. pour chaque point de repère. Un style par défaut est appliqué aux repères. Des options peuvent être transmises pour modifier le style du repère en fonction de l'index du repère ou des propriétés du RouteLeg correspondant. Le paramètre WaypointMarkerDetails.leg ne sera pas défini si l'itinéraire ne comporte aucune étape.

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

Interface ComputeRoutesRequest

Interface google.maps.routes.ComputeRoutesRequest

Demande d'itinéraires.

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

 Remarque : Ne peut être défini que lorsque ComputeRoutesRequest.travelMode est défini sur TRANSIT. Vous pouvez spécifier une liste ComputeRoutesRequest.departureTime ou une liste ComputeRoutesRequest.arrivalTime, mais pas les deux. Les trajets en transports en commun sont disponibles pour les sept derniers jours ou les 100 prochains jours.
computeAlternativeRoutes optional
Type : boolean optional
Indique s'il faut calculer des itinéraires alternatifs 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 envoyé la demande.

 Remarque : Vous ne pouvez spécifier une heure passée que lorsque ComputeRoutesRequest.travelMode est défini sur TRANSIT. Les trajets en transports en commun sont disponibles pour les sept derniers jours ou les 100 prochains jours.
extraComputations optional
Liste des calculs supplémentaires pouvant être utilisés pour traiter la demande.

 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'y arrêter ou y 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 Identifiant de paramètres régionaux Unicode. Pour obtenir la liste des langues disponibles, consultez Langues acceptées. Si vous ne fournissez pas cette valeur, la langue est déduite de vos 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 définie sur "true", le service tente de minimiser le coût global de l'itinéraire en réorganisant les points de chemin intermédiaires spécifiés. La requête échoue si l'un des points de cheminement intermédiaires est un point de cheminement intermédiaire. 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 définie sur "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 de premier niveau de code pays. Si vous ne fournissez pas cette valeur, la région est déduite de vos 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 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 tient compte de différents paramètres qui généreraient un itinéraire optimal en termes de consommation de carburant. 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 les é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 le trajet. 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 qui ont défini ComputeRoutesRequest.routingPreference sur TRAFFIC_AWARE_OPTIMAL et 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 lorsque 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. Cette valeur n'a aucune incidence sur les unités de mesure utilisées pour la distance et la durée de l'itinéraire, de la section et de l'étape. Si vous ne fournissez pas cette valeur, les unités d'affichage sont déduites de l'emplacement de l'origine.

Constantes ComputeRoutesExtraComputation

google.maps.routes.ComputeRoutesExtraComputation constantes

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

Accédez-y en appelant le const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

FLYOVER_INFO_ON_POLYLINE Informations sur les survols pour le ou les itinéraires. Le champ "polylineDetails" doit être spécifié dans ComputeRoutesRequest.fields pour renvoyer ces informations. Pour le moment, ces données ne sont disponibles que pour certaines métropoles en Inde. Cette fonctionnalité est expérimentale. Le SKU et 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 forme de chaîne de texte HTML formatée. Ce contenu est destiné à être lu tel quel et est uniquement destiné à l'affichage. N'analysez pas ce contenu 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. Pour le moment, ces données ne sont disponibles que pour certaines métropoles en Inde. Cette fonctionnalité est expérimentale. Le SKU et les frais sont susceptibles d'être modifiés.
TOLLS Informations sur les péages pour le ou les itinéraires.
TRAFFIC_ON_POLYLINE Polylignes tenant compte du trafic pour le ou les itinéraires.

Interface DirectionalLocationLiteral

Interface google.maps.routes.DirectionalLocationLiteral

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 JavaScript les rencontre.

Cette interface étend LatLngAltitudeLiteral.

heading optional
Type : number optional
Direction indiquée par la boussole et associée au sens du trafic. Les valeurs d'orientation peuvent être des nombres compris entre 0 et 360, où 0 indique une orientation plein nord, 90 plein est, etc. 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 le const {DirectionalLocation} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

Hérité : LatLngAltitude
heading
Type : number optional
Direction indiquée par la boussole et associée au sens du trafic. Les valeurs d'orientation peuvent être des nombres compris entre 0 et 360, où 0 indique une orientation plein nord, 90 plein est, etc. 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 façon et la raison pour lesquelles un résultat de remplacement a été utilisé dans une réponse Route.computeRoutes. Si ce champ est défini, cela signifie que le serveur a utilisé un mode de routage différent de celui que vous préférez comme solution de repli.

Accédez-y en appelant le 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 secours a été utilisée à la place de la réponse d'origine. Ce champ n'est renseigné que lorsque le mode de secours est déclenché et que la réponse de secours est renvoyée.
routingMode
Type : FallbackRoutingMode optional
Mode de routage utilisé pour la réponse. Si le mode de repli a été déclenché, le mode peut être différent de la préférence de routage définie dans la demande client d'origine.

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 le 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 déplacement préféré à temps, mais nous avons pu vous fournir un résultat calculé avec un autre mode.
SERVER_ERROR Une erreur de serveur s'est produite lors du calcul des itinéraires avec votre mode de calcul préféré, mais nous avons pu renvoyer un résultat calculé par un autre mode.

Constantes FallbackRoutingMode

google.maps.routes.FallbackRoutingMode constantes

Mode d'itinéraire réel utilisé lorsqu'une réponse de secours est renvoyée dans une réponse Route.computeRoutes.

Accédez-y en appelant le 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 repère d'adresse. Inclut des informations sur les résultats du géocodage afin de déterminer à quoi l'adresse a été géocodée.

Accédez-y en appelant le 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 géocodage.
intermediateWaypointRequestIndex
Type : number optional
Index du point de repère intermédiaire correspondant dans la requête. N'est renseigné que 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 du lieu pour ce résultat.
types
Type : Array<string>
Type(s) du résultat, sous la forme de zéro, une ou plusieurs balises 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 le point de départ, la destination et les points de cheminement intermédiaires. Renseigné uniquement pour les points de repère d'adresse.

Accédez-y en appelant le 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 des points de cheminement géocodés intermédiaires, chacun contenant un champ d'index qui correspond à la position du point de cheminement (basée sur zéro) dans l'ordre dans lequel ils ont été spécifiés dans la requête.
origin
Type : GeocodedWaypoint optional
Point de cheminement géocodé pour l'origine.
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 du 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 le const {MultiModalSegment} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

instructions
Type : string optional
Instructions pour parcourir ce segment multimodal.
maneuver
Type : string optional
Manoeuvre de navigation à effectuer à cette étape. Consultez Manoeuvre pour obtenir la liste des valeurs possibles.
stepEndIndex
Type : number
Index RouteLegStep correspondant à la fin d'un segment multimodal.
stepStartIndex
Type : number
Index RouteLegStep correspondant au début d'un segment multimodal.
travelMode
Type : TravelMode optional
Mode de déplacement utilisé pour ce segment multimodal.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

PolylineDetailInfo class

Classe google.maps.routes.PolylineDetailInfo

Encapsule des informations sur une caractéristique de route le long d'une section de polyligne.

Accédez-y en appelant le 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 la 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 des 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 le 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 le 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 de la taille de la réponse. Utilisez cette valeur lorsque vous avez besoin de plus de précision.
OVERVIEW Spécifie une polyligne d'aperçu composée d'un petit nombre de points. Cette option présente 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

Un itinéraire de référence compatible sur un ComputeRoutesRequest.

Accédez-y en appelant le 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 des routes le long d'une section de polyligne.

Accédez-y en appelant le const {RoadFeatureState} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

DOES_NOT_EXIST La fonctionnalité de route n'existe pas.
EXISTS La route existe.

Constantes RouteLabel

google.maps.routes.RouteLabel constantes

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

Accédez-y en appelant le const {RouteLabel} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

DEFAULT_ROUTE Il s'agit de l'itinéraire "le plus adapté" renvoyé par défaut pour le calcul de l'itinéraire.
DEFAULT_ROUTE_ALTERNATE Alternative à l'itinéraire "meilleur" 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 associés à cette valeur sont considérés comme optimisés pour les paramètres écologiques tels que la consommation de carburant.
SHORTER_DISTANCE Itinéraire avec la distance de trajet la 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 le const {RouteLeg} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

distanceMeters
Type : number
Distance parcourue pour la section de l'itinéraire, en mètres.
durationMillis
Type : number optional
Durée nécessaire pour parcourir la section 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
Point d'arrivée de cette section. 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 la section de l'itinéraire, qui peuvent être utilisés pour dessiner une polyligne de section 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>
Groupes de sections du tracé de l'étape avec la vitesse correspondante. Pour que ce champ soit rempli, 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
Point de départ de cette section. 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 dans la section 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
Informations générales sur les étapes de cette 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 éventuelles restrictions de zone de trafic, sur une étape de l'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 le const {RouteLegLocalizedValues} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

distance
Type : string optional
Distance parcourue pour la section de l'itinéraire sous forme de texte.
distanceLanguage
Type : string optional
Code de langue BCP-47 du texte de 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 selon la région de la requête. Tient compte des 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 seule instruction de navigation. Les étapes composent les tronçons d'itinéraire.

Accédez-y en appelant le const {RouteLegStep} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

distanceMeters
Type : number
Distance parcourue lors de cette étape, en mètres.
endLocation
Type : DirectionalLocation optional
Point d'arrivée de cette étape.
instructions
Type : string optional
Instructions pour cette étape.
localizedValues
Représentations textuelles des propriétés de RouteLegStep.
maneuver
Type : string optional
Manoeuvre de navigation à effectuer à cette étape. Consultez Manoeuvre pour obtenir la liste des valeurs possibles.
path
Liste des LatLngAltitude de l'étape du trajet, qui peuvent être utilisés pour dessiner une polyligne d'étape du trajet. 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 qu'il soit renseigné.
startLocation
Type : DirectionalLocation optional
Point de départ de cette étape.
staticDurationMillis
Type : number optional
Durée du trajet à cette é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 déplacement est TRANSIT.
travelMode
Type : TravelMode optional
Mode de déplacement 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 le const {RouteLegStepLocalizedValues} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

distance
Type : string optional
Distance de trajet de l'étape de l'itinéraire sous forme de texte.
distanceLanguage
Type : string optional
Code de langue BCP-47 du texte de 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 une RouteLeg.

Accédez-y en appelant le 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 indiquant la densité du trafic. Applicable en cas de ComputeRoutesRequest.routingPreference TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent l'intégralité de la polyligne de RouteLeg sans se chevaucher. 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 le RouteLeg spécifique. Ce champ n'est renseigné que si des péages sont prévus sur RouteLeg. Si ce champ est défini, mais que TollInfo.estimatedPrices n'est pas renseigné, cela signifie que la section de l'itinéraire comporte des péages, mais que le prix estimé est inconnu. Si ce champ est vide, cela signifie qu'il n'y a pas de péages sur 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 le const {RouteLocalizedValues} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

distance
Type : string optional
Distance de trajet de l'itinéraire représentée sous forme de texte.
distanceLanguage
Type : string optional
Code de langue BCP-47 du texte de 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 selon la région de la requête. Tient compte des 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 du transport en commun représenté sous forme de texte.
transitFareLanguage
Type : string optional
Code de langue BCP-47 du texte du tarif des transports en commun, tel que "en-US" ou "sr-Latn".
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Interface RouteModifiers

Interface google.maps.routes.RouteModifiers

Encapsule un ensemble de conditions facultatives à respecter 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 à DRIVING ou TWO_WHEELER TravelMode.
avoidHighways optional
Type : boolean optional
Lorsque ce paramètre est défini sur true, l'itinéraire évite les voies rapides dans la mesure du possible et privilégie les routes qui n'en comportent pas. S'applique uniquement à DRIVING ou TWO_WHEELER TravelMode.
avoidIndoor optional
Type : boolean optional
Lorsqu'elle est définie sur true, la navigation en intérieur est évitée dans la mesure du possible, en privilégiant les itinéraires qui ne contiennent pas de navigation en intérieur. S'applique uniquement à WALKING TravelMode.
avoidTolls optional
Type : boolean optional
Lorsque cette option est définie sur true, l'application évite les routes à péage dans la mesure du possible, en privilégiant les itinéraires qui n'en comportent pas. S'applique uniquement à DRIVING ou TWO_WHEELER TravelMode.
tollPasses optional
Type : Iterable<string> optional
Encapsule les informations sur les badges de péage. Si des badges de péage sont fournis, l'API tente de renvoyer le prix du badge. Si les badges 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 à 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

Interface google.maps.routes.RoutePolylineDetails

Détails sur une section d'un itinéraire correspondant à une polyligne pouvant être utilisée pour personnaliser le style de la polyligne.

speed optional
Type : Speed optional
Vitesse de lecture 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
Informations sur les transports en commun de 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 déplacement de la section de l'itinéraire correspondant à cette polyligne. Vide pour les polylignes de trafic.

Interface RoutePolylineOptions

Interface google.maps.routes.RoutePolylineOptions

Options de création de polylignes de route.

colorScheme optional
Type : ColorScheme optional
Jeu de couleurs à utiliser pour la polyligne. Si vous spécifiez FOLLOW_SYSTEM alors que la carte colorScheme 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 revient à la valeur par défaut du système.
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 prend les valeurs par défaut PolylineOptions et RoutePolylineDetails et renvoie le PolylineOptions à appliquer à cette polyligne.

Classe RouteTravelAdvisory

Classe google.maps.routes.RouteTravelAdvisory

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

Accédez-y en appelant le 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 définie sur Number.POSITIVE_INFINITY.
routeRestrictionsPartiallyIgnored
Type : boolean optional
Il se peut que Route impose des restrictions qui ne conviennent pas au mode de déplacement ou aux modificateurs de route demandés.
speedReadingIntervals
Type : Array<SpeedReadingInterval> optional
Intervalles de lecture de la vitesse indiquant la densité du trafic. Applicable en cas de ComputeRoutesRequest.routingPreference TRAFFIC_AWARE et TRAFFIC_AWARE_OPTIMAL. Les intervalles couvrent l'intégralité de la polyligne de Route sans se chevaucher. 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 Route. Ce champ n'est renseigné que si des péages sont prévus sur Route. Si ce champ est défini, mais que TollInfo.estimatedPrices n'est pas renseigné, cela signifie que l'itinéraire comporte des péages, mais que le prix estimé est inconnu. Si ce champ est vide, cela signifie qu'il n'y a pas de péages sur Route.
transitFare
Type : Money optional
Si elle est présente, elle contient le tarif total ou le prix des billets de cette 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 le const {RoutingPreference} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

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. 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. Convient lorsque les conditions de trafic n'ont pas d'importance ou ne s'appliquent pas. Cette valeur permet d'obtenir la latence la plus faible.

Constantes Speed

google.maps.routes.Speed constantes

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

Accédez-y en appelant le const {Speed} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

NORMAL Vitesse normale, pas de ralentissement.
SLOW Ralentissement détecté, trafic modéré.
TRAFFIC_JAM le trafic est ralenti.

Interface SpeedPath

Interface google.maps.routes.SpeedPath

Regroupe les LatLngAltitude d'un intervalle de trajet avec la lecture de la vitesse pour l'intervalle.

path
Chemin couvert par ce chemin de vitesse.
speed optional
Type : Speed optional
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 chemin. Étant donné un chemin avec des points P_0, P_1, ... , P_N (index sur base zéro), SpeedReadingInterval décrit la densité du trafic d'un intervalle.

Accédez-y en appelant le 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 dans 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.

StepsOverview class

Classe google.maps.routes.StepsOverview

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

Accédez-y en appelant le 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 sur les péages sur un Route ou un RouteLeg.

Accédez-y en appelant le 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é par les péages. En règle générale, cette liste ne contient qu'un seul élément pour les itinéraires avec péages dans une seule devise. Pour les trajets internationaux, cette liste peut contenir plusieurs éléments pour 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 le 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, mis en forme en fonction des 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.

Classe TransitDetails

Classe google.maps.routes.TransitDetails

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

Accédez-y en appelant le 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 estimée 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. Il s'agit souvent du 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 headway 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 l'arrêt de départ et l'arrêt d'arrivée. Ce nombre inclut l'arrêt d'arrivée, mais pas celui de départ. Par exemple, si votre itinéraire consiste à partir de l'arrêt A pour arriver à l'arrêt D en passant par les arrêts B et C, stopCount sera égal à 3.
transitLine
Type : TransitLine optional
Informations sur la ligne de transports en commun utilisée à l'étape.
tripShortText
Type : string optional
Texte qui apparaît sur les tableaux d'horaires et les panneaux d'affichage afin de permettre aux passagers d'identifier leur trajet. 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 quitte San Jose, en Californie, à 15h10 en semaine pour Sacramento, en 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 le const {TransitLine} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

agencies
Agence ou agences de transports en commun qui exploitent cette ligne.
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, "8th 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 dans le texte des panneaux de signalisation pour 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.

Interface TransitPreference

Interface google.maps.routes.TransitPreference

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 la route TRANSIT renvoyée.

Classe TransitStop

Classe google.maps.routes.TransitStop

Informations sur un arrêt de transport en commun.

Accédez-y en appelant le 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 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é dans les itinéraires de transports en commun.

Accédez-y en appelant le 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, avec une majuscule.
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. Ne s'applique qu'au mode de déplacement DRIVING.

Accédez-y en appelant le const {VehicleEmissionType} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.

DIESEL Véhicule fonctionnant au diesel.
ELECTRIC Véhicule électrique
GASOLINE Véhicule à essence
HYBRID Véhicule hybride (essence et électricité, par exemple)

Interface VehicleInfo

Interface google.maps.routes.VehicleInfo

Contient des informations sur le véhicule, comme son type d'émission.

emissionType optional
Type : VehicleEmissionType optional
Décrit le type d'émissions du véhicule. Ne s'applique qu'au mode de déplacement DRIVING.

Interface Waypoint

Interface google.maps.routes.Waypoint

Représente un point de repère dans un itinéraire.

location
Emplacement du point de repère. Une chaîne peut être une adresse, un plus code ou un nom de ressource de lieu.
sideOfRoad optional
Type : boolean optional
Indique que le véhicule doit s'arrêter à un côté spécifique de la route à l'emplacement de ce point de cheminement. Lorsque vous définissez cette valeur, l'itinéraire passe par l'emplacement afin 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 ComputeRoutesRequest.travelMode DRIVING et TWO_WHEELER.
vehicleStopover optional
Type : boolean optional
Indique que le point de cheminement est destiné aux véhicules qui doivent s'y arrêter pour récupérer ou 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 conviennent pas aux arrêts pour récupérer ou déposer des passagers. Cette option ne fonctionne que pour les ComputeRoutesRequest.travelMode DRIVING et TWO_WHEELER, et lorsque le Waypoint.location n'est pas un string ni un Place.
via optional
Type : boolean optional
Marque ce point de cheminement comme un jalon plutôt qu'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 repère sans s'y arrêter. Les points de cheminement intermédiaires n'entraînent pas l'ajout d'une entrée au tableau Route.legs, mais ils permettent de définir l'itinéraire passant par le point de cheminement.

 Remarques :
  • Vous ne pouvez définir cette valeur que sur les waypoints 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". Dans le cas contraire, la requête échoue.

Interface WaypointMarkerDetails

Interface google.maps.routes.WaypointMarkerDetails

Informations sur un point de repère pouvant être utilisées 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
Tronçon auquel appartient le repère. Vide si la route ne comporte aucun tronçon.