Directions

DirectionsService class

Classe google.maps.DirectionsService

Service permettant de calculer des itinéraires entre deux lieux ou plus.

Accédez-y en appelant le const {DirectionsService} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
DirectionsService
DirectionsService()
Paramètres : aucun
Crée une instance de DirectionsService qui envoie des requêtes d'itinéraire aux serveurs Google.
route
route(request[, callback])
Paramètres :
Valeur renvoyée : Promise<DirectionsResult>
Envoyez une demande de recherche d'itinéraire.

Interface DirectionsRequest

Interface google.maps.DirectionsRequest

Requête d'itinéraire à envoyer à DirectionsService.
destination
Type : string|LatLng|Place|LatLngLiteral
Emplacement de la destination. Il peut s'agir d'une chaîne à géocoder, d'un LatLng ou d'un Place. Obligatoire.
origin
Type : string|LatLng|Place|LatLngLiteral
Lieu d'origine. Il peut s'agir d'une chaîne à géocoder, d'un LatLng ou d'un Place. Obligatoire.
travelMode
Type : TravelMode
Type de routage demandé. Obligatoire.
avoidFerries optional
Type : boolean optional
Si la valeur est true, le service Directions est invité à éviter les ferries dans la mesure du possible. Facultatif.
avoidHighways optional
Type : boolean optional
Si la valeur est true, le service Directions est invité à éviter les autoroutes dans la mesure du possible. Facultatif.
avoidTolls optional
Type : boolean optional
Si la valeur est true, le service Directions est invité à éviter les routes à péage dans la mesure du possible. Facultatif.
drivingOptions optional
Type : DrivingOptions optional
Paramètres qui ne s'appliquent qu'aux requêtes où travelMode est défini sur DRIVING. Cet objet n'aura aucun effet pour les autres modes de déplacement.
language optional
Type : string optional
Identifiant de la langue dans laquelle les résultats doivent être renvoyés, si possible. Consultez la liste des langues disponibles.
optimizeWaypoints optional
Type : boolean optional
Si la valeur est définie sur true, DirectionsService tente de réorganiser les points de chemin intermédiaires fournis pour minimiser le coût global de l'itinéraire. Si les points de cheminement sont optimisés, inspectez DirectionsRoute.waypoint_order dans la réponse pour déterminer le nouvel ordre.
provideRouteAlternatives optional
Type : boolean optional
Indique si des itinéraires alternatifs doivent être fournis. Facultatif.
region optional
Type : string optional
Code de région utilisé comme biais pour les demandes de géocodage. Le code régional accepte une valeur ccTLD ("domaine de premier niveau") à deux caractères. La plupart des codes ccTLD sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD du Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord").
transitOptions optional
Type : TransitOptions optional
Paramètres qui s'appliquent uniquement aux requêtes où travelMode est TRANSIT. Cet objet n'aura aucun effet pour les autres modes de déplacement.
unitSystem optional
Type : UnitSystem optional
Par défaut : système d'unités utilisé dans le pays d'origine.
Système d'unités préféré à utiliser pour afficher les distances.
waypoints optional
Type : Array<DirectionsWaypoint> optional
Tableau de points de cheminement intermédiaires. Les itinéraires sont calculés du point de départ à la destination en passant par chaque point de repère de ce tableau. Pour connaître le nombre maximal de points de cheminement autorisés, consultez le guide du développeur. Les points de cheminement ne sont pas pris en charge pour les itinéraires en transports en commun. Facultatif.

Constantes DirectionsStatus

google.maps.DirectionsStatus constantes

État renvoyé par DirectionsService à la fin d'un appel à route(). Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple : 'OK' ou google.maps.DirectionsStatus.OK.

Accédez-y en appelant le const {DirectionsStatus} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
INVALID_REQUEST Le DirectionsRequest fourni n'est pas valide.
MAX_WAYPOINTS_EXCEEDED Trop de DirectionsWaypoint ont été fournis dans DirectionsRequest. Pour connaître le nombre maximal de points de cheminement autorisés, consultez le guide du développeur.
NOT_FOUND Au moins un des points de départ, des destinations ou des points de cheminement n'a pas pu être géocodé.
OK La réponse contient un DirectionsResult valide.
OVER_QUERY_LIMIT La page Web a dépassé la limite de requêtes sur une période trop courte.
REQUEST_DENIED La page Web n'est pas autorisée à utiliser le service Directions.
UNKNOWN_ERROR Une requête d'itinéraire n'a pas pu être traitée en raison d'une erreur du serveur. Si vous essayez à nouveau, la requête pourrait aboutir.
ZERO_RESULTS Aucun itinéraire n'a pu être identifié entre le point de départ et la destination.

Interface DirectionsResult

Interface google.maps.DirectionsResult

Réponse d'itinéraire récupérée à partir du serveur d'itinéraires. Vous pouvez les afficher à l'aide d'un DirectionsRenderer ou analyser cet objet et l'afficher vous-même. Vous devez afficher les avertissements et les mentions de droits d'auteur indiqués dans les Conditions d'utilisation de Google Maps Platform. Notez que, bien que ce résultat soit "de type JSON", il n'est pas strictement au format JSON, car il inclut indirectement des objets LatLng.
request
DirectionsRequest ayant généré ce résultat.
routes
Tableau de DirectionsRoute, chacun contenant des informations sur les sections et les étapes qui le composent. Il n'y aura qu'un seul itinéraire, sauf si DirectionsRequest a été créé avec provideRouteAlternatives défini sur true.
available_travel_modes optional
Type : Array<TravelMode> optional
Contient un tableau des modes de transport disponibles. Ce champ est renvoyé lorsqu'une requête spécifie un mode de transport et n'obtient aucun résultat. Le tableau contient les modes de transport disponibles dans les pays de l'ensemble donné de points de cheminement. Ce champ n'est pas renvoyé si un ou plusieurs points de cheminement sont des points de cheminement intermédiaires.
geocoded_waypoints optional
Tableau de DirectionsGeocodedWaypoint, chacun contenant des informations sur le geocoding du point de départ, de la destination et des points de cheminement.

Classe DirectionsRenderer

Classe google.maps.DirectionsRenderer

Affiche les itinéraires obtenus à partir de DirectionsService.

Cette classe étend MVCObject.

Accédez-y en appelant le const {DirectionsRenderer} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
DirectionsRenderer
DirectionsRenderer([opts])
Paramètres :
Crée le moteur de rendu avec les options données. Les itinéraires peuvent être affichés sur une carte (sous forme de superpositions visuelles) ou, en plus, sur un panneau <div> (sous forme d'instructions textuelles).
getDirections
getDirections()
Paramètres : aucun
Valeur renvoyée : DirectionsResult
Renvoie l'ensemble actuel d'instructions du moteur de rendu.
getMap
getMap()
Paramètres : aucun
Valeur renvoyée : Map
Renvoie la carte sur laquelle la DirectionsResult est affichée.
getPanel
getPanel()
Paramètres : aucun
Valeur renvoyée : HTMLElement|null
Renvoie le panneau <div> dans lequel le DirectionsResult est affiché.
getRouteIndex
getRouteIndex()
Paramètres : aucun
Valeur renvoyée : number
Renvoie l'index de route actuel (base zéro) utilisé par cet objet DirectionsRenderer.
setDirections
setDirections(directions)
Paramètres :
Valeur renvoyée : aucune
Définissez le rendu pour qu'il utilise le résultat de DirectionsService. Si vous définissez un ensemble d'instructions valide de cette manière, les instructions s'affichent sur la carte et dans le panneau désignés du moteur de rendu.
setMap
setMap(map)
Paramètres :
Valeur renvoyée : aucune
Cette méthode spécifie la carte sur laquelle les itinéraires seront affichés. Transmettez null pour supprimer l'itinéraire de la carte.
setOptions
setOptions(options)
Paramètres :
Valeur renvoyée : aucune
Modifiez les paramètres d'options de ce DirectionsRenderer après l'initialisation.
setPanel
setPanel(panel)
Paramètres :
Valeur renvoyée : aucune
Cette méthode affiche l'itinéraire dans un <div>. Transmettez null pour supprimer le contenu du panneau.
setRouteIndex
setRouteIndex(routeIndex)
Paramètres :
  • routeIndex : number
Valeur renvoyée : aucune
Définissez l'index (basé sur zéro) de l'itinéraire dans l'objet DirectionsResult à afficher. Par défaut, la première route du tableau est affichée.
Hérité : addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
Arguments : aucun
Cet événement est déclenché lorsque les instructions rendues changent, soit lorsqu'un nouvel DirectionsResult est défini, soit lorsque l'utilisateur a fini de faire glisser un changement dans le chemin des instructions.

Interface DirectionsRendererOptions

Interface google.maps.DirectionsRendererOptions

Cet objet définit les propriétés qui peuvent être définies sur un objet DirectionsRenderer.
directions optional
Type : DirectionsResult optional
Itinéraire à afficher sur la carte et/ou dans un panneau <div>, récupéré en tant qu'objet DirectionsResult à partir de DirectionsService.
draggable optional
Type : boolean optional
Si la valeur est true, l'utilisateur peut faire glisser et modifier les chemins des itinéraires affichés par ce DirectionsRenderer.
hideRouteList optional
Type : boolean optional
Par défaut : false
Cette propriété indique si le moteur de rendu doit fournir une liste d'itinéraires sélectionnables par l'utilisateur, affichée dans le panneau d'instructions.
infoWindow optional
Type : InfoWindow optional
Le InfoWindow dans lequel afficher les informations textuelles lorsqu'un repère est sélectionné. Le contenu existant de la fenêtre d'informations sera écrasé et sa position sera modifiée. Si aucune fenêtre d'informations n'est spécifiée, DirectionsRenderer crée et utilise sa propre fenêtre d'informations. Cette propriété sera ignorée si suppressInfoWindows est défini sur true.
map optional
Type : Map optional
Carte sur laquelle afficher l'itinéraire.
markerOptions optional
Type : MarkerOptions optional
Options pour les repères. Toutes les balises affichées par DirectionsRenderer utiliseront ces options.
panel optional
Type : HTMLElement optional
Le <div> dans lequel afficher les étapes de l'itinéraire.
polylineOptions optional
Type : PolylineOptions optional
Options pour les polylignes. Toutes les polylignes affichées par DirectionsRenderer utiliseront ces options.
preserveViewport optional
Type : boolean optional
Par défaut : false
Si cette option est définie sur true ou si le centre et le niveau de zoom de la carte n'ont jamais été définis, la carte d'entrée est centrée et zoomée sur le cadre de délimitation de cet ensemble d'instructions.
routeIndex optional
Type : number optional
Index de l'itinéraire dans l'objet DirectionsResult. La valeur par défaut est 0.
suppressBicyclingLayer optional
Type : boolean optional
Supprime l'affichage de BicyclingLayer lorsque des itinéraires à vélo sont demandés.
suppressInfoWindows optional
Type : boolean optional
Empêche l'affichage des fenêtres d'informations.
suppressMarkers optional
Type : boolean optional
Supprimez le rendu des repères.
suppressPolylines optional
Type : boolean optional
Supprimez le rendu des polylignes.

Interface DirectionsWaypoint

Interface google.maps.DirectionsWaypoint

Un DirectionsWaypoint représente un lieu entre le point de départ et la destination par lequel le trajet doit passer.
location optional
Type : string|LatLng|LatLngLiteral|Place optional
Emplacement du point de cheminement. Il peut s'agir d'une chaîne d'adresse, d'un LatLng ou d'un Place. Facultatif.
stopover optional
Type : boolean optional
Par défaut : true
Si la valeur est true, cela indique que ce point de cheminement est un arrêt entre le point de départ et la destination. L'itinéraire est alors divisé en deux étapes. Si la valeur est false, cela indique que l'itinéraire doit être orienté pour passer par ce point de cheminement, mais sans être divisé en deux étapes. Cela peut être utile si vous souhaitez créer un itinéraire en réponse à l'utilisateur qui fait glisser des waypoints sur une carte.

Interface DirectionsGeocodedWaypoint

Interface google.maps.DirectionsGeocodedWaypoint

Point de cheminement géocodé unique.
partial_match optional
Type : boolean optional
Indique si le geocoder n'a pas renvoyé de correspondance exacte pour le point de repère d'origine, bien qu'il ait pu trouver une partie de l'adresse demandée.
place_id optional
Type : string optional
ID de lieu associé au point de repère. Les ID de lieu identifient de façon unique un lieu dans la base de données Google Places et sur Google Maps. Pour en savoir plus sur les ID de lieux, consultez le guide du développeur de l'API Places.
types optional
Type : Array<string> optional
Tableau de chaînes indiquant le type de l'élément géocodé renvoyé. Pour obtenir la liste des chaînes possibles, consultez la section Types de composants d'adresse du guide du développeur.

Interface DirectionsRoute

Interface google.maps.DirectionsRoute

Un seul itinéraire contenant un ensemble de sections dans un DirectionsResult. Notez que, bien que cet objet soit "de type JSON", il n'est pas strictement JSON, car il inclut directement et indirectement des objets LatLng.
bounds
Type : LatLngBounds
Limites de cet itinéraire.
copyrights
Type : string
Texte sur les droits d'auteur à afficher pour cet itinéraire.
legs
Tableau de DirectionsLeg, chacun contenant des informations sur les étapes qui le composent. Une section est présente pour chaque point de cheminement ou destination spécifié. Un itinéraire sans point de cheminement avec arrêt contient un DirectionsLeg, tandis qu'un itinéraire avec un point de cheminement avec arrêt en contient deux.
overview_path
Type : Array<LatLng>
Tableau de LatLng représentant l'intégralité du tracé de cet itinéraire. Le chemin est simplifié pour être adapté aux contextes où un petit nombre de sommets est requis (comme les URL de l'API Static Maps).
overview_polyline
Type : string
Une représentation de l'itinéraire sous forme de polyligne encodée dans overview_path. Cette polyligne est un tracé approximatif (lissé) de l'itinéraire obtenu.
summary
Type : string
Contient une brève description textuelle de l'itinéraire, permettant de le nommer et de le distinguer des autres itinéraires.
warnings
Type : Array<string>
Avertissements à afficher lors de l'affichage de cet itinéraire.
waypoint_order
Type : Array<number>
Si optimizeWaypoints a été défini sur true, ce champ contiendra la permutation réorganisée des points de cheminement d'entrée. Par exemple, si l'entrée était :
  Origin: Los Angeles
  Waypoints: Dallas, Bangor, Phoenix
  Destination: New York
et que la sortie optimisée était ordonnée comme suit :
  Origin: Los Angeles
  Waypoints: Phoenix, Dallas, Bangor
  Destination: New York
, ce champ sera un Array contenant les valeurs [2, 0, 1]. Notez que la numérotation des points de repère est basée sur zéro.
 Si l'un des points de cheminement d'entrée est défini sur false pour stopover, ce champ sera vide, car l'optimisation de l'itinéraire n'est pas disponible pour de telles requêtes.
fare optional
Type : TransitFare optional
Tarif total pour l'ensemble du trajet en transports en commun. Uniquement applicable aux demandes de transport en commun.

Interface DirectionsLeg

Interface google.maps.DirectionsLeg

Une seule étape composée d'un ensemble d'étapes dans un DirectionsResult. Il est possible que certains champs de la section "étape" ne soient pas renvoyés pour toutes les demandes. Notez que, bien que ce résultat soit "de type JSON", il n'est pas strictement au format JSON, car il inclut directement et indirectement des objets LatLng.
end_address
Type : string
Adresse de la destination de cette section. Ce contenu est destiné à être lu tel quel. N'analysez pas l'adresse formatée de manière programmatique.
end_location
Type : LatLng
DirectionsService calcule l'itinéraire entre deux lieux à l'aide de l'option de transport la plus proche des points de départ et d'arrivée (il s'agit généralement d'une route). end_location indique la destination géocodée réelle, qui peut être différente de end_location de la dernière étape si, par exemple, la route n'est pas à proximité de la destination de cette étape.
start_address
Type : string
Adresse du point de départ de cette section. Ce contenu est destiné à être lu tel quel. N'analysez pas l'adresse formatée de manière programmatique.
start_location
Type : LatLng
DirectionsService calcule l'itinéraire entre deux lieux à l'aide de l'option de transport la plus proche des points de départ et d'arrivée (il s'agit généralement d'une route). start_location indique le point de départ géocodé réel, qui peut être différent du start_location de la première étape si, par exemple, la route n'est pas à proximité du point de départ de cette section.
steps
Tableau de DirectionsStep, chacun contenant des informations sur les étapes individuelles de cette section.
traffic_speed_entry
Type : Array<*>
Informations sur la vitesse du trafic sur le tronçon.
via_waypoints
Type : Array<LatLng>
Tableau de points de repère sans arrêt le long de cette étape, spécifiés dans la requête d'origine.

Obsolète dans les itinéraires alternatifs. La version 3.27 sera la dernière version de l'API qui ajoute des via_waypoints supplémentaires dans les itinéraires alternatifs.

Lorsque vous utilisez le service Directions pour implémenter des itinéraires déplaçables, il est recommandé de désactiver le déplacement des itinéraires alternatifs. Seul l'itinéraire principal doit être déplaçable. Les utilisateurs peuvent déplacer l'itinéraire principal jusqu'à ce qu'il corresponde à un itinéraire alternatif.
arrival_time optional
Type : Time optional
Heure d'arrivée estimée pour cette section. Ne s'applique qu'aux requêtes TRANSIT.
departure_time optional
Type : Time optional
Heure de départ estimée pour cette section. Ne s'applique qu'aux requêtes TRANSIT.
distance optional
Type : Distance optional
Distance totale parcourue par cette étape. Cette propriété peut être non définie, car la distance peut être inconnue.
duration optional
Type : Duration optional
Durée totale de cette section. Cette propriété peut être undefined, car la durée peut être inconnue.
duration_in_traffic optional
Type : Duration optional
Durée totale de cette section, en tenant compte des conditions de circulation indiquées par la propriété trafficModel. Cette propriété peut être undefined, car la durée peut être inconnue.

Interface DirectionsStep

Interface google.maps.DirectionsStep

Un seul DirectionsStep dans un DirectionsResult. Certains champs peuvent être undefined. Notez que, bien que cet objet soit "de type JSON", il n'est pas strictement JSON, car il inclut directement des objets LatLng.
encoded_lat_lngs
Type : string
Représentation de l'étape sous forme de polyligne encodée. Il s'agit d'un tracé approximatif (lissé) de l'étape.
end_location
Type : LatLng
Point d'arrivée de cette étape.
end_point
Type : LatLng
Point d'arrivée de cette étape.
instructions
Type : string
Instructions pour cette étape.
lat_lngs
Type : Array<LatLng>
Séquence de LatLng décrivant le tracé de cette étape. Il s'agit d'un tracé approximatif (lissé) de l'étape.
maneuver
Type : string
Contient l'action à effectuer pour l'étape en cours (turn-left, merge, straight, etc.). Les valeurs peuvent être modifiées, et de nouvelles valeurs peuvent être ajoutées sans préavis.
path
Type : Array<LatLng>
Séquence de LatLng décrivant le tracé de cette étape. Il s'agit d'un tracé approximatif (lissé) de l'étape.
start_location
Type : LatLng
Point de départ de cette étape.
start_point
Type : LatLng
Point de départ de cette étape.
travel_mode
Type : TravelMode
Mode de déplacement utilisé à cette étape.
distance optional
Type : Distance optional
Distance parcourue lors de cette étape. Cette propriété peut être undefined, car la distance peut être inconnue.
duration optional
Type : Duration optional
Temps généralement nécessaire pour effectuer cette étape, en secondes et au format texte. Cette propriété peut être undefined, car la durée peut être inconnue.
polyline optional
Type : DirectionsPolyline optional
Contient un objet avec une seule propriété, "points", qui contient une représentation de l'étape sous forme de polyligne encodée. Cette polyligne est un tracé approximatif (lissé) de l'étape.
steps optional
Type : Array<DirectionsStep> optional
Sous-étapes de cette étape. Spécifié pour les sections non liées aux transports en commun des itinéraires de transports en commun.
transit optional
Type : TransitDetails optional
Détails spécifiques au transport en commun pour cette étape. Cette propriété ne sera pas définie, sauf si le mode de déplacement de cette étape est TRANSIT.
transit_details optional
Type : TransitDetails optional
Informations concernant cette étape si le mode de déplacement est TRANSIT.

Interface DirectionsPolyline

Interface google.maps.DirectionsPolyline

Objet contenant une propriété points pour décrire la polyligne d'un DirectionsStep.
points
Type : string
Une polyline encodée.

Interface Place

Interface google.maps.Place

Contient les informations nécessaires pour localiser, identifier ou décrire un lieu pour un DirectionsRequest ou un DistanceMatrixRequest. Dans ce contexte, le terme "lieu" désigne un établissement, un point d'intérêt ou un emplacement géographique. Pour récupérer des informations sur un lieu, consultez PlacesService.
location optional
Type : LatLng|LatLngLiteral optional
Le LatLng de l'entité décrite par ce lieu.
placeId optional
Type : string optional
ID du lieu (établissement ou point d'intérêt, par exemple). L'ID de lieu est un identifiant unique d'un lieu dans la base de données Google Maps. Notez que le placeId est le moyen le plus précis d'identifier un lieu. Si possible, vous devez spécifier le placeId plutôt qu'un query. Un ID de lieu peut être récupéré à partir de n'importe quelle requête envoyée à l'API Places, comme une TextSearch. Vous pouvez également obtenir des ID de lieu à partir de requêtes envoyées à l'API Geocoding. Pour en savoir plus, consultez la présentation des ID de lieu.
query optional
Type : string optional
Requête de recherche décrivant le lieu (comme un établissement ou un point d'intérêt). Exemple de requête : "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW". Si possible, vous devez spécifier le placeId plutôt qu'un query. L'API ne garantit pas la précision de la résolution de la chaîne de requête en un lieu. Si les deux fichiers placeId et query sont fournis, une erreur se produit.

Constantes TravelMode

google.maps.TravelMode constantes

Modes de transport valides pouvant être spécifiés dans un DirectionsRequest, ainsi que les modes de transport renvoyés dans un DirectionsStep. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple : 'BICYCLING' ou google.maps.TravelMode.BICYCLING.

Accédez-y en appelant le const {TravelMode} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
BICYCLING Spécifie une demande d'itinéraire à vélo.
DRIVING Spécifie une requête d'itinéraire.
TRANSIT Spécifie une demande d'itinéraires en transports en commun.
WALKING Spécifie une demande d'itinéraire à pied.

Interface DrivingOptions

Interface google.maps.DrivingOptions

Configure DirectionsRequest lorsque le mode de déplacement est défini sur DRIVING.
departureTime
Type : Date
Heure de départ souhaitée pour l'itinéraire, spécifiée en tant qu'objet Date. L'objet Date mesure le temps en millisecondes depuis le 1er janvier 1970. Cette valeur doit être spécifiée pour qu'un DrivingOptions soit valide. L'heure de départ doit être définie sur l'heure actuelle ou sur une heure ultérieure. mais pas sur une heure passée.
trafficModel optional
Type : TrafficModel optional
Hypothèse à privilégier pour prédire la durée du trajet dans le trafic. La valeur par défaut est BEST_GUESS.

Constantes TrafficModel

google.maps.TrafficModel constantes

Hypothèses à utiliser pour prédire la durée dans le trafic. Spécifié dans un DirectionsRequest ou un DistanceMatrixRequest. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple : 'bestguess' ou google.maps.TrafficModel.BEST_GUESS.

Accédez-y en appelant le const {TrafficModel} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
BEST_GUESS Utilisez les données historiques sur le trafic pour estimer au mieux le temps passé dans les embouteillages.
OPTIMISTIC Utilisez les données historiques sur le trafic pour faire une estimation optimiste de la durée du trajet dans le trafic.
PESSIMISTIC Utilisez les données historiques sur le trafic pour faire une estimation pessimiste de la durée du trajet avec le trafic.

Interface TransitOptions

Interface google.maps.TransitOptions

Objet TransitOptions à inclure dans un DirectionsRequest lorsque le mode de déplacement est défini sur TRANSIT.
arrivalTime optional
Type : Date optional
Heure d'arrivée souhaitée pour l'itinéraire, spécifiée en tant qu'objet Date. L'objet Date mesure le temps en millisecondes depuis le 1er janvier 1970. Si l'heure d'arrivée est spécifiée, l'heure de départ est ignorée.
departureTime optional
Type : Date optional
Heure de départ souhaitée pour l'itinéraire, spécifiée en tant qu'objet Date. L'objet Date mesure le temps en millisecondes depuis le 1er janvier 1970. Si vous ne spécifiez pas d'heure de départ ni d'heure d'arrivée, l'heure est considérée comme "maintenant".
modes optional
Type : Array<TransitMode> optional
Un ou plusieurs modes de transport préférés, comme le bus ou le train. Si aucune préférence n'est indiquée, l'API renvoie le meilleur itinéraire par défaut.
routingPreference optional
Type : TransitRoutePreference optional
Préférence qui peut influencer le choix de l'itinéraire en transports en commun, par exemple "Le moins de marche à pied". Si aucune préférence n'est indiquée, l'API renvoie le meilleur itinéraire par défaut.

Constantes TransitMode

google.maps.TransitMode constantes

Mode de transport en commun valide (par exemple, bus) pouvant être spécifié dans un TransitOptions. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple : 'BUS' ou google.maps.TransitMode.BUS.

Accédez-y en appelant le const {TransitMode} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
BUS Spécifie le bus comme mode de transport à privilégier.
RAIL Spécifie le train comme mode de transport à privilégier.
SUBWAY Spécifie le métro comme mode de transport à privilégier.
TRAIN Spécifie le train comme mode de transport à privilégier.
TRAM Spécifie le tramway comme mode de transport à privilégier.

Constantes TransitRoutePreference

google.maps.TransitRoutePreference constantes

Type de ligne de transport en commun valide pouvant être spécifié dans un TransitOptions. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple : 'LESS_WALKING' ou google.maps.TransitRoutePreference.LESS_WALKING.

Accédez-y en appelant le const {TransitRoutePreference} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
FEWER_TRANSFERS Indique que l'itinéraire calculé doit utiliser un nombre limité de correspondances.
LESS_WALKING Indique que l'itinéraire calculé doit limiter le plus possible la marche.

Interface TransitFare

Interface google.maps.TransitFare

Tarif DirectionsRoute composé d'une valeur et d'une devise.
currency
Type : string
Code de devise ISO 4217 indiquant la devise dans laquelle le tarif est exprimé.
text
Type : string
Valeur du tarif, exprimée sous forme de chaîne dans la currency donnée.
value
Type : number
Valeur numérique du tarif, exprimée dans la currency donnée.

Interface TransitDetails

Interface google.maps.TransitDetails

Détails sur le départ, l'arrivée et le mode de transport utilisé à cette étape.
arrival_stop
Type : TransitStop
Arrêt d'arrivée de cette étape de transport en commun.
arrival_time
Type : Time
Heure d'arrivée de cette étape, spécifiée en tant qu'objet Time.
departure_stop
Type : TransitStop
Arrêt de départ de cette étape de transport en commun.
departure_time
Type : Time
Heure de départ de cette étape, spécifiée en tant qu'objet Time.
headsign
Type : string
Sens du trajet sur cette ligne tel qu'indiqué sur le véhicule ou à l'arrêt de départ.
headway
Type : number
Nombre de secondes estimé entre deux véhicules équivalents à cet arrêt.
line
Type : TransitLine
Informations sur la ligne de transports en commun utilisée à cette étape.
num_stops
Type : number
Nombre d'arrêts pour cette étape. L'arrêt d'arrivée est inclus, mais pas celui de départ.
trip_short_name
Type : string
Texte qui apparaît sur les tableaux d'horaires et les panneaux d'affichage afin de permettre aux passagers d'identifier leur trajet. Ce champ indique par exemple les numéros des lignes régulières pour les usagers qui se rendent à leur travail. Le texte identifie de manière unique un trajet au cours d'une journée de service.

Interface TransitStop

Interface google.maps.TransitStop

Informations sur un arrêt ou une station de transports en commun.
location
Type : LatLng
Emplacement de cet arrêt.
name
Type : string
Nom de cet arrêt de transports en commun.

Interface TransitLine

Interface google.maps.TransitLine

Informations sur la ligne de transports en commun qui effectue cette étape.
agencies
Agence de transports en commun qui exploite cette ligne.
color
Type : string
Couleur couramment utilisée pour désigner cette ligne de transport en commun, représentée sous forme de chaîne hexadécimale.
icon
Type : string
URL d'une icône associée à cette ligne.
name
Type : string
Nom complet de la ligne de transports en commun (par exemple, "8th Avenue Local").
short_name
Type : string
Nom court de cette ligne de transports en commun (par exemple, "E").
text_color
Type : string
Couleur du texte généralement utilisée pour désigner cette ligne de transport en commun, représentée sous forme de chaîne hexadécimale.
url
Type : string
URL de l'agence spécifique à cette ligne de transports en commun.
vehicle
Type de véhicule utilisé (train ou bus, par exemple).

Interface TransitAgency

Interface google.maps.TransitAgency

Informations sur une agence qui gère une ligne de transport en commun.
name
Type : string
Nom de cette agence de transports en commun.
phone
Type : string
Numéro de téléphone de l'agence de transports en commun.
url
Type : string
URL de l'agence de transports en commun.

Interface TransitVehicle

Interface google.maps.TransitVehicle

Informations sur le véhicule qui circule sur une ligne de transports en commun.
icon
Type : string
URL d'une icône correspondant au type de véhicule utilisé sur cette ligne.
local_icon
Type : string
URL d'une icône correspondant au type de véhicule utilisé dans cette région au lieu de l'icône plus générale.
name
Type : string
Nom de ce type de TransitVehicle (par exemple, "Train" ou "Bus").
type
Type : VehicleType
Le type de véhicule utilisé, par exemple un train, un bus ou un ferry.

Constantes VehicleType

google.maps.VehicleType constantes

Valeurs possibles pour les types de véhicules.

Accédez-y en appelant le const {VehicleType} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
BUS Bus.
CABLE_CAR Véhicule tracté par un câble, généralement en surface. Les téléphériques peuvent être de type GONDOLA_LIFT.
COMMUTER_TRAIN Train de banlieue.
FERRY Ferry.
FUNICULAR Véhicule tracté par un câble le long d'une pente prononcée.
GONDOLA_LIFT Téléphérique.
HEAVY_RAIL Métro.
HIGH_SPEED_TRAIN Train à grande vitesse.
INTERCITY_BUS Bus interurbain.
METRO_RAIL Métro léger.
MONORAIL Monorail.
OTHER Autres véhicules
RAIL Train.
SHARE_TAXI Type de bus pouvant faire monter et descendre des passagers n'importe où sur son trajet. Les taxis collectifs utilisent généralement des minibus.
SUBWAY Métro léger souterrain.
TRAM Métro léger en surface.
TROLLEYBUS Trolleybus.

Constantes UnitSystem

google.maps.UnitSystem constantes

Systèmes d'unités valides pouvant être spécifiés dans un DirectionsRequest.

Accédez-y en appelant le const {UnitSystem} = await google.maps.importLibrary("core").
 Consultez Bibliothèques de l'API Maps JavaScript.
IMPERIAL Indique que les distances dans DirectionsResult doivent être exprimées en unités impériales.
METRIC Indique que les distances dans DirectionsResult doivent être exprimées en unités métriques.

Interface Distance

Interface google.maps.Distance

Représentation de la distance sous forme de valeur numérique et de chaîne d'affichage.
text
Type : string
Représentation sous forme de chaîne de la valeur de la distance, à l'aide de UnitSystem spécifié dans la requête.
value
Type : number
Distance en mètres.

Interface Duration

Interface google.maps.Duration

Représentation de la durée sous forme de valeur numérique et de chaîne d'affichage.
text
Type : string
Représentation sous forme de chaîne de la valeur de la durée.
value
Type : number
Durée en secondes.

Interface Time

Interface google.maps.Time

Représentation de l'heure sous forme d'objet Date, de chaîne localisée et de fuseau horaire.
text
Type : string
Chaîne représentant la valeur de l'heure. L'heure est affichée dans le fuseau horaire de l'arrêt du transport en commun.
time_zone
Type : string
Fuseau horaire dans lequel se trouve cet arrêt. La valeur correspond au nom du fuseau horaire, tel que défini dans la base de données des fuseaux horaires de l'IANA (par exemple, "America/New_York").
value
Type : Date
Heure de départ ou d'arrivée, spécifiée en tant qu'objet JavaScript Date.

Constantes DirectionsTravelMode

google.maps.DirectionsTravelMode constantes

Constantes DirectionsUnitSystem

google.maps.DirectionsUnitSystem constantes