Maps

Classe Map

Classe google.maps.Map

Cette classe étend MVCObject.

Accédez-y en appelant const {Map} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Map
Map(mapDiv[, opts])
Paramètres:
  • mapDivHTMLElement La carte s'affichera pour remplir cet élément.
  • opts:  options MapOptions optional
Crée une nouvelle carte à l'intérieur du conteneur HTML donné, qui est généralement un élément DIV.
DEMO_MAP_ID ID de carte pouvant être utilisé pour les exemples de code qui en ont besoin. Cet ID de carte n'est pas destiné à être utilisé dans des applications de production et ne peut pas être utilisé pour les fonctionnalités qui nécessitent une configuration dans le cloud (comme le style Cloud).
controls
Commandes supplémentaires à associer à la carte. Pour ajouter une commande à la carte, ajoutez le <div> de la commande au MVCArray correspondant à la ControlPosition où elle doit s'afficher.
data
Type:Data
Instance de Data, liée à la carte. Ajoutez des éléments à cet objet Data pour les afficher facilement sur cette carte.
mapTypes
Registre des instances MapType par ID de chaîne.
overlayMapTypes
Type:MVCArray<MapType optional>
Types de cartes supplémentaires à superposer. Les types de carte de superposition s'affichent par-dessus la carte de base à laquelle ils sont associés, dans l'ordre dans lequel ils apparaissent dans le tableau overlayMapTypes (les superpositions avec des valeurs d'index plus élevées sont affichées devant celles avec des valeurs d'index plus faibles).
fitBounds
fitBounds(bounds[, padding])
Paramètres:
  • boundsLatLngBounds|LatLngBoundsLiteral Limites à afficher.
  • padding:  marge intérieure number|Padding optional en pixels. Les limites s'adapteront à la partie de la carte qui reste après la suppression de la marge intérieure. Une valeur numérique génère la même marge intérieure sur les quatre côtés. Indiquez ici 0 pour rendre fitBounds idempotente sur le résultat de getBounds.
Valeur renvoyée:aucune
Définit la fenêtre d'affichage pour qu'elle contienne les limites données.
Remarque:Lorsque la carte est définie sur display: none, la fonction fitBounds lit la taille de la carte comme étant 0x0 et ne fait donc rien. Pour modifier la fenêtre d'affichage lorsque la carte est masquée, définissez la carte sur visibility: hidden, ce qui garantit que le div de la carte a une taille réelle. Pour les cartes vectorielles, cette méthode définit l'inclinaison et l'orientation de la carte sur leurs valeurs par défaut de zéro. L'appel de cette méthode peut entraîner une animation fluide lorsque la carte fait un panoramique et un zoom pour s'adapter aux limites. L'animation de cette méthode dépend d'une heuristique interne.
getBounds
getBounds()
Paramètres:aucun
Valeur renvoyée:LatLngBounds|undefined Les limites de latitude/longitude de la fenêtre d'affichage actuelle.
Renvoie les limites de latitude/longitude de la fenêtre d'affichage actuelle. Si plusieurs copies du monde sont visibles, la plage de longitude est comprise entre -180 et 180 degrés, inclus. Si la carte n'est pas encore initialisée ou si le centre et le zoom n'ont pas été définis, le résultat est undefined. Pour les cartes vectorielles dont l'inclinaison ou le cap ne sont pas nuls, les limites de latitude/longitude renvoyées représentent le plus petit cadre de délimitation qui comprend la région visible de la fenêtre d'affichage de la carte. Consultez MapCanvasProjection.getVisibleRegion pour obtenir la région visible exacte de la fenêtre d'affichage de la carte.
getCenter
getCenter()
Paramètres:aucun
Valeur renvoyée:LatLng|undefined
Renvoie la position affichée au centre de la carte. Notez que cet objet LatLng n'est pas encapsulé. Pour en savoir plus, consultez LatLng. Si le centre ou les limites n'ont pas été définis, le résultat est undefined.
getClickableIcons
getClickableIcons()
Paramètres:aucun
Valeur renvoyée:boolean|undefined
Indique si les icônes de la carte sont cliquables. Une icône de carte représente un point d'intérêt (POI). Si la valeur renvoyée est true, les icônes sont cliquables sur la carte.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Paramètres:
  • datasetIdstring
Valeur renvoyée:FeatureLayer
Renvoie la FeatureLayer pour la datasetId spécifiée. Les ID d'ensemble de données doivent être configurés dans la console Google Cloud. Si l'ID de l'ensemble de données n'est pas associé au style de la carte ou si le style basé sur les données n'est pas disponible (aucun ID de carte, aucune carte vectorielle, aucun calque d'éléments géographiques de style basé sur les données ni aucun ensemble de données configuré dans le style de la carte), une erreur est enregistrée et la valeur FeatureLayer.isAvailable générée est fausse.
getDiv
getDiv()
Paramètres:aucun
Valeur renvoyée:HTMLElement La mapDiv de la carte.
getFeatureLayer
getFeatureLayer(featureType)
Paramètres:
Valeur renvoyée:FeatureLayer
Renvoie le FeatureLayer de la FeatureType spécifique. Un FeatureLayer doit être activé dans la console Google Cloud. Si un FeatureLayer de l'FeatureType spécifié n'existe pas sur cette carte ou si le style basé sur les données n'est pas disponible (aucun ID de carte, aucune carte vectorielle et aucun FeatureLayer activé dans le style de la carte), une erreur est enregistrée et le FeatureLayer.isAvailable généré est faux.
getHeading
getHeading()
Paramètres:aucun
Valeur renvoyée:number|undefined
Renvoie la direction indiquée par la boussole sur la carte. La valeur du cap est mesurée en degrés (dans le sens des aiguilles d'une montre) à partir du point cardinal nord. Si la carte n'est pas encore initialisée, le résultat est undefined.
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
Paramètres:aucun
Valeur renvoyée:boolean|null
Indique si les interactions avec les titres sont activées. Cette option n'est effective que si la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de la carte est utilisée (si elle est disponible).
getMapCapabilities
getMapCapabilities()
Paramètres:aucun
Valeur renvoyée:MapCapabilities
Informe l'appelant des fonctionnalités actuellement disponibles pour la carte en fonction de l'ID de carte fourni.
getMapTypeId
getMapTypeId()
Paramètres:aucun
Valeur renvoyée:MapTypeId|string|undefined
getProjection
getProjection()
Paramètres:aucun
Valeur renvoyée:Projection|undefined
Renvoie l'Projection actuelle. Si la carte n'est pas encore initialisée, le résultat est undefined. Écoutez l'événement projection_changed et vérifiez sa valeur pour vous assurer qu'elle n'est pas undefined.
getRenderingType
getRenderingType()
Paramètres:aucun
Valeur renvoyée:RenderingType
Renvoie le RenderingType actuel de la carte.
getStreetView
getStreetView()
Paramètres:aucun
Valeur renvoyée:StreetViewPanorama Panorama associé à la carte.
Renvoie l'StreetViewPanorama par défaut associé à la carte, qui peut être un panorama par défaut intégré à la carte ou le panorama défini à l'aide de setStreetView(). Les modifications apportées à la streetViewControl de la carte seront répercutées dans l'affichage d'un tel panorama limité.
getTilt
getTilt()
Paramètres:aucun
Valeur renvoyée:number|undefined
Renvoie l'angle d'incidence actuel de la carte, en degrés, du plan de la fenêtre d'affichage au plan de la carte. Pour les cartes matricielles, le résultat sera 0 pour les images prises directement au-dessus ou 45 pour les images à 45°. Cette méthode ne renvoie pas la valeur définie par setTilt. Pour en savoir plus, consultez setTilt.
getTiltInteractionEnabled
getTiltInteractionEnabled()
Paramètres:aucun
Valeur renvoyée:boolean|null
Indique si les interactions d'inclinaison sont activées. Cette option n'est effective que si la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de la carte est utilisée (si elle est disponible).
getZoom
getZoom()
Paramètres:aucun
Valeur renvoyée:number|undefined
Renvoie le zoom de la carte. Si le zoom n'a pas été défini, le résultat est undefined.
moveCamera
moveCamera(cameraOptions)
Paramètres:
Valeur renvoyée:aucune
Définit immédiatement la caméra de la carte sur les options de caméra cible, sans animation.
panBy
panBy(x, y)
Paramètres:
  • xnumber Nombre de pixels à déplacer la carte dans la direction X.
  • ynumber Nombre de pixels à déplacer la carte dans la direction Y.
Valeur renvoyée:aucune
Déplace le centre de la carte de la distance donnée en pixels. Si la distance est inférieure à la largeur et à la hauteur de la carte, la transition sera animée de manière fluide. Notez que le système de coordonnées de la carte augmente d'ouest en est (pour les valeurs x) et du nord au sud (pour les valeurs y).
panTo
panTo(latLng)
Paramètres:
Valeur renvoyée:aucune
Définit le centre de la carte sur l'LatLng donné. Si la modification est inférieure à la largeur et à la hauteur de la carte, la transition sera animée de manière fluide.
panToBounds
panToBounds(latLngBounds[, padding])
Paramètres:
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral Limites vers lesquelles faire un panoramique de la carte.
  • padding:  marge intérieure number|Padding optional en pixels. Une valeur numérique génère la même marge intérieure sur les quatre côtés. La valeur par défaut est 0.
Valeur renvoyée:aucune
Fait un panoramique sur la carte de la quantité minimale nécessaire pour contenir l'LatLngBounds donnée. Il n'est pas garanti que les limites se trouvent à un endroit précis de la carte, sauf que la carte sera panoramique pour afficher autant que possible les limites dans {currentMapSizeInPx} - {padding}. Pour les cartes matricielles et vectorielles, le zoom, l'inclinaison et le cap de la carte ne changent pas.
setCenter
setCenter(latlng)
Paramètres:
Valeur renvoyée:aucune
setClickableIcons
setClickableIcons(value)
Paramètres:
  • valueboolean
Valeur renvoyée:aucune
Indique si les icônes de la carte sont cliquables ou non. Une icône de carte représente un point d'intérêt (POI). Pour désactiver la possibilité de cliquer sur les icônes de la carte, transmettez une valeur de false à cette méthode.
setHeading
setHeading(heading)
Paramètres:
  • headingnumber
Valeur renvoyée:aucune
Définit l'orientation de la boussole pour la carte, mesurée en degrés à partir de la direction cardinale nord. Pour les cartes matricielles, cette méthode ne s'applique qu'aux images aériennes.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
Paramètres:
  • headingInteractionEnabledboolean
Valeur renvoyée:aucune
Indique si les interactions avec les titres sont activées. Cette option n'est effective que si la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de la carte est utilisée (si elle est disponible).
setMapTypeId
setMapTypeId(mapTypeId)
Paramètres:
Valeur renvoyée:aucune
setOptions
setOptions(options)
Paramètres:
Valeur renvoyée:aucune
setRenderingType
setRenderingType(renderingType)
Paramètres:
Valeur renvoyée:aucune
Définit le RenderingType actuel de la carte.
setStreetView
setStreetView(panorama)
Paramètres:
Valeur renvoyée:aucune
Associe un StreetViewPanorama à la carte. Ce panorama remplace le StreetViewPanorama par défaut, ce qui permet à la carte de se lier à un panorama externe en dehors de la carte. Définir le panorama sur null lie le panorama intégré par défaut à la carte.
setTilt
setTilt(tilt)
Paramètres:
  • tiltnumber
Valeur renvoyée:aucune
Pour les cartes vectorielles, définit l'angle d'incidence de la carte. Les valeurs autorisées sont limitées en fonction du niveau de zoom de la carte.

Pour les cartes matricielles, contrôle le comportement de commutation automatique pour l'angle d'incidence de la carte. Les seules valeurs autorisées sont 0 et 45. setTilt(0) oblige la carte à utiliser toujours une vue aérienne à 0°, quel que soit le niveau de zoom et la fenêtre d'affichage. setTilt(45) fait passer automatiquement l'angle d'inclinaison à 45° chaque fois qu'une image à 45° est disponible pour le niveau de zoom et la fenêtre d'affichage actuels, et le rétablit à 0 chaque fois qu'une image à 45° n'est pas disponible (il s'agit du comportement par défaut). Les images à 45° ne sont disponibles que pour les types de carte satellite et hybrid, dans certaines zones géographiques et à certains niveaux de zoom. Remarque:getTilt renvoie l'angle d'inclinaison actuel, et non la valeur définie par setTilt. Étant donné que getTilt et setTilt font référence à des éléments différents, ne bind() pas la propriété tilt, car cela pourrait avoir des effets imprévisibles.
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
Paramètres:
  • tiltInteractionEnabledboolean
Valeur renvoyée:aucune
Indique si les interactions d'inclinaison sont activées. Cette option n'est effective que si la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de la carte est utilisée (si elle est disponible).
setZoom
setZoom(zoom)
Paramètres:
  • zoomnumber Plus la valeur de zoom est élevée, plus la résolution est élevée.
Valeur renvoyée:aucune
Définit le zoom de la carte.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque les limites de la fenêtre d'affichage ont changé.
center_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété du centre de la carte change.
click
function(event)
Arguments: 
Cet événement se déclenche lorsque l'utilisateur clique sur la carte. Un MapMouseEvent avec des propriétés pour l'emplacement sur lequel l'utilisateur a cliqué est renvoyé, sauf si l'utilisateur a cliqué sur une icône de lieu, auquel cas un IconMouseEvent avec un ID de lieu est renvoyé. IconMouseEvent et MapMouseEvent sont identiques, à l'exception du champ "ID de lieu" dans IconMouseEvent. L'événement peut toujours être traité comme un MapMouseEvent lorsque l'ID de lieu n'est pas important. L'événement de clic n'est pas déclenché si l'utilisateur a cliqué sur un repère ou une fenêtre d'informations.
contextmenu
function(event)
Arguments: 
Cet événement est déclenché lorsque l'événement DOM contextmenu est déclenché sur le conteneur de la carte.
dblclick
function(event)
Arguments: 
Cet événement se déclenche lorsque l'utilisateur double-clique sur la carte. Notez que l'événement de clic se déclenche parfois une fois, parfois deux fois, juste avant celui-ci.
drag
function()
Arguments:aucun
Cet événement est déclenché à plusieurs reprises pendant que l'utilisateur fait glisser la carte.
dragend
function()
Arguments:aucun
Cet événement se déclenche lorsque l'utilisateur arrête de faire glisser la carte.
dragstart
function()
Arguments:aucun
Cet événement est déclenché lorsque l'utilisateur commence à faire glisser la carte.
heading_changed
function()
Arguments:aucun
Cet événement se déclenche lorsque la propriété "Heading" (Orientation) de la carte change.
idle
function()
Arguments:aucun
Cet événement est déclenché lorsque la carte devient inactive après un panoramique ou un zoom.
isfractionalzoomenabled_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété isFractionalZoomEnabled a changé.
mapcapabilities_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque les fonctionnalités de la carte changent.
maptypeid_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété mapTypeId change.
mousemove
function(event)
Arguments: 
Cet événement se déclenche chaque fois que la souris de l'utilisateur passe sur le conteneur de la carte.
mouseout
function(event)
Arguments: 
Cet événement se déclenche lorsque la souris de l'utilisateur quitte le conteneur de la carte.
mouseover
function(event)
Arguments: 
Cet événement se déclenche lorsque la souris de l'utilisateur entre dans le conteneur de la carte.
projection_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la projection a changé.
renderingtype_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque le paramètre "renderingType" a changé.
tilesloaded
function()
Arguments:aucun
Cet événement est déclenché lorsque les cartes visibles ont fini de se charger.
tilt_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété d'inclinaison de la carte change.
zoom_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété de zoom de la carte change.
rightclick
function(event)
Arguments: 
Cet événement se déclenche lorsque l'utilisateur effectue un clic droit sur la carte.

Interface MapOptions

Interface google.maps.MapOptions

Objet MapOptions utilisé pour définir les propriétés pouvant être définies sur une carte.

backgroundColor optional
Type:string optional
Couleur utilisée pour l'arrière-plan du div de la carte. Cette couleur est visible lorsque les tuiles ne sont pas encore chargées lorsque l'utilisateur fait un panoramique. Cette option ne peut être définie que lorsque la carte est initialisée.
center optional
Type:LatLng|LatLngLiteral optional
Centre initial de la carte.
clickableIcons optional
Type:boolean optional
Par défaut:true
Lorsque la valeur est false, les icônes de la carte ne sont pas cliquables. Une icône de carte représente un point d'intérêt (POI).
BetacolorScheme optional
Type:ColorScheme|string optional
Par défaut:ColorScheme.LIGHT
Jeu de couleurs initial de la carte. Cette option ne peut être définie que lorsque la carte est initialisée.
controlSize optional
Type:number optional
Taille en pixels des commandes qui s'affichent sur la carte. Cette valeur doit être fournie directement lors de la création de la carte. La mise à jour de cette valeur ultérieurement peut entraîner un état undefined des commandes. Ne régit que les commandes effectuées par l'API Maps elle-même. Ne met pas à l'échelle les commandes personnalisées créées par le développeur.
disableDefaultUI optional
Type:boolean optional
Active/désactive tous les boutons de l'interface utilisateur par défaut. Peut être ignoré individuellement. Ne désactive pas les commandes du clavier, qui sont contrôlées séparément par l'option MapOptions.keyboardShortcuts. Ne désactive pas les commandes gestuelles, qui sont contrôlées séparément par l'option MapOptions.gestureHandling.
disableDoubleClickZoom optional
Type:boolean optional
Active/Désactive le zoom et le centrage en cas de double-clic. Cette option est activée par défaut.

Remarque: Cette propriété n'est pas recommandée. Pour désactiver le zoom en double-cliquant, vous pouvez utiliser la propriété gestureHandling et la définir sur "none".

draggable optional
Type:boolean optional
Si la valeur est false, empêche le déplacement de la carte. Le glisser-déposer est activé par défaut.
draggableCursor optional
Type:string optional
Nom ou URL du curseur à afficher lorsque vous pointez sur une carte déplaçable. Cette propriété utilise l'attribut CSS cursor pour modifier l'icône. Comme pour la propriété CSS, vous devez spécifier au moins un curseur de remplacement qui n'est pas une URL. Exemple : draggableCursor: 'url(http://www.example.com/icon.png), auto;'.
draggingCursor optional
Type:string optional
Nom ou URL du curseur à afficher lorsque la carte est déplacée. Cette propriété utilise l'attribut CSS cursor pour modifier l'icône. Comme pour la propriété CSS, vous devez spécifier au moins un curseur de remplacement qui n'est pas une URL. Exemple : draggingCursor: 'url(http://www.example.com/icon.png), auto;'.
fullscreenControl optional
Type:boolean optional
État activé/désactivé de la commande Plein écran.
fullscreenControlOptions optional
Options d'affichage de la commande de plein écran.
gestureHandling optional
Type:string optional
Ce paramètre contrôle la façon dont l'API gère les gestes sur la carte. Valeurs autorisées:
  • "cooperative": les événements de défilement et les gestes tactiles à un doigt font défiler la page, mais ne permettent pas de faire un zoom ni un panoramique sur la carte. Les gestes tactiles à deux doigts permettent de faire un panoramique et un zoom sur la carte. Les événements de défilement avec la touche Ctrl ou ⌘ permettent de faire un zoom sur la carte.
    Dans ce mode, la carte coopère avec la page.
  • "greedy": tous les gestes tactiles et événements de défilement permettent de faire un panoramique ou un zoom sur la carte.
  • "none": l'utilisateur ne peut pas faire de panoramique ni de zoom sur la carte à l'aide de gestes.
  • "auto" (par défaut) : la gestion des gestes est coopérative ou gourmande, selon que la page est à faire défiler ou dans une iFrame.
heading optional
Type:number optional
Orientation des images aériennes en degrés, mesurée dans le sens des aiguilles d'une montre à partir du nord. Les titres sont alignés sur l'angle le plus proche pour lequel des images sont disponibles.
headingInteractionEnabled optional
Type:boolean optional
Par défaut:false
Indique si la carte doit permettre à l'utilisateur de contrôler l'orientation de la caméra (rotation). Cette option n'est effective que si la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de la carte est utilisée (si elle est disponible).
isFractionalZoomEnabled optional
Type:boolean optional
Par défaut:true pour les cartes vectorielles et false pour les cartes matricielles
Indique si la carte doit autoriser les niveaux de zoom fractionnaires. Écoutez isfractionalzoomenabled_changed pour savoir quand la valeur par défaut a été définie.
keyboardShortcuts optional
Type:boolean optional
Si la valeur est false, empêche la carte d'être contrôlée par le clavier. Les raccourcis clavier sont activés par défaut.
mapId optional
Type:string optional
ID de carte de la carte. Ce paramètre ne peut pas être défini ni modifié une fois une carte instanciée. Map.DEMO_MAP_ID permet d'essayer des fonctionnalités qui nécessitent un ID de carte, mais qui ne nécessitent pas d'activer le cloud.
mapTypeControl optional
Type:boolean optional
État initial d'activation/de désactivation de la commande de type de carte.
mapTypeControlOptions optional
Type:MapTypeControlOptions optional
Options d'affichage initiales pour la commande de type de carte.
mapTypeId optional
Type:MapTypeId|string optional
MapTypeId de la carte initiale. La valeur par défaut est ROADMAP.
maxZoom optional
Type:number optional
Niveau de zoom maximal qui s'affichera sur la carte. Si elle est omise ou définie sur null, le zoom maximal du type de carte actuel est utilisé à la place. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal accepté.
minZoom optional
Type:number optional
Niveau de zoom minimal qui s'affichera sur la carte. Si cet élément est omis ou défini sur null, le zoom minimal du type de carte actuel est utilisé à la place. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal accepté.
noClear optional
Type:boolean optional
Si la valeur est true, ne videz pas le contenu de la section div de la carte.
panControl optional
Type:boolean optional
État activé/désactivé de la commande de panoramique.

panControlOptions optional
Type:PanControlOptions optional
Options d'affichage pour la commande de panoramique.

renderingType optional
Type:RenderingType optional
Indique si la carte doit être matricielle ou vectorielle. Ce paramètre ne peut pas être défini ni modifié une fois une carte instanciée. Si ce n'est pas le cas, la configuration cloud de l'ID de la carte déterminera le type de rendu (le cas échéant). Notez que les cartes vectorielles ne sont pas forcément disponibles pour tous les appareils et tous les navigateurs. Si nécessaire, la carte basculera vers une carte matricielle.
restriction optional
Type:MapRestriction optional
Définit une limite qui limite la zone de la carte accessible aux utilisateurs. Lorsqu'il est défini, un utilisateur ne peut effectuer un panoramique et un zoom que lorsque la vue de la caméra reste dans les limites de la limite.
rotateControl optional
Type:boolean optional
État activé/désactivé de la commande de rotation.
rotateControlOptions optional
Type:RotateControlOptions optional
Options d'affichage de la commande de rotation.
scaleControl optional
Type:boolean optional
État initial d'activation/de désactivation de la commande d'échelle.
scaleControlOptions optional
Type:ScaleControlOptions optional
Options d'affichage initiales pour la commande d'échelle.
scrollwheel optional
Type:boolean optional
Si la valeur est false, le zoom sur la carte est désactivé à l'aide de la molette de la souris. La molette de défilement est activée par défaut.

Remarque: Cette propriété n'est pas recommandée. Pour désactiver le zoom à l'aide de la molette de défilement, vous pouvez utiliser la propriété gestureHandling et la définir sur "cooperative" ou "none".

streetView optional
Type:StreetViewPanorama optional
StreetViewPanorama à afficher lorsque le Pegman Street View est placé sur la carte. Si aucun panorama n'est spécifié, un StreetViewPanorama par défaut s'affiche dans la div de la carte lorsque le Pegman est placé.
streetViewControl optional
Type:boolean optional
État initial (activé/désactivé) de la commande Pegman Street View. Cette commande fait partie de l'UI par défaut et doit être définie sur false lorsque vous affichez un type de carte sur lequel la superposition de routes Street View ne doit pas apparaître (par exemple, un type de carte autre qu'Earth).
streetViewControlOptions optional
Options d'affichage initiales pour la commande Pegman Street View.
styles optional
Type:Array<MapTypeStyle> optional
Styles à appliquer à chacun des types de carte par défaut. Notez que pour les modes satellite/hybrid et terrain, ces styles ne s'appliquent qu'aux libellés et à la géométrie. Cette fonctionnalité n'est pas disponible lorsque vous utilisez un ID de carte ou des cartes vectorielles (utilisez plutôt les styles de cartes basés dans le cloud).
tilt optional
Type:number optional
Pour les cartes vectorielles, définit l'angle d'incidence de la carte. Les valeurs autorisées sont limitées en fonction du niveau de zoom de la carte. Pour les cartes matricielles, contrôle le comportement de commutation automatique pour l'angle d'incidence de la carte. Les seules valeurs autorisées sont 0 et 45. La valeur 0 entraîne l'utilisation d'une vue aérienne à 0° sur la carte, quelle que soit la vue et le niveau de zoom. La valeur 45 fait passer automatiquement l'angle d'inclinaison à 45° chaque fois qu'une image à 45° est disponible pour le niveau de zoom et la vue actuelle, et le fait revenir à 0 chaque fois qu'une image à 45° n'est pas disponible (il s'agit du comportement par défaut). Les images à 45° ne sont disponibles que pour les types de carte satellite et hybrid, dans certaines zones géographiques et à certains niveaux de zoom. Remarque:getTilt renvoie l'angle d'inclinaison actuel, et non la valeur spécifiée par cette option. Étant donné que getTilt et cette option font référence à des éléments différents, n'bind() pas la propriété tilt, car cela pourrait entraîner des effets imprévisibles.
tiltInteractionEnabled optional
Type:boolean optional
Par défaut:false
Indique si la carte doit permettre à l'utilisateur de contrôler l'inclinaison de la caméra. Cette option n'est effective que si la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de la carte est utilisée (si elle est disponible).
zoom optional
Type:number optional
Niveau de zoom initial de la carte. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal accepté. Plus la valeur de zoom est élevée, plus la résolution est élevée.
zoomControl optional
Type:boolean optional
État activé/désactivé de la commande de zoom.
zoomControlOptions optional
Type:ZoomControlOptions optional
Options d'affichage de la commande de zoom.

Classe MapElement

Classe google.maps.MapElement

MapElement est une sous-classe HTMLElement permettant de générer des cartes. Après avoir chargé la bibliothèque maps, vous pouvez créer une carte en HTML. Exemple :

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

En interne, il utilise Map, auquel vous pouvez accéder avec la propriété innerMap.

Élément personnalisé:
<gmp-map center="lat,lng" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

Cette classe étend HTMLElement.

Cette classe implémente MapElementOptions.

Accédez-y en appelant const {MapElement} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

MapElement
MapElement([options])
Paramètres:
center
Type:LatLng|LatLngLiteral optional
Latitude/Longitude du centre de la carte.
Attribut HTML
    :
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
Type:boolean optional
Par défaut:false
Indique si la carte doit permettre à l'utilisateur de contrôler l'orientation de la caméra (rotation). Cette option n'est effective que si la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de la carte est utilisée (si elle est disponible).
Attribut HTML
    :
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
Type:Map
Référence au Map que MapElement utilise en interne.
mapId
Type:string optional
ID de carte de la carte. Ce paramètre ne peut pas être défini ni modifié une fois une carte instanciée. Map.DEMO_MAP_ID permet d'essayer des fonctionnalités qui nécessitent un ID de carte, mais qui ne nécessitent pas d'activer le cloud.
Attribut HTML
    :
  • <gmp-map map-id="string"></gmp-map>
renderingType
Type:RenderingType optional
Indique si la carte doit être matricielle ou vectorielle. Ce paramètre ne peut pas être défini ni modifié une fois une carte instanciée. Si ce n'est pas le cas, la configuration cloud de l'ID de la carte déterminera le type de rendu (le cas échéant). Notez que les cartes vectorielles ne sont pas forcément disponibles pour tous les appareils et tous les navigateurs. Si nécessaire, la carte basculera vers une carte matricielle.
Attribut HTML
    :
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
Type:boolean optional
Par défaut:false
Indique si la carte doit permettre à l'utilisateur de contrôler l'inclinaison de la caméra. Cette option n'est effective que si la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de la carte est utilisée (si elle est disponible).
Attribut HTML
    :
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
Type:number optional
Niveau de zoom de la carte. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal accepté. Plus la valeur de zoom est élevée, plus la résolution est élevée.
Attribut HTML
    :
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Place l'élément à fente à la position ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Place l'élément à fente à la position ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Place l'élément à fente à la position ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Place l'élément à fente à la position ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Place l'élément à fente à la position ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Place l'élément à fente à la position ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Place l'élément à fente à la position ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Place l'élément à fente à la position ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Place l'élément à fente à la position ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Place l'élément à fente à la position ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Place l'élément à fente à la position ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Place l'élément à fente à la position ControlPosition.INLINE_START_BLOCK_START.
default
Vous pouvez créer des composants réutilisables autour des composants Web JavaScript Maps, comme AdvancedMarkerElement, à l'aide d'éléments personnalisés. Par défaut, tous les éléments personnalisés ajoutés directement à MapElement sont placés et affichés dans MapPanes.overlayMouseTarget. Toutefois, les composants Web de l'API Maps JavaScript peuvent être réaffectés aux emplacements internes de MapElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres:
  • typestring chaîne sensible à la casse représentant le type d'événement à écouter.
  • listenerEventListener|EventListenerObject Objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • optionsboolean|AddEventListenerOptions optional Voir les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée:void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera envoyé à la cible. Voir addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres:
  • typestring Chaîne spécifiant le type d'événement pour lequel supprimer un écouteur d'événement.
  • listenerEventListener|EventListenerObject Écouteur d'événements du gestionnaire d'événements à supprimer de la cible d'événement.
  • optionsboolean|EventListenerOptions optional Voir les options
Valeur renvoyée:void
Supprime de la cible un écouteur d'événement précédemment enregistré avec addEventListener. Voir removeEventListener
gmp-zoomchange
function(event)
Arguments: 
Cet événement est déclenché lorsque la propriété de zoom de la carte change.

Interface MapElementOptions

Interface google.maps.MapElementOptions

Objet MapElementOptions utilisé pour définir les propriétés pouvant être définies sur un MapElement.

center optional
Type:LatLng|LatLngLiteral optional
Consultez les MapElement.center.
headingInteractionDisabled optional
Type:boolean optional
mapId optional
Type:string optional
Consultez les MapElement.mapId.
renderingType optional
Type:RenderingType optional
tiltInteractionDisabled optional
Type:boolean optional
zoom optional
Type:number optional
Consultez les MapElement.zoom.

Classe ZoomChangeEvent

Classe google.maps.ZoomChangeEvent

Cet événement est créé à partir de la modification du zoom de surveillance.

Cette classe étend Event.

Accédez-y en appelant const {ZoomChangeEvent} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Interface MapTypeStyle

Interface google.maps.MapTypeStyle

MapTypeStyle est un ensemble de sélecteurs et de styliseurs qui définissent le style de la carte. Les sélecteurs spécifient les éléments géographiques et/ou les éléments qui doivent être affectés, et les stylers spécifient comment ces éléments géographiques et/ou ces éléments doivent être modifiés. Pour en savoir plus, consultez la documentation de référence sur les styles.

stylers
Règles de style à appliquer aux éléments géographiques et aux éléments cartographiques sélectionnés. Les règles sont appliquées dans l'ordre que vous spécifiez dans ce tableau. Pour connaître les consignes d'utilisation et les valeurs autorisées, consultez la documentation de référence sur le style.
elementType optional
Type:string optional
Élément auquel un styleur doit être appliqué. Un élément est un aspect visuel d'un élément géographique sur la carte. (par exemple, un libellé, une icône, le trait ou le remplissage appliqué à la géométrie, etc.). Facultatif. Si elementType n'est pas spécifié, la valeur est considérée comme 'all'. Pour en savoir plus sur l'utilisation et les valeurs autorisées, consultez la documentation de référence sur le style.
featureType optional
Type:string optional
Élément géographique ou groupe d'éléments géographiques auquel un styleur doit être appliqué. Facultatif. Si featureType n'est pas spécifié, la valeur est considérée comme 'all'. Pour en savoir plus sur l'utilisation et les valeurs autorisées, consultez la documentation de référence sur le style.

Interface MapMouseEvent

Interface google.maps.MapMouseEvent

Cet objet est renvoyé à partir de divers événements de souris sur la carte et les superpositions, et contient tous les champs indiqués ci-dessous.

domEvent
Événement DOM natif correspondant. Les développeurs ne doivent pas s'appuyer sur la définition et la cohérence des propriétés target, currentTarget, relatedTarget et path. Les développeurs ne doivent pas non plus s'appuyer sur la structure DOM de l'implémentation interne de l'API Maps. En raison de la mise en correspondance des événements internes, la sémantique de domEvent peut être différente de celle de MapMouseEvent (par exemple, un "clic" MapMouseEvent peut avoir un domEvent de type KeyboardEvent).
latLng optional
Type:LatLng optional
Latitude/Longitude sous le curseur au moment de l'événement.
stop
stop()
Paramètres:aucun
Valeur renvoyée:void
Empêche la propagation de cet événement.

Interface IconMouseEvent

Interface google.maps.IconMouseEvent

Cet objet est envoyé dans un événement lorsqu'un utilisateur clique sur une icône sur la carte. L'ID de lieu de ce lieu est stocké dans le membre "placeId". Pour empêcher la fenêtre d'informations par défaut d'apparaître, appelez la méthode stop() sur cet événement pour l'empêcher de se propager. Pour en savoir plus sur les ID de lieu, consultez le guide du développeur de l'API Places.

Cette interface étend MapMouseEvent.

placeId optional
Type:string optional
ID du lieu ayant enregistré le clic. Cet ID de lieu peut être utilisé pour demander plus d'informations sur l'élément géographique sur lequel l'utilisateur a cliqué.

Pour en savoir plus sur les ID de lieu, consultez le guide du développeur de l'API Places.

Hérité: domEvent, latLng
Hérité: stop

Constantes ColorScheme

Constantes google.maps.ColorScheme

Identifiants des schémas de couleurs de la carte. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple, 'FOLLOW_SYSTEM' ou google.maps.ColorScheme.FOLLOW_SYSTEM.

Accédez-y en appelant const {ColorScheme} = await google.maps.importLibrary("core"). Consultez la section Bibliothèques de l'API Maps JavaScript.

DARK Jeu de couleurs sombre pour une carte.
FOLLOW_SYSTEM Le jeu de couleurs est sélectionné en fonction des préférences système.
LIGHT Jeu de couleurs clair pour une carte. Valeur par défaut pour l'ancienne version de Maps JS.

Constantes MapTypeId

Constantes google.maps.MapTypeId

Identifiants des MapTypes courants. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple, 'satellite' ou google.maps.MapTypeId.SATELLITE.

Accédez-y en appelant const {MapTypeId} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

HYBRID Ce type de carte affiche une couche transparente des principales rues sur des images satellite.
ROADMAP Ce type de carte affiche une carte routière normale.
SATELLITE Ce type de carte affiche des images satellite.
TERRAIN Ce type de carte affiche des cartes avec des éléments physiques tels que le relief et la végétation.

Classe MapTypeRegistry

Classe google.maps.MapTypeRegistry

Registre des instances MapType, indexé par l'ID MapType.

Cette classe étend MVCObject.

Accédez-y en appelant const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

MapTypeRegistry
MapTypeRegistry()
Paramètres:aucun
MapTypeRegistry contient la collection de types de cartes personnalisés disponibles pour la carte. L'API consulte ce registre lorsqu'elle fournit la liste des types de cartes disponibles dans les commandes, par exemple.
set
set(id, mapType)
Paramètres:
  • id:  identifiant string du MapType à ajouter au registre.
  • mapType:  objet MapType|* MapType à ajouter au Registre.
Valeur renvoyée:aucune
Définit le Registre pour associer l'identifiant de chaîne transmis au MapType transmis.
Hérité: addListener, bindTo, get, notify, setValues, unbind, unbindAll

Interface MapRestriction

Interface google.maps.MapRestriction

Restriction pouvant être appliquée à la carte. La fenêtre d'affichage de la carte ne dépassera pas ces restrictions.

latLngBounds
Lorsqu'il est défini, un utilisateur ne peut effectuer un panoramique et un zoom que dans les limites données. Les limites peuvent restreindre la longitude et la latitude, ou uniquement la latitude. Pour les limites de latitude uniquement, utilisez les longitudes ouest et est de -180 et 180, respectivement (par exemple, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}).
strictBounds optional
Type:boolean optional
Vous pouvez rendre les limites plus restrictives en définissant l'indicateur strictBounds sur true. Cela réduit le niveau de zoom que l'utilisateur peut appliquer, ce qui garantit que tout ce qui se trouve en dehors des limites restreintes reste masqué. La valeur par défaut est false, ce qui signifie qu'un utilisateur peut faire un zoom arrière jusqu'à ce que l'ensemble de la zone délimitée soit visible, y compris les zones situées en dehors de la zone délimitée.

Classe TrafficLayer

Classe google.maps.TrafficLayer

Un calque de trafic

Cette classe étend MVCObject.

Accédez-y en appelant const {TrafficLayer} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

TrafficLayer
TrafficLayer([opts])
Paramètres:
Calque affichant le trafic routier actuel.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:Map
Renvoie la carte sur laquelle cette couche est affichée.
setMap
setMap(map)
Paramètres:
Valeur renvoyée:aucune
Affiche le calque sur la carte spécifiée. Si la carte est définie sur null, le calque est supprimé.
setOptions
setOptions(options)
Paramètres:
Valeur renvoyée:aucune
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface TrafficLayerOptions

Interface google.maps.TrafficLayerOptions

Objet TrafficLayerOptions utilisé pour définir les propriétés pouvant être définies sur un TrafficLayer.

autoRefresh optional
Type:boolean optional
Par défaut:true
Indique si la couche de trafic s'actualise automatiquement avec des informations mises à jour.
map optional
Type:Map optional
Carte sur laquelle afficher le calque de trafic.

Classe TransitLayer

Classe google.maps.TransitLayer

Calque "Transports en commun".

Cette classe étend MVCObject.

Accédez-y en appelant const {TransitLayer} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

TransitLayer
TransitLayer()
Paramètres:aucun
Calque affichant les lignes de transports en commun.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:Map
Renvoie la carte sur laquelle cette couche est affichée.
setMap
setMap(map)
Paramètres:
Valeur renvoyée:aucune
Affiche le calque sur la carte spécifiée. Si la carte est définie sur null, le calque est supprimé.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Classe BicyclingLayer

Classe google.maps.BicyclingLayer

Calque montrant les bandes et les pistes cyclables.

Cette classe étend MVCObject.

Accédez-y en appelant const {BicyclingLayer} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

BicyclingLayer
BicyclingLayer()
Paramètres:aucun
Calque qui affiche les pistes cyclables et les voies et met en avant les grandes routes.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:Map
Renvoie la carte sur laquelle cette couche est affichée.
setMap
setMap(map)
Paramètres:
Valeur renvoyée:aucune
Affiche le calque sur la carte spécifiée. Si la carte est définie sur null, le calque est supprimé.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface CameraOptions

Interface google.maps.CameraOptions

Permet de définir les options de la caméra de la carte.

center optional
Type:LatLngLiteral|LatLng optional
heading optional
Type:number optional
tilt optional
Type:number optional
zoom optional
Type:number optional

Interface VisibleRegion

Interface google.maps.VisibleRegion

Contient les quatre points qui définissent le polygone à quatre côtés correspondant à la région visible de la carte. Sur une carte vectorielle, ce polygone peut être un trapèze au lieu d'un rectangle, lorsque la carte vectorielle est inclinée.

farLeft
Type:LatLng
farRight
Type:LatLng
latLngBounds
Plus petit cadre de délimitation incluant la région visible.
nearLeft
Type:LatLng
nearRight
Type:LatLng

Constantes RenderingType

Constantes google.maps.RenderingType

Accédez-y en appelant const {RenderingType} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

RASTER Indique que la carte est une carte matricielle.
UNINITIALIZED Indique que l'on ne sait pas encore si la carte est vectorielle ou matricielle, car elle n'a pas encore fini d'être initialisée.
VECTOR Indique que la carte est une carte vectorielle.

Interface MapCapabilities

Interface google.maps.MapCapabilities

Objet contenant un instantané des fonctionnalités actuellement disponibles pour la carte. Notez que cela ne signifie pas nécessairement que les modules pertinents sont chargés ou initialisés, mais plutôt que la carte actuelle est autorisée à utiliser ces API. Consultez les propriétés pour obtenir la liste des fonctionnalités possibles.

isAdvancedMarkersAvailable optional
Type:boolean optional
Si cette valeur est définie sur "true", cette carte est correctement configurée pour permettre l'utilisation de repères avancés. Notez que vous devez toujours importer la bibliothèque marker pour utiliser les repères avancés. Pour en savoir plus, consultez https://goo.gle/gmp-isAdvancedMarkersAvailable.
isDataDrivenStylingAvailable optional
Type:boolean optional
Si cette valeur est définie sur "true", cette carte est correctement configurée pour permettre l'utilisation d'un style basé sur les données pour au moins un calque d'éléments géographiques. Pour en savoir plus, consultez les pages https://goo.gle/gmp-data-driven-styling et https://goo.gle/gmp-FeatureLayerIsAvailable.
isWebGLOverlayViewAvailable optional
Type:boolean optional
Si la valeur est "True", cette carte est configurée correctement pour permettre l'utilisation de WebGLOverlayView.