Classe DirectionsService
classe
google.maps.DirectionsService
bibliothèque "routes"
const {DirectionsService} = await google.maps.importLibrary("routes");
Constructeur | |
|---|---|
DirectionsService |
DirectionsService()Paramètres : aucun
Crée une instance d'un 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 à DirectionsService.
Propriétés | |
|---|---|
destination |
Type :
string|LatLng|Place|LatLngLiteralEmplacement 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|LatLngLiteralLieu d'origine. Il peut s'agir d'une chaîne à géocoder, d'un LatLng ou d'un Place. Obligatoire. |
travelMode |
Type :
TravelModeType de routage demandé. Obligatoire. |
avoidFerries
facultatif |
Type :
boolean optionalSi la valeur est true, indique au service Directions d'éviter les ferries dans la mesure du possible. Facultatif. |
avoidHighways
facultatif |
Type :
boolean optionalSi la valeur est true, indique au service Directions d'éviter les autoroutes dans la mesure du possible. Facultatif. |
avoidTolls
facultatif |
Type :
boolean optionalSi la valeur est true, indique au service Directions d'éviter les routes à péage dans la mesure du possible. Facultatif. |
drivingOptions
facultatif |
Type :
DrivingOptions optionalParamètres qui ne s'appliquent qu'aux requêtes où travelMode est DRIVING. Cet objet n'aura aucun effet sur les autres modes de transport. |
language
facultatif |
Type :
string optionalIdentifiant de la langue dans laquelle les résultats doivent être renvoyés, si possible. Consultez la liste des langues disponibles. |
optimizeWaypoints
facultatif |
Type :
boolean optionalSi la valeur est définie sur 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, inspectez DirectionsRoute.waypoint_order dans la réponse pour déterminer le nouvel ordre. |
provideRouteAlternatives
facultatif |
Type :
boolean optionalIndique si des itinéraires alternatifs doivent être fournis ou non. Facultatif. |
region
facultatif |
Type :
string optionalCode de région utilisé comme biais pour les requêtes 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
facultatif |
Type :
TransitOptions optionalParamètres qui ne s'appliquent qu'aux requêtes où travelMode est défini sur TRANSIT. Cet objet n'aura aucun effet sur les autres modes de transport. |
unitSystem
facultatif |
Type :
UnitSystem optionalPar défaut : système d'unités utilisé dans le pays d'origine.
Système d'unités à utiliser pour afficher des distances. |
waypoints
facultatif |
Type :
Array<DirectionsWaypoint> optionalTableau de points de cheminement intermédiaires. L'itinéraire est calculé du point de départ à la destination en passant par chaque point de cheminement 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
bibliothèque "routes"
É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.
Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type DirectionsStatusString.
const {DirectionsStatus} = await google.maps.importLibrary("routes");
Constantes | |
|---|---|
INVALID_REQUEST |
La valeur DirectionsRequest fournie 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. |
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 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, bien que ce résultat soit de type JSON, il ne s'agit pas strictement de JSON, car il inclut indirectement des objets DirectionsRendererLatLng.
Propriétés | |
|---|---|
request |
Type :
DirectionsRequestDirectionsRequest qui a généré ce résultat. |
routes |
Type :
Array<DirectionsRoute>Tableau de DirectionsRoute, chacun contenant des informations sur les étapes et les tronçons 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
facultatif |
Type :
Array<TravelMode> optionalContient 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 de type "via". |
geocoded_waypoints
facultatif |
Type :
Array<DirectionsGeocodedWaypoint> optionalTableau d'objets DirectionsGeocodedWaypoint, chacun contenant des informations sur le geocoding du point de départ, de la destination et des points de cheminement. |
DirectionsRenderer
class
google.maps.DirectionsRenderer
extends MVCObject
library "routes"
const {DirectionsRenderer} = await google.maps.importLibrary("routes");
Constructeur | |
|---|---|
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 sur un panneau <div> (sous forme d'instructions textuelles). |
Méthodes | |
|---|---|
getDirections |
getDirections()Paramètres : aucun
Valeur renvoyée :
DirectionsResult|nullRenvoie l'ensemble d'itinéraires actuel du moteur de rendu. |
getMap |
getMap()Paramètres : aucun
Valeur renvoyée :
Map|nullRenvoie la carte sur laquelle le DirectionsResult est affiché. |
getPanel |
getPanel()Paramètres : aucun
Valeur renvoyée :
HTMLElement|nullRenvoie le panneau <div> dans lequel le DirectionsResult est affiché. |
getRouteIndex |
getRouteIndex()Paramètres : aucun
Valeur renvoyée :
numberRenvoie l'index d'itinéraire actuel (base 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. Si vous définissez un ensemble d'itinéraires valide de cette manière, les itinéraires s'afficheront 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 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 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 l'itinéraire dans l'objet DirectionsResult à afficher. Par défaut, la première route du tableau s'affiche. |
Héritées :
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'un nouveau DirectionsResult est défini, soit lorsque l'utilisateur termine de faire glisser une modification sur le tracé de l'itinéraire. |
Interface DirectionsRendererOptions
interface
google.maps.DirectionsRendererOptions
Cet objet définit les propriétés qui peuvent être définies sur un objet DirectionsRenderer.
Propriétés | |
|---|---|
directions
facultatif |
Type :
DirectionsResult optionalL'itinéraire à afficher sur la carte et/ou dans un panneau <div>, récupéré en tant qu'objet DirectionsResult à partir de DirectionsService. |
draggable
facultatif |
Type :
boolean optionalSi la valeur est true, l'utilisateur peut faire glisser et modifier les chemins des itinéraires affichés par ce DirectionsRenderer. |
hideRouteList
facultatif |
Type :
boolean optionalPar défaut :
falseCette propriété indique si le moteur de rendu doit fournir une liste d'itinéraires sélectionnables par l'utilisateur dans le panneau d'itinéraire. |
infoWindow
facultatif |
Type :
InfoWindow optionalInfoWindow dans lequel afficher les informations textuelles lorsqu'un utilisateur clique sur un repère. 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
facultatif |
Type :
Map optionalCarte sur laquelle afficher l'itinéraire. |
markerOptions
facultatif |
Type :
Options des repères. Tous les repères affichés par DirectionsRenderer utiliseront ces options. |
panel
facultatif |
Type :
HTMLElement optional<div> dans lequel afficher les étapes de l'itinéraire. |
polylineOptions
facultatif |
Type :
PolylineOptions optionalOptions des polylignes. Toutes les polylignes affichées par DirectionsRenderer utiliseront ces options. |
preserveViewport
facultatif |
Type :
boolean optionalPar défaut :
falseSi 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
facultatif |
Type :
number optionalIndex de l'itinéraire dans l'objet DirectionsResult. La valeur par défaut est 0. |
suppressBicyclingLayer
facultatif |
Type :
boolean optionalSupprimez l'affichage de BicyclingLayer lorsque des itinéraires à vélo sont demandés. |
suppressInfoWindows
facultatif |
Type :
boolean optionalSupprimez l'affichage des fenêtres d'informations. |
suppressMarkers
facultatif |
Type :
boolean optionalSupprimez l'affichage des repères. |
suppressPolylines
facultatif |
Type :
boolean optionalSupprimez 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 par lequel l'itinéraire doit passer.
Propriétés | |
|---|---|
location
facultatif |
Type :
string|LatLng|LatLngLiteral|Place optionalEmplacement du point de cheminement. Il peut s'agir d'une chaîne d'adresse, d'un LatLng ou d'un Place. Facultatif. |
stopover
facultatif |
Type :
boolean optionalPar défaut :
trueSi 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 qu'il ne doit pas être divisé en deux étapes. Cela est utile si vous souhaitez créer un itinéraire en réponse au déplacement de points de cheminement sur une carte par l'utilisateur. |
Interface DirectionsGeocodedWaypoint
interface
google.maps.DirectionsGeocodedWaypoint
Un seul point de cheminement géocodé.
Propriétés | |
|---|---|
partial_match
facultatif |
Type :
boolean optionalIndique 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
facultatif |
Type :
string optionalID 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
facultatif |
Type :
Array<string> optionalTableau 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 d'étapes dans un DirectionsResult. Notez que, bien que cet objet soit de type JSON, il ne s'agit pas strictement d'un objet JSON, car il inclut directement et indirectement des objets LatLng.
Propriétés | |
|---|---|
bounds |
Type :
LatLngBoundsLimites de cet itinéraire. |
copyrights |
Type :
stringTexte sur les droits d'auteur à afficher pour cet itinéraire. |
legs |
Type :
Array<DirectionsLeg>Tableau de DirectionsLeg, chacun contenant des informations sur les étapes qui le composent. Il y aura une étape pour chaque point de cheminement ou destination spécifié. Un itinéraire sans point de cheminement avec arrêt contiendra donc un DirectionsLeg, et un itinéraire avec un point de cheminement avec arrêt en contiendra deux. |
overview_path |
Tableau de LatLng représentant l'intégralité du tracé de cet itinéraire. Le tracé est simplifié afin de l'adapter aux contextes où un petit nombre de sommets est requis (comme les URL de l'API Google Maps Static). |
overview_polyline |
Type :
stringUne 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 :
stringContient une brève description textuelle de l'itinéraire, adaptée pour nommer l'itinéraire et le distinguer des autres. |
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 :Origine : Los Angeles Points de cheminement : Dallas, Bangor, Phoenix Destination : New York et que la sortie optimisée était ordonnée comme suit : Origine : Los Angeles Points de cheminement : 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 cheminement est basée sur zéro.Si l'un des points de cheminement d'entrée a stopover défini sur false, ce champ sera vide, car l'optimisation d'itinéraire n'est pas disponible pour ces requêtes. |
fare
facultatif |
Type :
TransitFare optionalTarif total pour l'ensemble du trajet en transports en commun. Applicable uniquement aux requêtes de transports en commun. |
Interface DirectionsLeg
interface
google.maps.DirectionsLeg
Une seule section composée d'un ensemble d'étapes dans un DirectionsResult. Il est possible que certains champs de l'étape ne soient pas renvoyés pour toutes les requêtes. Notez que même si ce résultat est 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 :
stringAdresse de la destination de cette étape. Ce contenu est destiné à être lu tel quel. N'analysez pas par programmation l'adresse formatée. |
end_location |
Type :
LatLngDirectionsService 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 la valeur 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 :
stringAdresse du point de départ de cette section. Ce contenu est destiné à être lu tel quel. N'analysez pas par programmation l'adresse formatée. |
start_location |
Type :
LatLngDirectionsService 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 |
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 le long de l'étape. |
via_waypoints |
Tableau de points de cheminement sans arrêt le long de cette étape, qui ont été 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 Lorsque vous utilisez le service Directions pour implémenter un itinéraire déplaçable, 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
facultatif |
Type :
Time optionalHeure d'arrivée estimée pour cette étape. Applicable uniquement aux requêtes TRANSIT. |
departure_time
facultatif |
Type :
Time optionalHeure de départ estimée pour cette étape. Applicable uniquement aux requêtes TRANSIT. |
distance
facultatif |
Type :
Distance optionalDistance totale couverte par cette section. Cette propriété peut être non définie, car la distance peut être inconnue. |
duration
facultatif |
Type :
Duration optionalDurée totale de cette section. Cette propriété peut être undefined, car la durée peut être inconnue. |
duration_in_traffic
facultatif |
Type :
Duration optionalDuré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. |
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 ne s'agit pas strictement d'un objet JSON, car il inclut directement des objets LatLng.
Propriétés | |
|---|---|
encoded_lat_lngs |
Type :
stringReprésentation de l'étape sous forme de polyligne encodée. Il s'agit d'un tracé approximatif (lissé) de l'étape. |
end_location |
Type :
LatLngEmplacement de fin de cette étape. |
|
Type :
LatLngEmplacement de fin de cette étape. |
instructions |
Type :
stringInstructions pour cette étape. |
|
Séquence de LatLng décrivant le tracé de cette étape. Il s'agit d'un tracé approximatif (lissé) de l'étape. |
maneuver |
Type :
stringContient 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 tracé de cette étape. Il s'agit d'un tracé approximatif (lissé) de l'étape. |
start_location |
Type :
LatLngEmplacement de départ de cette étape. |
|
Type :
LatLngEmplacement de départ de cette étape. |
travel_mode |
Type :
TravelModeMode de transport utilisé pour cette étape. |
distance
facultatif |
Type :
Distance optionalDistance couverte par cette étape. Cette propriété peut être undefined, car la distance peut être inconnue. |
duration
facultatif |
Type :
Duration optionalTemps 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. |
facultatif |
Type :
DirectionsPolyline optionalContient un objet avec une seule propriété, "points", qui comprend une représentation de l'étape sous forme de polyligne encodée. Cette polyligne est un tracé approximatif (lissé) de l'étape. |
steps
facultatif |
Type :
Array<DirectionsStep> optionalSous-étapes de cette étape. Spécifié pour les sections sans transport en commun des itinéraires en transports en commun. |
transit
facultatif |
Type :
TransitDetails optionalInformations spécifiques aux transports en commun concernant cette étape. Cette propriété n'est pas définie, sauf si le mode de transport de cette étape est TRANSIT. |
transit_details
facultatif |
Type :
TransitDetails optionalInformations concernant cette étape si le mode de transport est TRANSIT. |
Interface DirectionsPolyline
interface
google.maps.DirectionsPolyline
Objet contenant une propriété points pour décrire la polyligne d'un DirectionsStep.
Propriétés | |
|---|---|
points |
Type :
stringUne polyligne 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, un "lieu" désigne un établissement, un point d'intérêt ou un emplacement géographique. Pour en savoir plus sur la récupération d'informations sur un lieu, consultez .PlacesService
Propriétés | |
|---|---|
location
facultatif |
Type :
LatLng|LatLngLiteral optionalLatLng de l'entité décrite par ce lieu. |
placeId
facultatif |
Type :
string optionalID de lieu (par exemple, un établissement ou un point d'intérêt). 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. Vous pouvez récupérer un ID de lieu à partir de n'importe quelle requête envoyée à l'API Places, comme TextSearch. Les ID de lieu peuvent également être récupérés à partir de requêtes envoyées à l'API Geocoding. Pour en savoir plus, consultez la présentation des ID de lieu. |
query
facultatif |
Type :
string optionalRequête de recherche décrivant le lieu (par exemple, 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 l'exactitude de la résolution de la chaîne de requête en un lieu. Si les deux options placeId et query sont fournies, une erreur se produit. |
TravelMode
google.maps.TravelMode
bibliothèque "routes"
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.
Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type TravelModeString.
const {TravelMode} = await google.maps.importLibrary("routes");
Constantes | |
|---|---|
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éraire en transports en commun. |
|
Spécifie une demande d'itinéraire pour deux-roues. |
WALKING |
Spécifie une demande d'itinéraire à pied. |
DrivingOptions interface
interface
google.maps.DrivingOptions
Configure le DirectionsRequest lorsque le mode de transport est défini sur DRIVING.
Propriétés | |
|---|---|
departureTime |
Type :
DateHeure de départ souhaitée pour l'itinéraire, spécifiée sous la forme d'un 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
facultatif |
Type :
TrafficModel optionalHypothèse à utiliser de préférence pour prédire la durée du trajet en fonction du trafic. La valeur par défaut est BEST_GUESS. |
TrafficModel
google.maps.TrafficModel
bibliothèque "routes"
Hypothèses à utiliser pour prédire la durée du trajet en fonction du 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.
Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type TrafficModelString.
const {TrafficModel} = await google.maps.importLibrary("routes");
Constantes | |
|---|---|
BEST_GUESS |
Utilisez l'historique des données de trafic pour estimer au mieux le temps passé dans les embouteillages. |
OPTIMISTIC |
Utilisez l'historique des données de trafic pour estimer de manière optimiste la durée du trajet en fonction du trafic. |
PESSIMISTIC |
Utilisez les données de trafic historiques pour estimer de manière pessimiste la durée du trajet en fonction du trafic. |
Interface TransitOptions
interface
google.maps.TransitOptions
Objet TransitOptions à inclure dans un DirectionsRequest lorsque le mode de transport est défini sur TRANSIT.
Propriétés | |
|---|---|
arrivalTime
facultatif |
Type :
Date optionalHeure 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
facultatif |
Type :
Date optionalHeure 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 définie sur "maintenant". |
modes
facultatif |
Type :
Array<TransitMode> optionalUn 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
facultatif |
Type :
TransitRoutePreference optionalPréférence pouvant 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
bibliothèque "routes"
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.
Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type TransitModeString.
const {TransitMode} = await google.maps.importLibrary("routes");
Constantes | |
|---|---|
BUS |
Spécifie le bus comme mode de transport à privilégier. |
|
Spécifie le métro léger 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
bibliothèque "routes"
Type d'itinéraire 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.
Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type TransitRoutePreferenceString.
const {TransitRoutePreference} = await google.maps.importLibrary("routes");
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é d'une valeur et d'une devise.
Propriétés | |
|---|---|
currency |
Type :
stringCode de devise ISO 4217 indiquant la devise dans laquelle le tarif est exprimé. |
text |
Type :
stringValeur du tarif, exprimée dans la devise currency donnée, sous forme de chaîne. |
value |
Type :
numberValeur numérique du tarif, exprimée dans la devise currency indiquée. |
Interface TransitDetails
interface
google.maps.TransitDetails
Informations sur le départ, l'arrivée et le mode de transport utilisé à cette étape.
Propriétés | |
|---|---|
arrival_stop |
Type :
TransitStopArrêt d'arrivée de cette étape de transport en commun. |
arrival_time |
Type :
TimeHeure d'arrivée de cette étape, spécifiée en tant qu'objet Time. |
departure_stop |
Type :
TransitStopArrêt de départ de cette étape de transport en commun. |
departure_time |
Type :
TimeHeure de départ de cette étape, spécifiée en tant qu'objet Time. |
headsign |
Type :
stringSens du trajet sur cette ligne tel qu'indiqué sur le véhicule ou à l'arrêt de départ. |
headway |
Type :
numberNombre de secondes estimé entre deux véhicules équivalents à cet arrêt. |
line |
Type :
TransitLineDétails sur la ligne de transports en commun utilisée à cette étape. |
num_stops |
Type :
numberNombre d'arrêts pour cette étape. L'arrêt d'arrivée est inclus, mais pas celui de départ. |
trip_short_name |
Type :
stringTexte qui apparaît dans les horaires et sur les panneaux d'affichage pour identifier un trajet en transports en commun pour les passagers (par exemple, 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 :
LatLngEmplacement de cet arrêt. |
name |
Type :
stringNom de cet arrêt de transports en commun. |
TransitLine
interface
google.maps.TransitLine
Informations sur la ligne de transports en commun qui effectue cette étape.
Propriétés | |
|---|---|
agencies |
Type :
Array<TransitAgency>L'agence de transports en commun qui exploite cette ligne de transports en commun. |
color |
Type :
stringCouleur communément utilisée pour la signalisation de cette ligne de transports en commun, représentée par une chaîne hexadécimale. |
icon |
Type :
stringURL d'une icône associée à cette ligne. |
name |
Type :
stringNom complet de la ligne de transports en commun, par exemple "8 Avenue Local". |
short_name |
Type :
stringNom court de cette ligne de transports en commun (par exemple, "E"). |
text_color |
Type :
stringCouleur du texte couramment utilisée pour désigner cette ligne, représentée par une chaîne hexadécimale. |
url |
Type :
stringURL de l'agence spécifique à cette ligne de transports en commun. |
vehicle |
Type :
TransitVehicleType de véhicule utilisé (par exemple, train ou bus). |
TransitAgency
interface
google.maps.TransitAgency
Informations sur une agence qui gère une ligne de transports en commun.
Propriétés | |
|---|---|
name |
Type :
stringNom de cette agence de transports en commun. |
phone |
Type :
stringNuméro de téléphone de l'agence de transports en commun. |
url |
Type :
stringURL 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.
Propriétés | |
|---|---|
icon |
Type :
stringURL d'une icône correspondant au type de véhicule utilisé sur cette ligne. |
local_icon |
Type :
stringURL 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 :
stringNom de ce type de TransitVehicle, par exemple "Train" ou "Bus". |
type |
Type :
VehicleTypeType de véhicule utilisé (par exemple, train, bus ou ferry). |
Constantes VehicleType
google.maps.VehicleType
bibliothèque "routes"
Valeurs possibles pour les types de véhicules.
Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type VehicleTypeString.
const {VehicleType} = await google.maps.importLibrary("routes");
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 |
Type de bus pouvant faire monter et descendre des passagers n'importe où sur son trajet. En général, les taxis partagés utilisent des minibus. |
SUBWAY |
Métro léger souterrain. |
TRAM |
Métro léger en surface. |
TROLLEYBUS |
Trolleybus. |
UnitSystem constantes
google.maps.UnitSystem
bibliothèque "core"
Systèmes d'unités valides pouvant être spécifiés dans un DirectionsRequest.
const {UnitSystem} = await google.maps.importLibrary("core");
Constantes | |
|---|---|
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. |
Distance interface
interface
google.maps.Distance
Représentation de la distance sous forme de valeur numérique et de chaîne d'affichage.
Propriétés | |
|---|---|
text |
Type :
stringReprésentation sous forme de chaîne de la valeur de distance, à l'aide de l'élément UnitSystem spécifié dans la requête. |
value |
Type :
numberDistance en mètres. |
Interface Duration
interface
google.maps.Duration
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 :
stringReprésentation sous forme de chaîne de la valeur de la durée. |
value |
Type :
numberDurée en secondes. |
Interface Time
interface
google.maps.Time
Représentation de l'heure sous la forme d'un objet Date, d'une chaîne localisée et d'un fuseau horaire.
Propriétés | |
|---|---|
text |
Type :
stringChaî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 :
stringFuseau 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 :
DateHeure de ce départ ou de cette arrivée, spécifiée en tant qu'objet Date JavaScript. |