DirectionsService
Classe google.maps.DirectionsService
Service permettant de calculer l'itinéraire entre deux lieux ou plus.
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> Effectuez une requête de recherche d'itinéraire. |
Interface DirectionsRequest
google.maps.DirectionsRequest
interface
Requête d'itinéraire à envoyer au DirectionsService
.
Propriétés | |
---|---|
destination |
Type:
string|LatLng|Place|LatLngLiteral Lieu de 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 , indique au service Directions d'éviter les ferries lorsque cela est 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 requêtes pour lesquelles la valeur de travelMode est DRIVING . Cet objet n'aura aucun effet pour les autres modes de transport. |
optimizeWaypoints optional |
Type :
boolean optional Si la valeur est true , DirectionsService tente de réorganiser les points de cheminement 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 requêtes de geocoding. Le code de région 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 ) 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 la valeur de travelMode est TRANSIT. Cet objet n'aura 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 la distance. |
waypoints optional |
Type:
Array<DirectionsWaypoint> optional Tableau de points de cheminement intermédiaires. L'itinéraire est calculé à partir de chaque point de cheminement dans 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 ces valeurs par valeur ou en utilisant le nom de la constante. Par exemple, 'OK'
ou google.maps.DirectionsStatus.OK
.
Constantes | |
---|---|
INVALID_REQUEST |
Le DirectionsRequest fourni n'était pas valide. |
MAX_WAYPOINTS_EXCEEDED |
Trop de DirectionsWaypoint ont été fournies dans le DirectionsRequest . Consultez le guide du développeur pour connaître le nombre maximal de points de cheminement autorisés. |
NOT_FOUND |
Impossible de géocoder au moins un point de départ, une destination ou des points de cheminement. |
OK |
La réponse contient un DirectionsResult valide. |
OVER_QUERY_LIMIT |
La page Web a dépassé le nombre maximal de requêtes trop rapidement. |
REQUEST_DENIED |
La page Web n'est pas autorisée à utiliser le service Directions. |
UNKNOWN_ERROR |
Une demande 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 |
Impossible de trouver un itinéraire entre le point de départ et la destination. |
Interface DirectionsResult
google.maps.DirectionsResult
interface
Réponse d'itinéraire récupérée 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 droits d'auteur comme indiqué dans les Conditions d'utilisation de Google Maps Platform. Notez que même si ce résultat est de type JSON, il n'est pas strictement JSON, car il inclut indirectement des objets LatLng
.
Propriétés | |
---|---|
routes |
Type:
Array<DirectionsRoute> Tableau de valeurs DirectionsRoute , chacune contenant des informations sur les parties et les étapes de sa composition. Il n'y aura qu'un seul itinéraire, sauf si vous avez défini DirectionsRequest 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 affiché si un ou plusieurs points de cheminement sont "via des points de cheminement". |
geocoded_waypoints optional |
Type:
Array<DirectionsGeocodedWaypoint> optional Tableau de valeurs DirectionsGeocodedWaypoint , chacune 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 l'itinéraire obtenu à partir de DirectionsService
.
Cette classe étend MVCObject
.
Constructeur | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) Paramètres:
Crée le moteur de rendu avec les options données. L'itinéraire peut être affiché sur une carte (en superposition visuelle) ou sur un panneau <div> (sous forme de texte). |
Méthodes | |
---|---|
getDirections |
getDirections() Paramètres:aucun
Valeur renvoyée :
DirectionsResult Renvoie l'ensemble d'itinéraires actuel du moteur de rendu. |
getMap |
getMap() Paramètres:aucun
Valeur renvoyée:
Map Renvoie la carte sur laquelle le rendu DirectionsResult est effectué. |
getPanel |
getPanel() Paramètres : aucun
Valeur renvoyée :
HTMLElement|null Renvoie le panneau <div> dans lequel l'élément DirectionsResult est affiché. |
getRouteIndex |
getRouteIndex() Paramètres : aucun
Valeur renvoyée :
number Renvoie l'index de routage actuel (basé sur zéro) utilisé par cet objet DirectionsRenderer . |
setDirections |
setDirections(directions) Paramètres :
Valeur de retour:aucune
Configurez le moteur de rendu pour qu'il utilise le résultat de DirectionsService . Si vous définissez un ensemble d'itinéraires valide de cette manière, ils s'afficheront sur la carte et le panneau désignés par le moteur de rendu. |
setMap |
setMap(map) Paramètres :
Valeur de retour : 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 de retour : aucune
Modifiez les paramètres d'options de ce DirectionsRenderer après l'initialisation. |
setPanel |
setPanel(panel) Paramètres:
Valeur de retour : 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 de retour:aucune
Définissez l'index (basé sur zéro) de la route dans l'objet DirectionsResult à afficher. Par défaut, le premier itinéraire du tableau est affiché. |
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 rendu change, soit lorsqu'un nouvel élément DirectionsResult est défini, soit lorsque l'utilisateur termine de faire glisser une modification dans le chemin de l'itinéraire. |
Interface DirectionsRendererOptions
google.maps.DirectionsRendererOptions
interface
Cet objet définit les propriétés qui peuvent ê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 de routes 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 de routes sélectionnables par l'utilisateur qui s'affichent dans le panneau d'itinéraire. |
infoWindow optional |
Type :
InfoWindow optional InfoWindow dans lequel afficher des informations textuelles lorsqu'un utilisateur clique sur un repère. Le contenu de la fenêtre d'informations 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 que 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 de BicyclingLayer lorsque des itinéraires à vélo sont demandés. |
suppressInfoWindows optional |
Type:
boolean optional Supprimer l'affichage des fenêtres d'informations |
suppressMarkers optional |
Type:
boolean optional Supprimer l'affichage des repères |
suppressPolylines optional |
Type :
boolean optional Supprimer l'affichage des polylignes |
Interface DirectionsWaypoint
google.maps.DirectionsWaypoint
interface
Un DirectionsWaypoint
représente un point entre le point de départ et la destination via lesquels le trajet doit être acheminé.
Propriétés | |
---|---|
location optional |
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 , indique que ce point de cheminement est un arrêt entre le point de départ et la destination. Cela permet de diviser l'itinéraire en deux parties. Si la valeur est false , l'itinéraire doit être orienté de manière à passer par ce point de cheminement, mais pas en deux parties. Cette fonctionnalité est utile si vous souhaitez créer un itinéraire en réponse à un utilisateur faisant glisser des points de cheminement sur une carte. |
Interface DirectionsGeocodingWaypoint
google.maps.DirectionsGeocodedWaypoint
interface
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 établir une correspondance avec 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
google.maps.DirectionsRoute
interface
Un itinéraire unique contenant un ensemble de sections dans un DirectionsResult
. Bien que cet objet soit de type JSON, il n'est pas strictement 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 des droits d'auteur à afficher pour cet itinéraire. |
legs |
Type:
Array<DirectionsLeg> Tableau de valeurs DirectionsLeg , chacune contenant des informations sur les étapes dont il est composé. Il y a une section pour chaque point de cheminement ou destination spécifiés. Ainsi, un itinéraire sans point de cheminement avec arrêt contient un DirectionsLeg et un itinéraire avec un seul point de cheminement avec escale. |
overview_path |
Type:
Array<LatLng> Tableau de valeurs LatLng représentant l'intégralité du parcours de cet itinéraire. Le chemin d'accès est simplifié afin qu'il soit adapté aux contextes où un petit nombre de sommets est nécessaire (comme les URL de l'API Static Maps). |
overview_polyline |
Type :
string Représentation de la polyligne encodée de l'itinéraire 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, qui permet de nommer l'itinéraire et de le différencier des autres possibilités. |
warnings |
Type:
Array<string> Des avertissements s'affichent lorsque vous suivez ces instructions. |
waypoint_order |
Type :
Array<number> Si optimizeWaypoints a été défini sur true , ce champ contient la permutation des points de cheminement d'entrée dans un ordre différent. Par exemple, si l'entrée était :Origine: Los Angeles Waypoints: Dallas, Bangor, Phoenix Destination: New York et le résultat optimisé a été classé comme suit : Origine: Los Angeles Waypoints: Phoenix, Dallas, Bangor Destination: New York alors ce champ sera 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 d'itinéraire n'est pas disponible pour ces requêtes. |
fare optional |
Type:
TransitFare optional Prix total du trajet en transports en commun. Uniquement applicable aux requêtes de transport en commun. |
DirectionsLeg
google.maps.DirectionsLeg
interface
Une section se compose d'un ensemble de pas dans un DirectionsResult
. Certains champs de la section peuvent ne pas être renvoyés pour toutes les requêtes. Bien que ce résultat soit de type JSON, il n'est pas strictement JSON, car il inclut directement et indirectement des objets LatLng
.
Propriétés | |
---|---|
end_address |
Type:
string Adresse de 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 (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 de la valeur end_location de la dernière étape si, par exemple, la route ne se trouve pas à proximité de la destination de cette section. |
start_address |
Type :
string Adresse d'origine de la 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 (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 proche de l'origine de cette section. |
steps |
Type :
Array<DirectionsStep> Tableau de valeurs DirectionsStep , chacune contenant des informations sur les étapes individuelles de cette section. |
|
Type :
Array<?> Informations sur la vitesse de circulation en chemin. |
via_waypoints |
Type :
Array<LatLng> Tableau de points de cheminement sans escale le long de cette section, spécifiés dans la requête d'origine. Obsolète dans les autres itinéraires. La version 3.27 sera la dernière version de l'API à ajouter des Lorsque vous utilisez le service Directions pour mettre en œuvre des itinéraires déplaçables, nous vous recommandons de désactiver le déplacement d'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 autre itinéraire. |
arrival_time optional |
Type:
Time optional Heure d'arrivée estimée pour cette section. Uniquement applicable aux requêtes TRANSIT. |
departure_time optional |
Type:
Time optional Heure de départ estimée pour cette section. Uniquement applicable aux requêtes TRANSIT. |
distance optional |
Type :
Distance optional Distance totale couverte par cette section. Il est possible que cette propriété ne soit pas 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 dans la propriété trafficModel . Cette propriété peut être undefined , car la durée peut être inconnue. |
DirectionsStep
google.maps.DirectionsStep
interface
Un seul élément DirectionsStep
dans un DirectionsResult
. Certains champs peuvent être undefined
. Bien que cet objet soit de type JSON, il n'est pas strictement JSON, car il inclut directement des objets LatLng
.
Propriétés | |
---|---|
encoded_lat_lngs |
Type :
string Une représentation de polyligne encodée de l'étape. 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. |
|
Type:
Array<LatLng> Séquence de LatLng décrivant le déroulement 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 de changer, et de nouvelles valeurs peuvent être ajoutées sans préavis. |
path |
Type:
Array<LatLng> Séquence de LatLng décrivant le déroulement 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 déplacement 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 généralement nécessaire pour effectuer cette étape en secondes et sous forme textuelle. Cette propriété peut être undefined , car la durée peut être inconnue. |
|
Type :
Array<DirectionsStep> 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 d'itinéraires en transports en commun (hors transports en commun). |
transit optional |
Type:
TransitDetails optional Informations spécifiques aux transports en commun concernant 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 Détails relatifs à cette étape si le mode de transport est TRANSIT . |
Interface DirectionsPolyline
google.maps.DirectionsPolyline
interface
Objet contenant une propriété points
pour décrire la polyligne d'une DirectionsStep
.
Propriétés | |
---|---|
points |
Type :
string |
Interface Place
google.maps.Place
interface
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 une entreprise, un point d'intérêt ou un emplacement géographique. Pour récupérer des informations sur un lieu, consultez PlacesService
.
Propriétés | |
---|---|
location optional |
Type:
LatLng|LatLngLiteral optional 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'identifiant de lieu est un identifiant unique d'un lieu dans la base de données Google Maps. Notez que placeId est le moyen le plus précis d'identifier un lieu. Si possible, spécifiez placeId plutôt qu'un query . Vous pouvez récupérer un ID de lieu à 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 (entreprise ou point d'intérêt, par exemple) Exemple de requête : "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW". Si possible, spécifiez placeId plutôt qu'un query . L'API ne garantit pas l'exactitude de la résolution de la chaîne de requête pour obtenir un lieu. Si les valeurs placeId et query sont fournies, une erreur se produit. |
Constantes TravelMode
constantes google.maps.TravelMode
Modes de transport valides qui peuvent être spécifiés dans un DirectionsRequest
, ainsi que les modes de transport renvoyés dans un DirectionsStep
. Spécifiez ces valeurs par valeur ou en utilisant le nom de la constante. Par exemple, 'BICYCLING'
ou google.maps.TravelMode.BICYCLING
.
Constantes | |
---|---|
BICYCLING |
Spécifie une demande d'itinéraire à vélo. |
DRIVING |
Spécifie une demande 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
google.maps.DrivingOptions
interface
Configure 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. Cette valeur doit être spécifiée pour qu'une DrivingOptions soit valide. L'heure de départ doit être définie sur l'heure actuelle ou sur une heure future. mais pas sur une heure passée. |
trafficModel optional |
Type :
TrafficModel optional Hypothèse à utiliser 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 un DirectionsRequest
ou un DistanceMatrixRequest
. Spécifiez ces valeurs par valeur ou en utilisant le nom de la constante. Par exemple, 'bestguess'
ou google.maps.TrafficModel.BEST_GUESS
.
Constantes | |
---|---|
BEST_GUESS |
Utilisez les données de l'historique du trafic pour estimer au mieux le temps passé dans le trafic. |
OPTIMISTIC |
Utilisez des données historiques de trafic pour estimer de manière optimiste la durée du trafic. |
PESSIMISTIC |
Utilisez des données historiques de trafic pour obtenir une estimation pessimiste de la durée du trafic. |
Interface TransitOptions
google.maps.TransitOptions
interface
Objet TransitOptions à inclure dans un 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 heure d'arrivée n'est spécifiée, l'heure est supposée être "now" (maintenant). |
modes optional |
Type:
Array<TransitMode> optional Un ou plusieurs modes de transport préférés, par exemple le bus ou le train. Si aucune préférence n'est donnée, l'API renvoie le meilleur itinéraire par défaut. |
routingPreference optional |
Type :
TransitRoutePreference optional Une préférence qui peut influencer le choix de l'itinéraire en transports en commun (par exemple, moins de marche). Si aucune préférence n'est donnée, l'API renvoie le meilleur itinéraire par défaut. |
Constantes TransitMode
constantes google.maps.TransitMode
Mode de transport en commun valide, par exemple un bus qui peut être spécifié dans un TransitOptions
. Spécifiez ces valeurs par valeur ou en utilisant le nom de la constante. Par exemple, 'BUS'
ou google.maps.TransitMode.BUS
.
Constantes | |
---|---|
BUS |
Spécifie le bus comme mode de transport préféré. |
RAIL |
Spécifie le réseau ferroviaire comme mode de transport préféré. |
SUBWAY |
Spécifie le métro comme mode de transport préféré. |
TRAIN |
Spécifie le train comme mode de transport préféré. |
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 TransitOptions
. Spécifiez ces valeurs par valeur ou en utilisant le nom de la constante. Par exemple, 'LESS_WALKING'
ou google.maps.TransitRoutePreference.LESS_WALKING
.
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 nombre de marches autorisées. |
Interface TransitFare
google.maps.TransitFare
interface
Un tarif de DirectionsRoute
comprenant une valeur et une 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
google.maps.TransitDetails
interface
Détails sur le départ, l'arrivée et le mode de transport utilisé à cette étape.
Propriétés | |
---|---|
arrival_stop |
Type:
TransitStop Arrêt à l'arrivée de cette étape. |
arrival_time |
Type :
Time Heure d'arrivée à cette étape, spécifiée en tant qu'objet Time. |
departure_stop |
Type:
TransitStop Arrêt de départ de cette étape. |
departure_time |
Type:
Time Heure de départ de cette étape, spécifiée en tant qu'objet Time. |
headsign |
Type:
string Direction dans laquelle circuler sur cette ligne, comme indiqué sur le véhicule ou à l'arrêt de départ. |
headway |
Type :
number Nombre de secondes prévues 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 pour cette étape. L'arrêt d'arrivée est inclus, mais pas celui de départ. |
trip_short_name |
Type:
string Texte affiché dans les horaires et les panneaux d'affichage afin d'identifier un trajet en transports en commun (par exemple, un numéro de train pour les trajets en train de banlieue). Ce texte identifie de manière unique un trajet au cours d'une journée de service. |
Interface TransitStop
google.maps.TransitStop
interface
Informations sur un arrêt ou une station de transports en commun.
Propriétés | |
---|---|
location |
Type :
LatLng Lieu de cet arrêt. |
name |
Type :
string Nom de cet arrêt de transports en commun. |
Interface TransitLine
google.maps.TransitLine
interface
Informations sur la ligne de transports en commun qui effectue cette étape.
Propriétés | |
---|---|
agencies |
Type :
Array<TransitAgency> Agence de transports en commun qui gère cette ligne de transports en commun. |
color |
Type:
string Couleur généralement utilisée pour la signalisation sur 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 cette 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 de texte généralement utilisée pour la signalétique sur cette ligne de transports en commun, représentée par une chaîne hexadécimale. |
url |
Type :
string URL du réseau propre à cette ligne de transports en commun. |
vehicle |
Type:
TransitVehicle Type de véhicule utilisé (par exemple, train ou bus). |
Interface TransitAgency
google.maps.TransitAgency
interface
Informations sur une agence gérant 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
google.maps.TransitVehicle
interface
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 au lieu de l'icône plus générale. |
name |
Type :
string Nom de ce type de véhicule de transport (par exemple, "Train" ou "Bus"). |
type |
Type:
VehicleType Type de véhicule utilisé (train, bus ou ferry, par exemple). |
Constantes VehicleType
constantes google.maps.VehicleType
Valeurs possibles pour les types de véhicules. Ces valeurs sont spécifiées sous forme de chaînes, par exemple "BUS" ou "TRAIN".
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 récupérer des passagers n'importe où sur l'itinéraire. Généralement, les taxis utilisent des véhicules avec 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 DirectionsRequest
.
Constantes | |
---|---|
IMPERIAL |
Spécifie que les distances dans DirectionsResult doivent être exprimées en unités impériales. |
METRIC |
Spécifie que les distances dans DirectionsResult doivent être exprimées en unités métriques. |
Interface Distance
google.maps.Distance
interface
Représentation de la distance sous la forme d'une 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 distance à l'aide du UnitSystem spécifié dans la requête. |
value |
Type :
number Distance en mètres. |
Duration
google.maps.Duration
interface
Représentation de la durée sous la forme d'une 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 durée. |
value |
Type:
number Durée en secondes. |
Interface Time
google.maps.Time
interface
Représentation de l'heure en tant qu'objet Date, chaîne localisée et 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 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 Date JavaScript. |