Classe DirectionsService
Classe google.maps.DirectionsService
Service permettant de calculer des itinéraires entre deux lieux ou plus.
Accès en appelant const {DirectionsService} = await google.maps.importLibrary("routes")
. Consultez la section Bibliothèques dans l'API Maps JavaScript.
Constructeur | |
---|---|
DirectionsService |
DirectionsService() Paramètres:aucun
Crée une instance de DirectionsService qui envoie des requêtes d'itinéraire aux serveurs Google. |
Méthodes | |
---|---|
route |
route(request[, callback]) Paramètres:
Valeur renvoyée:
Promise<DirectionsResult> Émettez une requête de recherche d'itinéraire. |
Interface DirectionsRequest
Interface google.maps.DirectionsRequest
Requête d'itinéraire à envoyer au DirectionsService
.
Propriétés | |
---|---|
destination |
Type:
string|LatLng|Place|LatLngLiteral Emplacement de la destination. Elle peut être spécifiée en tant que chaîne à géocoder, LatLng ou Place . Obligatoire. |
origin |
Type:
string|LatLng|Place|LatLngLiteral Lieu d'origine. Elle peut être spécifiée en tant que chaîne à géocoder, LatLng ou Place . Obligatoire. |
travelMode |
Type:
TravelMode Type de routage demandé. Obligatoire. |
avoidFerries optional |
Type:
boolean optional Si la valeur est true , indique au service Directions d'éviter les ferries dans la mesure du possible. Facultatif. |
avoidHighways optional |
Type:
boolean optional Si la valeur est true , indique au service Directions d'éviter les autoroutes dans la mesure du possible. Facultatif. |
avoidTolls optional |
Type:
boolean optional Si la valeur est true , indique au service Directions d'éviter les routes à péage dans la mesure du possible. Facultatif. |
drivingOptions optional |
Type:
DrivingOptions optional Paramètres qui ne s'appliquent qu'aux demandes pour lesquelles travelMode est défini sur DRIVING . Cet objet n'a aucun effet pour les autres modes de transport. |
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 true , DirectionsService tente de réorganiser les points de cheminement intermédiaires fournis afin de réduire le coût global de l'itinéraire. Si les points de cheminement sont optimisés, examinez 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 régional utilisé comme biais pour les requêtes de geocoding. Le code de région accepte une valeur à deux caractères ccTLD ("domaine de premier niveau"). 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 ) alors 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 ne s'appliquent qu'aux requêtes pour lesquelles travelMode correspond à TRANSIT. Cet objet n'a aucun effet pour les autres modes de transport. |
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 pour chaque point de cheminement de ce tableau. Consultez le guide du développeur pour connaître le nombre maximal de points de cheminement autorisés. Les points de cheminement ne sont pas pris en charge pour les itinéraires en transports en commun. Facultatif. |
Constantes DirectionsStatus
constantes google.maps.DirectionsStatus
État renvoyé par DirectionsService
à la fin d'un appel à route()
. Spécifiez-les par une valeur ou en utilisant le nom de la constante. Par exemple : 'OK'
ou google.maps.DirectionsStatus.OK
.
Accès en appelant const {DirectionsStatus} = await google.maps.importLibrary("routes")
. Consultez la section Bibliothèques dans l'API Maps JavaScript.
Constantes | |
---|---|
INVALID_REQUEST |
Le DirectionsRequest fourni n'était pas valide. |
MAX_WAYPOINTS_EXCEEDED |
Trop de DirectionsWaypoint ont été fournis dans DirectionsRequest . Consultez le guide du développeur pour connaître le nombre maximal de points de cheminement autorisés. |
NOT_FOUND |
Au moins un point de départ, une destination ou un point 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 en trop peu de temps. |
REQUEST_DENIED |
Cette page Web n'est pas autorisée à utiliser le service Directions. |
UNKNOWN_ERROR |
Impossible de traiter une demande d'itinéraire en raison d'une erreur du serveur. Si vous essayez à nouveau, la requête pourrait aboutir. |
ZERO_RESULTS |
Aucun itinéraire n'a été trouvé 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 effectuer le rendu de ces objets à l'aide d'un DirectionsRenderer
, ou analyser cet objet et le rendre vous-même. Vous devez afficher les avertissements et les droits d'auteur conformément aux Conditions d'utilisation de Google Maps Platform. Bien que ce résultat soit de type JSON, il ne s'agit pas strictement de JSON, car il inclut indirectement des objets LatLng
.
Propriétés | |
---|---|
request |
Type:
DirectionsRequest DirectionsRequest ayant généré ce résultat. |
routes |
Type:
Array<DirectionsRoute> Tableau de DirectionsRoute , chacun contenant des informations sur les sections et les étapes qui le composent. Il n'y aura qu'une seule route, 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 "via des points de cheminement". |
geocoded_waypoints optional |
Type:
Array<DirectionsGeocodedWaypoint> optional Tableau de valeurs DirectionsGeocodedWaypoint contenant chacune des informations sur le geocoding des points de départ, de destination et de cheminement. |
Classe DirectionsRenderer
Classe google.maps.DirectionsRenderer
Affiche l'itinéraire obtenu à partir de DirectionsService
.
Cette classe étend MVCObject
.
Accès en appelant const {DirectionsRenderer} = await google.maps.importLibrary("routes")
. Consultez la section Bibliothèques dans l'API Maps JavaScript.
Constructeur | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) Paramètres:
Crée le moteur de rendu avec les options fournies. L'itinéraire peut être affiché sur une carte (en superposition visuelle) ou sur un panneau <div> (sous forme d'instructions textuelles). |
Méthodes | |
---|---|
getDirections |
getDirections() Paramètres:aucun
Valeur renvoyée:
DirectionsResult Renvoie l'ensemble d'orientations actuel du moteur de rendu. |
getMap |
getMap() Paramètres:aucun
Valeur renvoyée:
Map Renvoie la carte sur laquelle DirectionsResult est affichée. |
getPanel |
getPanel() Paramètres:aucun
Valeur renvoyée:
HTMLElement|null Renvoie le panneau <div> dans lequel DirectionsResult est affiché. |
getRouteIndex |
getRouteIndex() Paramètres:aucun
Valeur renvoyée:
number Renvoie l'index de route actuel (basé sur zéro) utilisé par cet objet DirectionsRenderer . |
setDirections |
setDirections(directions) Paramètres:
Valeur renvoyée:Aucune
Définissez le moteur de rendu pour qu'il utilise le résultat de DirectionsService . Définir un ensemble d'itinéraires valide de cette manière affiche l'itinéraire sur la carte et 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 l'itinéraire sera affiché. Transmettez null pour supprimer l'itinéraire de la carte. |
setOptions |
setOptions(options) Paramètres:
Valeur renvoyée:Aucune
Modifiez les paramètres des 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:
Valeur renvoyée:Aucune
Définissez l'index (basé sur zéro) de la route 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
|
Événements | |
---|---|
directions_changed |
function() Arguments:aucun
Cet événement est déclenché lorsque l'itinéraire affiché change, soit lorsqu'une nouvelle DirectionsResult est définie, soit lorsque l'utilisateur a fini de faire glisser une modification vers le tracé de l'itinéraire. |
Interface DirectionsRendererOptions
Interface google.maps.DirectionsRendererOptions
Cet objet définit les propriétés pouvant être définies sur un objet DirectionsRenderer
.
Propriétés | |
---|---|
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 d'accès 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 dans le panneau des itinéraires. |
infoWindow optional |
Type:
InfoWindow optional InfoWindow dans lequel afficher les informations textuelles lorsqu'un utilisateur clique sur un repère. Le contenu de la fenêtre d'informations existante sera remplacé et sa position sera déplacé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. Tous les repères affichés par DirectionsRenderer utiliseront ces options. |
panel optional |
Type:
HTMLElement optional <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 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'itinéraires. |
routeIndex optional |
Type:
number optional Index de la route dans l'objet DirectionsResult . La valeur par défaut est 0. |
suppressBicyclingLayer optional |
Type:
boolean optional Supprimez l'affichage du BicyclingLayer lorsque l'itinéraire à vélo est demandé. |
suppressInfoWindows optional |
Type:
boolean optional Désactiver l'affichage des fenêtres d'informations. |
suppressMarkers optional |
Type:
boolean optional Supprimez l'affichage des repères. |
suppressPolylines optional |
Type:
boolean optional Supprimez l'affichage des polylignes. |
Interface DirectionsWaypoint
Interface google.maps.DirectionsWaypoint
Un DirectionsWaypoint
représente un emplacement entre le point de départ et la destination que le trajet doit suivre.
Propriétés | |
---|---|
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 , ce point de cheminement est un arrêt situé entre le point de départ et la destination. L'itinéraire est alors divisé en deux sections. Si la valeur est false , l'itinéraire doit être biaisé pour traverser ce point de cheminement, mais ne doit pas être divisé en deux sections. Cette fonctionnalité est utile si vous souhaitez créer un itinéraire lorsque l'utilisateur fait glisser des points de cheminement sur une carte. |
Interface DirectionsGeocodedWaypoint
Interface google.maps.DirectionsGeocodedWaypoint
Point de cheminement unique géocodé.
Propriétés | |
---|---|
partial_match optional |
Type:
boolean optional Indique si le geocoder n'a pas renvoyé de correspondance exacte pour le point de cheminement 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 cheminement. 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 lieu, 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
Route unique contenant un ensemble de sections dans un DirectionsResult
. Notez que bien que cet objet soit de type JSON, il ne s'agit pas strictement de JSON, car il inclut directement et indirectement des objets LatLng
.
Propriétés | |
---|---|
bounds |
Type:
LatLngBounds Limites de cet itinéraire. |
copyrights |
Type:
string Texte sur les droits d'auteur à afficher pour cet itinéraire. |
legs |
Type:
Array<DirectionsLeg> Un tableau de DirectionsLeg , chacun contenant des informations sur les étapes qui le composent. Il y a une section pour chaque point de cheminement ou destination avec arrêt spécifié. Ainsi, un itinéraire sans point de cheminement avec arrêt contiendra un DirectionsLeg , et un itinéraire avec un seul point de cheminement avec arrêt en contiendra deux. |
overview_path |
Tableau de valeurs LatLng représentant l'intégralité du parcours. Le chemin d'accès a été simplifié afin de l'adapter aux contextes où un petit nombre de sommets est requis (URL de l'API Static Maps, par exemple). |
overview_polyline |
Type:
string 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, afin de donner un nom à celui-ci 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 était défini sur true , ce champ contient la nouvelle permutation des points de cheminement d'entrée. Par exemple, si l'entrée était:Origine: Los Angeles Waypoints: Dallas, Bangor, Phoenix Destination: New York et que la sortie optimisée a été organisée comme suit: Origine: Los Angeles Waypoints: Phoenix, Dallas, Bangor Destination: New York , ce champ est un Array contenant les valeurs [2, 0, 1] Notez que la numérotation des points de cheminement est basée sur zéro.Si stopover est défini sur false pour l'un des points de cheminement d'entrée, ce champ sera vide, car l'optimisation de l'itinéraire n'est pas disponible pour ce type de requêtes. |
fare optional |
Type:
TransitFare optional Tarif total pour l'ensemble du trajet en transports en commun. Uniquement applicable aux requêtes de transports en commun. |
Interface DirectionsLeg
Interface google.maps.DirectionsLeg
Section unique composée d'un ensemble d'étapes dans un DirectionsResult
. Il est possible que certains champs de la section ne soient pas renvoyés pour toutes les requêtes. Notez que bien que ce résultat soit de type JSON, il ne s'agit pas strictement de JSON, car il inclut directement et indirectement des objets LatLng
.
Propriétés | |
---|---|
end_address |
Type:
string Adresse de la destination de cette section. Ce contenu est destiné à être lu tel quel. N'analysez pas de manière programmatique l'adresse formatée. |
end_location |
Type:
LatLng Le DirectionsService calcule l'itinéraire entre deux lieux en utilisant l'option de transport la plus proche (généralement une route) aux points de départ et d'arrivée. end_location indique la destination géocodée réelle, qui peut être différente du end_location de la dernière étape si, par exemple, la route n'est pas à proximité de la destination de cette section. |
start_address |
Type:
string Adresse du point de départ de cette section. Ce contenu est destiné à être lu tel quel. N'analysez pas de manière programmatique l'adresse formatée. |
start_location |
Type:
LatLng Le DirectionsService calcule l'itinéraire entre deux lieux en utilisant l'option de transport la plus proche (généralement une route) aux points de départ et d'arrivée. start_location indique le point de départ réel géocodé, 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 la section. |
steps |
Type:
Array<DirectionsStep> Tableau de DirectionsStep , chacun contenant des informations sur les différentes étapes de cette section. |
|
Type:
Array<?> Informations sur la vitesse du trafic sur le trajet. |
via_waypoints |
Tableau des points de cheminement sans escale le long de cette section, 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 ajoutera des Lorsque vous utilisez le service Directions pour implémenter un itinéraire déplaçable, nous vous recommandons de désactiver le déplacement des itinéraires alternatifs. Seul l'itinéraire principal doit être déplaçable. Les utilisateurs peuvent faire glisser 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 demandes TRANSIT. |
departure_time optional |
Type:
Time optional Heure de départ estimée pour cette section. Ne s'applique qu'aux demandes TRANSIT. |
distance optional |
Type:
Distance optional Distance totale parcourue par cette section. Il est possible que cette propriété ne soit pas définie, car la distance est 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 élément DirectionsStep
dans une DirectionsResult
. Certains champs peuvent être undefined
. Notez que bien que cet objet soit de type JSON, il ne s'agit pas strictement de JSON, car il inclut directement des objets LatLng
.
Propriétés | |
---|---|
encoded_lat_lngs |
Type:
string Représentation de l'étape sous forme de polyligne encodée. Il s'agit d'un chemin approximatif (lissé) de l'étape. |
end_location |
Type:
LatLng Lieu d'arrivée de cette étape. |
|
Type:
LatLng Lieu d'arrivée de cette étape. |
instructions |
Type:
string Instructions pour cette étape. |
|
Séquence de LatLng décrivant le cours de cette étape. Il s'agit d'un chemin approximatif (lissé) de l'étape. |
maneuver |
Type:
string Contient l'action à effectuer pour l'étape actuelle ( turn-left , merge , straight , etc.). Les valeurs sont susceptibles d'être modifiées et de nouvelles valeurs peuvent être ajoutées sans préavis. |
path |
Séquence de LatLng décrivant le cours de cette étape. Il s'agit d'un chemin approximatif (lissé) de l'étape. |
start_location |
Type:
LatLng Lieu de départ de cette étape. |
|
Type:
LatLng Lieu de départ de cette étape. |
travel_mode |
Type:
TravelMode Mode de transport utilisé à cette étape. |
distance optional |
Type:
Distance optional Distance couverte par cette étape. Cette propriété peut être undefined , car la distance peut être inconnue. |
duration optional |
Type:
Duration optional Temps moyen nécessaire pour effectuer cette étape, en secondes et sous forme de texte. Cette propriété peut être undefined , car la durée peut être inconnue. |
|
Type:
DirectionsPolyline optional Contient un objet ayant 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 d'itinéraires de transports en commun autres que les transports en commun. |
transit optional |
Type:
TransitDetails optional Détails spécifiques aux transports en commun concernant cette étape. Cette propriété sera non définie, sauf si le mode de transport utilisé pour cette étape est TRANSIT . |
transit_details optional |
Type:
TransitDetails optional Détails concernant cette étape si le mode de transport est TRANSIT . |
Interface DirectionsPolyline
Interface google.maps.DirectionsPolyline
Objet contenant une propriété points
permettant de décrire la polyligne d'une DirectionsStep
.
Propriétés | |
---|---|
points |
Type:
string |
Interface Place
Interface google.maps.Place
Contient les informations nécessaires pour localiser, identifier ou décrire un lieu pour une DirectionsRequest
ou une DistanceMatrixRequest
. Dans ce contexte, le terme "lieu" désigne une entreprise, un point d'intérêt ou une zone géographique. Pour extraire des informations sur un lieu, consultez PlacesService
.
Propriétés | |
---|---|
location optional |
Type:
LatLng|LatLngLiteral optional Le LatLng de l'entité décrite par ce lieu. |
placeId optional |
Type:
string optional ID de lieu du lieu (par exemple, une entreprise ou un point d'intérêt). L'identifiant de lieu est un identifiant unique d'un lieu dans la base de données Google Maps. Notez que placeId est la méthode la plus précise pour identifier un lieu. Si possible, vous devez spécifier placeId plutôt qu'query . Un ID de lieu peut être récupéré à partir de n'importe quelle requête envoyée à l'API Places, par exemple TextSearch. Les ID de lieu peuvent également être récupérés à partir des 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 (une entreprise ou un point d'intérêt, par exemple). Exemple de requête : "Quay, Upper Level, Overseas Interest Terminal 5 Hickson Road, The Rocks NSW". Si possible, vous devez spécifier placeId plutôt qu'query . L'API ne garantit pas l'exactitude de la résolution de la chaîne de requête vers un lieu. Si les champs placeId et query sont tous deux fournis, une erreur se produit. |
Constantes TravelMode
constantes google.maps.TravelMode
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 une valeur ou en utilisant le nom de la constante. Par exemple : 'BICYCLING'
ou google.maps.TravelMode.BICYCLING
.
Accès en appelant const {TravelMode} = await google.maps.importLibrary("routes")
. Consultez la section Bibliothèques dans l'API Maps JavaScript.
Constantes | |
---|---|
BICYCLING |
Spécifie une requête d'itinéraire à vélo. |
DRIVING |
Spécifie une requête d'itinéraire. |
TRANSIT |
Spécifie une requête d'itinéraire en transports en commun. |
WALKING |
Spécifie une requête d'itinéraire à pied. |
Interface DrivingOptions
Interface google.maps.DrivingOptions
Configure le DirectionsRequest
lorsque le mode de transport est défini sur DRIVING
.
Propriétés | |
---|---|
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. Vous devez le spécifier 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 trafic. La valeur par défaut est BEST_GUESS . |
Constantes TrafficModel
constantes google.maps.TrafficModel
Hypothèses à utiliser pour prédire la durée du trafic. Spécifiée dans le cadre d'une DirectionsRequest
ou d'un DistanceMatrixRequest
. Spécifiez-les par une valeur ou en utilisant le nom de la constante. Par exemple : 'bestguess'
ou google.maps.TrafficModel.BEST_GUESS
.
Accès en appelant const {TrafficModel} = await google.maps.importLibrary("routes")
. Consultez la section Bibliothèques dans l'API Maps JavaScript.
Constantes | |
---|---|
BEST_GUESS |
Utiliser les données de l'historique du trafic pour estimer au mieux le temps passé dans le trafic. |
OPTIMISTIC |
Utiliser les données de l'historique du trafic pour estimer de manière optimiste la durée du trafic. |
PESSIMISTIC |
Utiliser les données de l'historique du trafic pour faire une estimation pessimiste de la durée du trafic. |
Interface TransitOptions
Interface google.maps.TransitOptions
Objet TransitOptions à inclure dans un élément DirectionsRequest
lorsque le mode de transport est défini sur TRANSIT.
Propriétés | |
---|---|
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 aucune heure de départ ni aucune heure d'arrivée n'est spécifiée, l'heure par défaut est "now" (maintenant). |
modes optional |
Type:
Array<TransitMode> optional Un ou plusieurs modes de transport préférés (bus ou train, par exemple) Si aucune préférence n'est définie, l'API renvoie la meilleure route par défaut. |
routingPreference optional |
Type:
TransitRoutePreference optional Une préférence qui peut biaiser le choix de l'itinéraire en transports en commun (par exemple, moins de marche à pied). Si aucune préférence n'est définie, l'API renvoie la meilleure route par défaut. |
Constantes TransitMode
constantes google.maps.TransitMode
Mode de transport valide (par exemple, bus) pouvant être spécifié dans une TransitOptions
. Spécifiez-les par une valeur ou en utilisant le nom de la constante. Par exemple : 'BUS'
ou google.maps.TransitMode.BUS
.
Accès en appelant const {TransitMode} = await google.maps.importLibrary("routes")
. Consultez la section Bibliothèques dans l'API Maps JavaScript.
Constantes | |
---|---|
BUS |
Spécifie le bus comme mode de transport préféré. |
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 préféré. |
Constantes TransitRoutePreference
constantes google.maps.TransitRoutePreference
Type d'itinéraire en transports en commun valide pouvant être spécifié dans un élément TransitOptions
. Spécifiez-les par une valeur ou en utilisant le nom de la constante. Par exemple : 'LESS_WALKING'
ou google.maps.TransitRoutePreference.LESS_WALKING
.
Accès en appelant const {TransitRoutePreference} = await google.maps.importLibrary("routes")
. Consultez la section Bibliothèques dans l'API Maps JavaScript.
Constantes | |
---|---|
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 d'un DirectionsRoute
composé de la valeur et de la devise.
Propriétés | |
---|---|
currency |
Type:
string Code de devise ISO 4217 indiquant la devise dans laquelle le tarif est exprimé. |
value |
Type:
number Valeur numérique du tarif, exprimée dans le currency donné. |
Interface TransitDetails
Interface google.maps.TransitDetails
Détails sur le départ et l'arrivée, et sur le mode de transport utilisé pour cette étape.
Propriétés | |
---|---|
arrival_stop |
Type:
TransitStop Arrêt d'arrivée de cette étape de transports 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 transports 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 estimé de secondes entre des véhicules équivalents à cet arrêt. |
line |
Type:
TransitLine Détails sur la ligne de transports en commun utilisée à cette étape. |
num_stops |
Type:
number Nombre d'arrêts à cette étape. L'arrêt d'arrivée est inclus, mais pas celui de départ. |
trip_short_name |
Type:
string Texte qui s'affiche sur les tableaux d'horaires et sur les panneaux pour identifier les usagers d'un trajet en transports en commun (par exemple, pour identifier les numéros de train pour les trajets en train de banlieue). 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.
Propriétés | |
---|---|
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 dessert cette étape.
Propriétés | |
---|---|
agencies |
Type:
Array<TransitAgency> Agence de transports en commun desservant cette ligne. |
color |
Type:
string Couleur généralement utilisée dans la signalisation de cette ligne de transports en commun, représentée par une 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, "8 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 dans la signalisation de cette ligne de transports en commun, représentée par une chaîne hexadécimale. |
url |
Type:
string URL de l'agence spécifique à cette ligne de transports en commun. |
vehicle |
Type:
TransitVehicle Type de véhicule utilisé (par exemple, train ou bus). |
Interface TransitAgency
Interface google.maps.TransitAgency
Informations sur une agence qui gère une ligne de transports en commun.
Propriétés | |
---|---|
name |
Type:
string Nom de cette agence de transports en commun. |
phone |
Type:
string Numéro de téléphone du réseau de transports en commun. |
url |
Type:
string URL du réseau de transports en commun. |
Interface TransitVehicle
Interface google.maps.TransitVehicle
Informations sur le véhicule circulant sur une ligne de transports en commun.
Propriétés | |
---|---|
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 qui correspond au type de véhicule utilisé dans cette région et non à l'icône plus générale. |
name |
Type:
string Nom de ce type de TransitVehicle (par exemple, "Train" ou "Bus"). |
type |
Type:
VehicleType Type de véhicule utilisé (par exemple, train, bus ou ferry). |
Constantes VehicleType
constantes google.maps.VehicleType
Valeurs possibles pour les types de véhicules.
Accès en appelant const {VehicleType} = await google.maps.importLibrary("routes")
. Consultez la section Bibliothèques dans l'API Maps JavaScript.
Constantes | |
---|---|
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 |
Le taxi partagé est une sorte de transport en bus qui permet de déposer et de prendre des passagers n'importe où sur son trajet. En général, les taxis partagés sont équipés de minibus. |
SUBWAY |
Métro léger souterrain. |
TRAM |
Métro léger en surface. |
TROLLEYBUS |
Trolleybus. |
Constantes UnitSystem
constantes google.maps.UnitSystem
Systèmes d'unités valides pouvant être spécifiés dans un élément DirectionsRequest
.
Accès en appelant const {UnitSystem} = await google.maps.importLibrary("core")
. Consultez la section Bibliothèques dans l'API Maps JavaScript.
Constantes | |
---|---|
IMPERIAL |
Indique que les distances du DirectionsResult doivent être exprimées en unités impériales. |
METRIC |
Indique que les distances du 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 d'une chaîne d'affichage.
Propriétés | |
---|---|
text |
Type:
string Représentation sous forme de chaîne de la valeur de la distance, utilisant le 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.
Propriétés | |
---|---|
text |
Type:
string Représentation sous forme de chaîne de la valeur de 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.
Propriétés | |
---|---|
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 de l'arrêt. Cette 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 de date JavaScript. |
Constantes DirectionsTravelMode
constantes google.maps.DirectionsTravelMode
Constantes DirectionsUnitSystem
constantes google.maps.DirectionsUnitSystem