Routes Data

Classe Route

classe google.maps.routes.Route
bibliothèque "routes"

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.

const {Route} = await google.maps.importLibrary("routes");
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
readonly
Type : string optional
Description de l'itinéraire.
distanceMeters
readonly
Type : number optional
Distance de l'itinéraire, en mètres.
durationMillis
readonly
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
readonly
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
readonly
Type : RouteLocalizedValues optional
Représentations textuelles des propriétés de Route.
optimizedIntermediateWaypointIndices
readonly
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
readonly
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
readonly
Type : PolylineDetails optional
Contient des informations sur les détails le long du chemin.
routeLabels
readonly
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
readonly
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
readonly
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
readonly
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
readonly
Type : RouteTravelAdvisory optional
Informations supplémentaires sur l'itinéraire.
viewport
readonly
Type : LatLngBounds optional
Cadre de délimitation de la fenêtre d'affichage de l'itinéraire.
warnings
readonly
Type : Array<string> optional
Tableau d'avertissements à afficher lors de l'affichage de l'itinéraire.
Alphacreate3DPolylines
create3DPolylines([options])
Paramètres :
Valeur renvoyée : Promise<Array<Polyline3DElement>>
Crée des polylignes 3D pour l'itinéraire en fonction des données disponibles pour 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.
AlphacreatePopover
createPopover()
Paramètres : aucun
Valeur renvoyée : Promise<PopoverElement>
Crée un popover pour l'itinéraire en fonction des données disponibles pour l'itinéraire, configuré de manière à annoter un itinéraire sur une carte. Utilise actuellement Route.localizedValues, Route.path et Route.legs, si disponibles.
createWaypointAdvancedMarkers
createWaypointAdvancedMarkers([options])
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.
AlphacreateWaypointMarkers
Paramètres :
Valeur renvoyée : Promise<Array<T>>
Crée des repères pour le point de départ et la destination de l'itinéraire. Les repères ont un style par défaut, sauf si une fonction customOverride est spécifiée. Les points de cheminement intermédiaires ne sont pas acceptés pour le moment.

Les repères créés ont leur CollisionBehavior défini sur CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL par défaut.
Hérité : toJSON

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 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
facultatif
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
facultatif
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
facultatif
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
facultatif
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
facultatif
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.
internalUsageAttributionIds
facultatif
Type : Iterable<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
language
facultatif
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
facultatif
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
facultatif
Type : PolylineQuality optional
Spécifie la préférence pour la qualité de la polyligne.
region
facultatif
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
facultatif
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
facultatif
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
facultatif
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
facultatif
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
facultatif
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
facultatif
Type : TravelMode optional
Spécifie le mode de transport.
units
facultatif
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
bibliothèque "routes"

Calculs supplémentaires à effectuer lors de l'exécution de la requête. Pour en savoir plus, consultez la documentation sur les services Web.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type ComputeRoutesExtraComputationString.

const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes");
FLYOVER_INFO_ON_POLYLINE Informations sur le survol de la ou des routes. Pour en savoir plus, consultez la documentation sur les services Web.
FUEL_CONSUMPTION Consommation de carburant estimée pour le ou les itinéraires. Pour en savoir plus, consultez la documentation sur les services Web.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS Pour en savoir plus, consultez la documentation sur les services Web.
NARROW_ROAD_INFO_ON_POLYLINE Informations sur les routes étroites pour le ou les itinéraires. Pour en savoir plus, consultez la documentation sur les services Web.
TOLLS Informations sur les péages pour le ou les itinéraires. Pour en savoir plus, consultez la documentation sur les services Web.
TRAFFIC_ON_POLYLINE Polylignes prenant en compte le trafic pour le ou les itinéraires. Pour en savoir plus, consultez la documentation sur les services Web.

Interface CreateWaypointMarkersOptions

interface google.maps.routes.CreateWaypointMarkersOptions<T = MarkerElement|Marker3DElement|MarkerInteractiveElement|Marker3DInteractiveElement>

Options de création de repères de point de cheminement.

forEach
facultatif
Type : function(T): void optional
Fonction personnalisée permettant de modifier les éléments créés. La fonction forEach par défaut ajoute des repères avec des glyphes de A à Z à chaque repère. Pour obtenir un comportement différent, remplacez cette fonction.
markerClass
facultatif
Type : new () => T optional
Constructeur de l'élément à créer. Types acceptés :

Interface DirectionalLocationLiteral

interface google.maps.routes.DirectionalLocationLiteral extends LatLngAltitudeLiteral, LatLngLiteral
implemented by DirectionalLocation

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.

heading
facultatif
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

class google.maps.routes.DirectionalLocation extends LatLngAltitude implements DirectionalLocationLiteral, LatLngAltitudeLiteral, LatLngLiteral
library "routes"

Encapsule un point géographique et un cap facultatif.

const {DirectionalLocation} = await google.maps.importLibrary("routes");
Hérité : LatLngAltitude
heading
readonly
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([key])
Paramètres :
  • key: string optional
Valeur renvoyée : DirectionalLocationLiteral
Convertit en objet brut.
Hérité : equals

Classe FallbackInfo

classe google.maps.routes.FallbackInfo
bibliothèque "routes"

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.

const {FallbackInfo} = await google.maps.importLibrary("routes");
reason
readonly
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
readonly
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.
Hérité : toJSON

Constantes FallbackReason

google.maps.routes.FallbackReason
bibliothèque "routes"

Raisons d'utiliser une réponse de remplacement. Pour en savoir plus, consultez la documentation sur les services Web.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type FallbackReasonString.

const {FallbackReason} = await google.maps.importLibrary("routes");
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. Pour en savoir plus, consultez la documentation sur les services Web.
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. Pour en savoir plus, consultez la documentation sur les services Web.

FallbackRoutingMode

google.maps.routes.FallbackRoutingMode
bibliothèque "routes"

Mode de routage réel utilisé pour la réponse de remplacement renvoyée. Pour en savoir plus, consultez la documentation sur les services Web.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type FallbackRoutingModeString.

const {FallbackRoutingMode} = await google.maps.importLibrary("routes");
TRAFFIC_AWARE Pour en savoir plus, consultez la documentation sur les services Web.
TRAFFIC_UNAWARE Pour en savoir plus, consultez la documentation sur les services Web.

Classe GeocodedWaypoint

classe google.maps.routes.GeocodedWaypoint
bibliothèque "routes"

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.

const {GeocodedWaypoint} = await google.maps.importLibrary("routes");
geocoderStatus
readonly
Type : RPCStatus optional
Indique le code d'état résultant de l'opération de geocoding.
intermediateWaypointRequestIndex
readonly
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
readonly
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
readonly
Type : string
ID de lieu pour ce résultat.
types
readonly
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.
Hérité : toJSON

Classe GeocodingResults

classe google.maps.routes.GeocodingResults
bibliothèque "routes"

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.

const {GeocodingResults} = await google.maps.importLibrary("routes");
destination
readonly
Type : GeocodedWaypoint optional
Point de cheminement géocodé pour la destination.
intermediates
readonly
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
readonly
Type : GeocodedWaypoint optional
Point de cheminement géocodé pour le point de départ.
Hérité : toJSON

Classe MultiModalSegment

classe google.maps.routes.MultiModalSegment
bibliothèque "routes"

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.

const {MultiModalSegment} = await google.maps.importLibrary("routes");
instructions
readonly
Type : string optional
Instructions pour naviguer dans ce segment multimodal.
maneuver
readonly
Type : string optional
La manœuvre de navigation à effectuer à cette étape. Consultez Maneuver pour obtenir la liste des valeurs possibles.
stepEndIndex
readonly
Type : number
L'index RouteLegStep correspondant qui correspond à la fin d'un segment multimodal.
stepStartIndex
readonly
Type : number
Index RouteLegStep correspondant qui correspond au début d'un segment multimodal.
travelMode
readonly
Type : TravelMode optional
Mode de transport utilisé pour ce segment multimodal.
Hérité : toJSON

Classe PolylineDetailInfo

classe google.maps.routes.PolylineDetailInfo
bibliothèque "routes"

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

const {PolylineDetailInfo} = await google.maps.importLibrary("routes");
endIndex
readonly
Type : number optional
Index de fin de cette caractéristique de route dans la polyligne.
presence
readonly
Type : RoadFeatureState optional
Indique si l'élément de route existe le long de la polyligne.
startIndex
readonly
Type : number optional
Index de début de cette caractéristique de route dans la polyligne.
Hérité : toJSON

Classe PolylineDetails

classe google.maps.routes.PolylineDetails
bibliothèque "routes"

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

const {PolylineDetails} = await google.maps.importLibrary("routes");
flyoverInfo
readonly
Détails du survol le long de la polyligne.
narrowRoadInfo
readonly
Détails sur les routes étroites le long de la polyligne.
Hérité : toJSON

Constantes PolylineQuality

google.maps.routes.PolylineQuality
bibliothèque "routes"

Ensemble de valeurs qui spécifient la qualité de la polyligne. Pour en savoir plus, consultez la documentation sur les services Web.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type PolylineQualityString.

const {PolylineQuality} = await google.maps.importLibrary("routes");
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 plus importante. Pour en savoir plus, consultez la documentation sur les services Web.
OVERVIEW Spécifie une polyligne de présentation, composée d'un petit nombre de points. Pour en savoir plus, consultez la documentation sur les services Web.

Constantes ReferenceRoute

google.maps.routes.ReferenceRoute
bibliothèque "routes"

Un itinéraire de référence compatible sur ComputeRoutesRequest. Pour en savoir plus, consultez la documentation sur les services Web.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type ReferenceRouteString.

const {ReferenceRoute} = await google.maps.importLibrary("routes");
FUEL_EFFICIENT Itinéraire économe en carburant. Pour en savoir plus, consultez la documentation sur les services Web.
SHORTER_DISTANCE Itinéraire avec une distance de trajet plus courte. Pour en savoir plus, consultez la documentation sur les services Web.

Constantes RoadFeatureState

google.maps.routes.RoadFeatureState
bibliothèque "routes"

Encapsule les états des caractéristiques de la route le long d'un segment de polyligne. Pour en savoir plus, consultez la documentation sur les services Web.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type RoadFeatureStateString.

const {RoadFeatureState} = await google.maps.importLibrary("routes");
DOES_NOT_EXIST La route n'existe pas. Pour en savoir plus, consultez la documentation sur les services Web.
EXISTS La caractéristique de la route existe. Pour en savoir plus, consultez la documentation sur les services Web.

RouteLabel

google.maps.routes.RouteLabel
bibliothèque "routes"

Pour en savoir plus, consultez la documentation sur les services Web.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type RouteLabelString.

const {RouteLabel} = await google.maps.importLibrary("routes");
DEFAULT_ROUTE "Meilleur" itinéraire par défaut renvoyé pour le calcul de l'itinéraire. Pour en savoir plus, consultez la documentation sur les services Web.
DEFAULT_ROUTE_ALTERNATE Alternative au "meilleur" itinéraire par défaut. Pour en savoir plus, consultez la documentation sur les services Web.
FUEL_EFFICIENT Itinéraire économe en carburant. Pour en savoir plus, consultez la documentation sur les services Web.
SHORTER_DISTANCE Itinéraire avec une distance de trajet plus courte. Pour en savoir plus, consultez la documentation sur les services Web.

Classe RouteLeg

classe google.maps.routes.RouteLeg
bibliothèque "routes"

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

const {RouteLeg} = await google.maps.importLibrary("routes");
distanceMeters
readonly
Type : number
Distance de l'étape de l'itinéraire, en mètres.
durationMillis
readonly
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
readonly
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
readonly
Type : RouteLegLocalizedValues optional
Représentations textuelles des propriétés de RouteLeg.
path
readonly
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
readonly
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
readonly
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
readonly
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
readonly
Tableau d'étapes indiquant les segments de cette étape. Chaque étape représente une instruction de navigation.
stepsOverview
readonly
Type : StepsOverview optional
Présentation des étapes de ce RouteLeg. Ce champ n'est renseigné que pour les routes TRANSIT.
travelAdvisory
readonly
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.
Hérité : toJSON

Classe RouteLegLocalizedValues

classe google.maps.routes.RouteLegLocalizedValues
bibliothèque "routes"

Représentations textuelles de RouteLeg.

const {RouteLegLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
Type : string optional
Distance de l'étape de l'itinéraire, au format texte.
distanceLanguage
readonly
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
readonly
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
readonly
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
readonly
Type : string optional
Durée sans tenir compte des conditions de circulation, représentée sous forme de texte.
staticDurationLanguage
readonly
Type : string optional
Code de langue BCP-47 du texte de durée statique, tel que "en-US" ou "sr-Latn".
Hérité : toJSON

Classe RouteLegStep

classe google.maps.routes.RouteLegStep
bibliothèque "routes"

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.

const {RouteLegStep} = await google.maps.importLibrary("routes");
distanceMeters
readonly
Type : number
Distance de l'étape, en mètres.
endLocation
readonly
Type : DirectionalLocation optional
Emplacement de fin de cette étape.
instructions
readonly
Type : string optional
Instructions pour naviguer dans cette étape.
localizedValues
readonly
Représentations textuelles des propriétés de RouteLegStep.
maneuver
readonly
Type : string optional
La manœuvre de navigation à effectuer à cette étape. Consultez Maneuver pour obtenir la liste des valeurs possibles.
path
readonly
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
readonly
Type : DirectionalLocation optional
Emplacement de départ de cette étape.
staticDurationMillis
readonly
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
readonly
Type : TransitDetails optional
Informations concernant cette étape si le mode de transport est TRANSIT.
travelMode
readonly
Type : TravelMode optional
Mode de transport utilisé pour cette étape.
Hérité : toJSON

Classe RouteLegStepLocalizedValues

classe google.maps.routes.RouteLegStepLocalizedValues
bibliothèque "routes"

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

const {RouteLegStepLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
Type : string optional
Distance de l'étape de l'itinéraire, au format texte.
distanceLanguage
readonly
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
readonly
Type : string optional
Durée sans tenir compte des conditions de circulation, représentée sous forme de texte.
staticDurationLanguage
readonly
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.
Hérité : toJSON

Classe RouteLegTravelAdvisory

classe google.maps.routes.RouteLegTravelAdvisory
bibliothèque "routes"

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

const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes");
speedReadingIntervals
readonly
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
readonly
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 inclut 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.
Hérité : toJSON

Classe RouteLocalizedValues

classe google.maps.routes.RouteLocalizedValues
bibliothèque "routes"

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

const {RouteLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
Type : string optional
Distance de l'itinéraire représentée sous forme de texte.
distanceLanguage
readonly
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
readonly
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
readonly
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
readonly
Type : string optional
Durée sans tenir compte des conditions de circulation, représentée sous forme de texte.
staticDurationLanguage
readonly
Type : string optional
Code de langue BCP-47 du texte de durée statique, tel que "en-US" ou "sr-Latn".
transitFare
readonly
Type : string optional
Tarif de transport en commun représenté sous forme de texte.
transitFareLanguage
readonly
Type : string optional
Code de langue BCP-47 du texte du tarif de transport en commun, tel que "en-US" ou "sr-Latn".
Hérité : toJSON

Interface RouteModifiers

interface google.maps.routes.RouteModifiers

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

avoidFerries
facultatif
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
facultatif
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
facultatif
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
facultatif
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
facultatif
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
facultatif
Type : VehicleInfo optional
Spécifie les informations sur le véhicule.

Interface RoutePolyline3DOptions

interface google.maps.routes.RoutePolyline3DOptions

Options de création de polylignes 3D d'itinéraire.

colorScheme
facultatif
Type : ColorScheme optional
Jeu de couleurs à utiliser pour la polyligne 3D. 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, AlphaRoute.create3DPolylines tente d'utiliser le colorScheme de la carte ou utilise le paramètre système par défaut.
polylineOptions
facultatif
Options permettant de personnaliser le style d'une polyligne 3D.
trafficPolylinesDisabled
facultatif
Type : boolean optional
Indique si les polylignes tenant compte du trafic doivent être désactivées. Les polylignes prenant en compte le trafic ne sont disponibles que lorsque routingPreference est défini sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL.

Interface RoutePolylineDetails

interface google.maps.routes.RoutePolylineDetails

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
facultatif
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
facultatif
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
facultatif
Type : TravelMode optional
Mode de transport 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 d'itinéraire.

colorScheme
facultatif
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
facultatif
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
bibliothèque "routes"

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

const {RouteTravelAdvisory} = await google.maps.importLibrary("routes");
fuelConsumptionMicroliters
readonly
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
readonly
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
readonly
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
readonly
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
readonly
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.
Hérité : toJSON

Constantes RoutingPreference

google.maps.routes.RoutingPreference
bibliothèque "routes"

Ensemble de valeurs qui spécifient les facteurs à prendre en compte lors du calcul de l'itinéraire. Pour en savoir plus, consultez la documentation sur les services Web.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type RoutingPreferenceString.

const {RoutingPreference} = await google.maps.importLibrary("routes");
TRAFFIC_AWARE Calcule des itinéraires en tenant compte des conditions de circulation en temps réel. Pour en savoir plus, consultez la documentation sur les services Web.
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. Pour en savoir plus, consultez la documentation sur les services Web.
TRAFFIC_UNAWARE Calcule les itinéraires sans tenir compte des conditions de circulation en temps réel. Pour en savoir plus, consultez la documentation sur les services Web.

Constantes de vitesse

google.maps.routes.Speed
bibliothèque "routes"

Classification de la vitesse de la polyligne en fonction des données de trafic. Pour en savoir plus, consultez la documentation sur les services Web.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type SpeedString.

const {Speed} = await google.maps.importLibrary("routes");
NORMAL Vitesse normale, pas de ralentissements. Pour en savoir plus, consultez la documentation sur les services Web.
SLOW Ralentissement détecté, trafic moyen. Pour en savoir plus, consultez la documentation sur les services Web.
TRAFFIC_JAM Retards dus à la circulation. Pour en savoir plus, consultez la documentation sur les services Web.

Interface SpeedPath

interface google.maps.routes.SpeedPath

Regroupe les LatLngAltitude d'un intervalle d'itinéraire avec la vitesse de l'intervalle.

path
Chemin couvert par ce chemin de vitesse.
speed
facultatif
Type : Speed optional
La vitesse de lecture du chemin.

Classe SpeedReadingInterval

classe google.maps.routes.SpeedReadingInterval
bibliothèque "routes"

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.

const {SpeedReadingInterval} = await google.maps.importLibrary("routes");
endPolylinePointIndex
readonly
Type : number optional
Index de fin de cet intervalle dans la polyligne.
speed
readonly
Type : Speed optional
Vitesse du trafic pendant cet intervalle.
startPolylinePointIndex
readonly
Type : number optional
Index de début de cet intervalle dans la polyligne.

Classe StepsOverview

classe google.maps.routes.StepsOverview
bibliothèque "routes"

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

const {StepsOverview} = await google.maps.importLibrary("routes");
multiModalSegments
readonly
Informations résumées sur les différents segments multimodaux de RouteLeg.steps.
Hérité : toJSON

Classe TollInfo

classe google.maps.routes.TollInfo
bibliothèque "routes"

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

const {TollInfo} = await google.maps.importLibrary("routes");
estimatedPrices
readonly
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. Ce champ peut être un tableau vide si des péages sont attendus, mais que le prix estimé est inconnu.
Hérité : toJSON

Classe TransitAgency

classe google.maps.routes.TransitAgency
bibliothèque "routes"

Informations sur une agence de transports en commun.

const {TransitAgency} = await google.maps.importLibrary("routes");
name
readonly
Type : string optional
Nom de cette agence de transports en commun.
phoneNumber
readonly
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
readonly
Type : URL optional
URL de l'agence de transports en commun.
Hérité : toJSON

TransitDetails

classe google.maps.routes.TransitDetails
bibliothèque "routes"

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

const {TransitDetails} = await google.maps.importLibrary("routes");
arrivalStop
readonly
Type : TransitStop optional
Informations sur l'arrêt d'arrivée de l'étape.
arrivalTime
readonly
Type : Date optional
Heure d'arrivée prévue pour l'étape.
departureStop
readonly
Type : TransitStop optional
Informations sur l'arrêt de départ de l'étape.
departureTime
readonly
Type : Date optional
Heure de départ estimée pour l'étape.
headsign
readonly
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
readonly
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
readonly
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
readonly
Type : TransitLine optional
Informations sur la ligne de transports en commun utilisée à cette étape.
tripShortText
readonly
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).
Hérité : toJSON

Classe TransitLine

classe google.maps.routes.TransitLine
bibliothèque "routes"

Informations sur une ligne de transports en commun.

const {TransitLine} = await google.maps.importLibrary("routes");
agencies
readonly
L'agence (ou les agences) de transports en commun qui gère cette ligne de transports en commun.
color
readonly
Type : string optional
Couleur couramment utilisée pour désigner cette ligne. Représenté en hexadécimal.
iconURL
readonly
Type : URL optional
URL de l'icône associée à cette ligne.
name
readonly
Type : string optional
Nom complet de la ligne de transports en commun, par exemple "8 Avenue Local".
shortName
readonly
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
readonly
Type : string optional
Couleur couramment utilisée pour le texte sur les panneaux de cette ligne. Représenté en hexadécimal.
url
readonly
Type : URL optional
URL de cette ligne de transports en commun fournie par l'agence de transports en commun.
vehicle
readonly
Type : TransitVehicle optional
Type de véhicule utilisé sur cette ligne de transports en commun.
Hérité : toJSON

TransitPreference interface

interface google.maps.routes.TransitPreference

Préférences pour les itinéraires basés sur TRANSIT qui influencent l'itinéraire renvoyé.

allowedTransitModes
facultatif
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
facultatif
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
bibliothèque "routes"

Informations sur un arrêt de transports en commun.

const {TransitStop} = await google.maps.importLibrary("routes");
location
readonly
Type : DirectionalLocation optional
Emplacement de l'arrêt exprimé en coordonnées de latitude/longitude et un cap facultatif.
name
readonly
Type : string optional
Nom de l'arrêt de transports en commun.
Hérité : toJSON

Classe TransitVehicle

classe google.maps.routes.TransitVehicle
bibliothèque "routes"

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

const {TransitVehicle} = await google.maps.importLibrary("routes");
iconURL
readonly
Type : URL optional
URL d'une icône associée à ce type de véhicule.
localIconURL
readonly
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
readonly
Type : string optional
Nom de ce véhicule, en majuscules.
nameLanguage
readonly
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
readonly
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.
Hérité : toJSON

Constantes VehicleEmissionType

google.maps.routes.VehicleEmissionType
bibliothèque "routes"

Ensemble de valeurs décrivant le type d'émissions du véhicule. Pour en savoir plus, consultez la documentation sur les services Web.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type VehicleEmissionTypeString.

const {VehicleEmissionType} = await google.maps.importLibrary("routes");
DIESEL Véhicule diesel. Pour en savoir plus, consultez la documentation sur les services Web.
ELECTRIC Véhicule électrique. Pour en savoir plus, consultez la documentation sur les services Web.
GASOLINE Véhicule à essence. Pour en savoir plus, consultez la documentation sur les services Web.
HYBRID Véhicule à carburant hybride (essence et électricité, par exemple). Pour en savoir plus, consultez la documentation sur les services Web.

Interface VehicleInfo

interface google.maps.routes.VehicleInfo

Contient les informations sur le véhicule, telles que son type d'émission.

emissionType
facultatif
Type : VehicleEmissionType optional
Décrit le type d'émission du véhicule. S'applique uniquement au mode de transport DRIVING.

Waypoint

interface google.maps.routes.Waypoint

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
facultatif
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
facultatif
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
facultatif
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

interface google.maps.routes.WaypointMarkerDetails

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
facultatif
Type : RouteLeg optional
Étape à laquelle appartient le repère. Vide si l'itinéraire ne comporte aucune étape.