Maps

Classe Map

Classe google.maps.Map

Cette classe étend MVCObject.

Accès en appelant const {Map} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques dans l'API Maps JavaScript.
Map
Map(mapDiv[, opts])
Paramètres: 
  • mapDiv:  HTMLElement La carte s'affiche pour remplir cet élément.
  • opts:  MapOptions optional Options
Crée une carte dans le conteneur HTML donné, qui est généralement un élément DIV.
DEMO_MAP_ID ID de carte qui peut être utilisé pour les exemples de code nécessitant un ID de carte. Cet ID de carte n'est pas destiné à être utilisé dans des applications de production. Il ne peut pas être utilisé pour les fonctionnalités qui nécessitent une configuration cloud (telles que les styles dans le cloud).
controls
Commandes supplémentaires à associer à la carte. Pour ajouter une commande à la carte, ajoutez son <div> au MVCArray correspondant à l'ControlPosition où elle doit être affichée.
data
Type:  Data
Instance de Data, associée à la carte. Ajoutez des éléments géographiques à cet objet Data pour les afficher facilement sur cette carte.
mapTypes
Registre d'instances MapType par ID de chaîne.
overlayMapTypes
Type:  MVCArray<MapType optional>
Types de carte supplémentaires à superposer. Les types de carte de superposition s'affichent au-dessus de 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 s'affichent devant celles avec des valeurs d'index plus faibles).
fitBounds
fitBounds(bounds[, padding])
Paramètres: 
  • bounds:  LatLngBounds|LatLngBoundsLiteral limites à afficher.
  • padding:  number|Padding optional Marge intérieure en pixels. Les limites s'adaptent à la partie restante de la carte après la suppression de la marge intérieure. Une valeur numérique produit la même marge intérieure sur les quatre côtés. Indiquez 0 ici pour que le paramètre FitBounds soit idempotent sur le résultat de getBounds.
Valeur renvoyée:Aucune
Définit la fenêtre d'affichage de sorte qu'elle contienne les limites indiquées.
Remarque:Lorsque la carte est définie sur display: none, la fonction fitBounds lit sa taille comme 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, de sorte que le div de la carte ait une taille réelle. Pour les cartes vectorielles, cette méthode définit l'inclinaison et l'orientation de la carte sur leurs valeurs zéro par défaut. L'appel de cette méthode peut générer une animation fluide, lorsque la carte effectue un panoramique et un zoom pour respecter les limites. L'animation de cette méthode dépend d'une heuristique interne.
getBounds
getBounds()
Paramètres:aucun
Valeur renvoyée:LatLngBounds|undefined. La limite de latitude et de 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 longitude des limites va de -180 à 180 degrés inclus. Si la carte n'est pas encore initialisée ou si elle n'a pas été centrée et zoomée, le résultat est undefined. Pour les cartes vectorielles dont l'inclinaison ou l'orientation sont différentes de zéro, les limites de latitude/longitude renvoyées représentent le plus petit cadre de délimitation qui inclut la zone 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
Renvoie la cliquabilité des icônes de la carte. Une icône de carte représente un point d'intérêt, également appelé POI. Si la valeur renvoyée est true, les icônes sont cliquables sur la carte.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Paramètres: 
  • datasetId:  string
Valeur renvoyée:  FeatureLayer
Renvoie la valeur FeatureLayer pour le datasetId spécifié. 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 carte de la carte, ou si le style basé sur les données n'est pas disponible (pas d'ID de carte, de tuiles de données vectorielles, de calques d'éléments géographiques basés sur les données ni d'ensembles de données configurés dans le style de carte), une erreur est consignée, et le FeatureLayer.isAvailable obtenu est "false".
getDiv
getDiv()
Paramètres:aucun
Valeur renvoyée : HTMLElement : mapDiv de la carte.
getFeatureLayer
getFeatureLayer(featureType)
Paramètres: 
Valeur renvoyée:  FeatureLayer
Renvoie la FeatureLayer du FeatureType spécifique. Un FeatureLayer doit être activé dans la console Google Cloud. Si aucun FeatureLayer du FeatureType spécifié n'existe sur cette carte, ou si le style basé sur les données n'est pas disponible (aucun ID de carte, aucune tuile de vecteur et aucun FeatureLayer activé dans le style de carte), cela génère une erreur et le FeatureLayer.isAvailable obtenu est "false".
getHeading
getHeading()
Paramètres:aucun
Valeur renvoyée:  number|undefined
Renvoie l'orientation de la boussole de la carte. La valeur de cap est mesurée en degrés (dans le sens des aiguilles d'une montre) à partir du nord en sens cardinal. Si la carte n'est pas encore initialisée, le résultat est undefined.
getMapCapabilities
getMapCapabilities()
Paramètres:aucun
Valeur renvoyée:  MapCapabilities
Informe l'appelant des capacités actuelles disponibles sur 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 la valeur 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'il ne s'agit pas de undefined.
getRenderingType
getRenderingType()
Paramètres:aucun
Valeur renvoyée:  RenderingType
Renvoie le RenderingType actuel de la carte.
getStreetView
getStreetView()
Paramètres:aucun
Return Value (Valeur renvoyée) : StreetViewPanorama Le panorama lié à la carte.
Renvoie le StreetViewPanorama par défaut lié à 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 au streetViewControl de la carte sont répercutées dans l'affichage de ce panorama lié.
getTilt
getTilt()
Paramètres:aucun
Valeur renvoyée:  number|undefined
Renvoie l'angle d'incidence actuel de la carte, en degrés, entre le plan de la fenêtre d'affichage et celui de la carte. Pour les cartes matricielles, le résultat sera 0 si les images sont 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.
getZoom
getZoom()
Paramètres:aucun
Valeur renvoyée:  number|undefined
Renvoie le niveau de 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 la caméra cible, sans animation.
panBy
panBy(x, y)
Paramètres: 
  • x:  number Nombre de pixels pour déplacer la carte dans la direction x.
  • y:  number Nombre de pixels pour déplacer la carte dans la direction Y.
Valeur renvoyée:Aucune
Modifie le centre de la carte en fonction de la distance donnée en pixels. Si la distance est inférieure à la largeur et à la hauteur de la carte, la transition s'animera de façon 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
Modifie le centre de la carte sur le LatLng indiqué. Si la modification est inférieure à la largeur et à la hauteur de la carte, la transition s'animera de façon fluide.
panToBounds
panToBounds(latLngBounds[, padding])
Paramètres: 
  • latLngBounds:  LatLngBounds|LatLngBoundsLiteral les limites sur lesquelles effectuer un panoramique de la carte.
  • padding:  number|Padding optional Marge intérieure en pixels. Une valeur numérique produit 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 selon le niveau minimal requis pour contenir l'élément LatLngBounds donné. Cela ne garantit pas l'emplacement des limites sur la carte, si ce n'est que la carte sera panoramique pour afficher le plus de limites possible dans {currentMapSizeInPx} - {padding}. Pour les cartes matricielles et vectorielles, le zoom, l'inclinaison et l'orientation de la carte ne sont pas modifiés.
setCenter
setCenter(latlng)
Paramètres: 
Valeur renvoyée:Aucune
setClickableIcons
setClickableIcons(value)
Paramètres: 
  • value:  boolean
Valeur renvoyée:Aucune
Détermine si les icônes de la carte sont cliquables ou non. Une icône de carte représente un point d'intérêt, également appelé POI. Pour désactiver la cliquabilité des icônes de carte, transmettez la valeur false à cette méthode.
setHeading
setHeading(heading)
Paramètres: 
  • heading:  number
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.
setMapTypeId
setMapTypeId(mapTypeId)
Paramètres: 
Valeur renvoyée:Aucune
setOptions
setOptions(options)
Paramètres: 
Valeur renvoyée:Aucune
setStreetView
setStreetView(panorama)
Paramètres: 
Valeur renvoyée:Aucune
Lie un StreetViewPanorama à la carte. Ce panorama remplace le StreetViewPanorama par défaut, ce qui permet de lier la carte à un panorama externe en dehors de celle-ci. Définir le panorama sur null associe le panorama intégré par défaut à la carte.
setTilt
setTilt(tilt)
Paramètres: 
  • tilt:  number
Valeur renvoyée:Aucune
Pour les cartes vectorielles, définissez 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 changement automatique de l'angle d'incidence de la carte. Les seules valeurs autorisées sont 0 et 45. Avec setTilt(0), la carte affiche toujours une vue aérienne à 0°, quels que soient le niveau de zoom et la fenêtre d'affichage. Avec setTilt(45), l'angle d'inclinaison passe automatiquement à 45 chaque fois que des images à 45° sont disponibles pour le niveau de zoom et la fenêtre d'affichage actuels, puis sur 0 lorsque les images à 45° ne sont pas disponibles (comportement par défaut). Les images à 45° ne sont disponibles que pour les types de carte satellite et hybrid, pour certains lieux et 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, n'utilisez pas bind() pour la propriété tilt. Cela pourrait entraîner des effets imprévisibles.
setZoom
setZoom(zoom)
Paramètres: 
  • zoom:  number 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é centrale de la carte change.
click
function(event)
Arguments: 
Cet événement est déclenché lorsque l'utilisateur clique sur la carte. Un MapMouseEvent avec des propriétés pour le lieu sur lequel l'utilisateur a cliqué est renvoyé, sauf si l'utilisateur clique sur une icône de lieu, auquel cas un IconMouseEvent avec un ID de lieu est renvoyé. IconMouseEvent et MapMouseEvent sont identiques, si ce n'est qu'IconMouseEvent comporte le champ d'identifiant de lieu. L'événement peut toujours être traité comme un MapMouseEvent lorsque l'identifiant 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 du menu contextuel DOM est déclenché sur le conteneur de la carte.
dblclick
function(event)
Arguments: 
Cet événement est déclenché lorsque l'utilisateur double-clique sur la carte. Notez que l'événement de clic se déclenche parfois une ou deux fois, juste avant celui-ci.
drag
function()
Arguments:aucun
Cet événement est déclenché plusieurs fois lorsque l'utilisateur fait glisser la carte.
dragend
function()
Arguments:aucun
Cet événement est déclenché lorsque l'utilisateur cesse 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 est déclenché lorsque la propriété de l'en-tête de la carte est modifiée.
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 été modifiée.
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 est modifiée.
mousemove
function(event)
Arguments: 
Cet événement est déclenché chaque fois que l'utilisateur passe la souris sur le conteneur de la carte.
mouseout
function(event)
Arguments: 
Cet événement est déclenché lorsque le curseur de la souris de l'utilisateur quitte le conteneur de la carte.
mouseover
function(event)
Arguments: 
Cet événement est déclenché 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 été modifiée.
renderingtype_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque le type de rendu a changé.
tilesloaded
function()
Arguments:aucun
Cet événement se déclenche lorsque le chargement des tuiles visibles est terminé.
tilt_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété d'inclinaison de la carte est modifiée.
zoom_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété de zoom de la carte est modifiée.
rightclick
function(event)
Arguments: 
Cet événement est déclenché 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 un élément Map.
backgroundColor optional
Type:  string optional
Couleur utilisée pour l'arrière-plan de l'élément div de la carte. Cette couleur est visible lorsque les tuiles n'ont pas encore été 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 du plan.
clickableIcons optional
Type:  boolean optional
Par défaut:true
Si la valeur est false, les icônes de carte ne sont pas cliquables. Une icône de carte représente un point d'intérêt, également appelé POI.
controlSize optional
Type:  number optional
Taille des commandes affichées sur la carte, en pixels. Cette valeur doit être fournie directement lors de la création de l'élément Map. Si vous la modifiez ultérieurement, les commandes risquent de passer à l'état undefined. Il ne régit que les commandes effectuées par l'API Google Maps elle-même. Ne s'adapte pas aux 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 remplacé individuellement. Ne désactive pas les commandes au 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 lors d'un double-clic. Activée par défaut.

Remarque: Cette propriété n'est pas recommandée. Pour désactiver le zoom par double-clic, 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. La fonction de déplacement est activée par défaut.
draggableCursor optional
Type:  string optional
Nom ou URL du curseur à afficher lorsque vous passez la souris 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 l'utilisateur déplace la carte. 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
Type:  FullscreenControlOptions optional
Options d'affichage de la commande "Plein écran".
gestureHandling optional
Type:  string optional
Ce paramètre contrôle la manière dont l'API gère les gestes sur la carte. Valeurs autorisées:
  • "cooperative": les événements de défilement et les gestes à un doigt font défiler la page, sans zoomer ni panoramique sur la carte. Gestes tactiles à deux doigts pour faire un panoramique et zoomer sur la carte. Permet de faire défiler des événements lorsque l'utilisateur utilise une touche Ctrl ou ⌘ pour zoomer sur la carte.
    Dans ce mode, la carte coopère avec la page.
  • "greedy": tous les gestes tactiles et les événements de défilement permettent un panoramique ou un zoom sur la carte.
  • "none": l'utilisateur ne peut pas faire de panoramique ni de zoom sur la carte.
  • "auto" (par défaut) : la gestion des gestes est coopérative ou gourmande selon que la page est déroulante ou intégrée dans un iFrame.
heading optional
Type:  number optional
Cap des images aériennes en degrés, mesuré dans le sens horaire à partir du nord, dans le sens des aiguilles d'une montre. Les en-têtes sont ancrés à l'angle disponible le plus proche pour lequel des images sont disponibles.
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 le clavier de contrôler la carte. Les raccourcis clavier sont activés par défaut.
mapId optional
Type:  string optional
L'ID de carte de la carte. Ce paramètre ne peut pas être défini ni modifié après qu'une carte a été instanciée.
mapTypeControl optional
Type:  boolean optional
État initial activé/désactivé de la commande de type de carte.
mapTypeControlOptions optional
Type:  MapTypeControlOptions optional
Options d'affichage initiales de la commande de type de carte.
mapTypeId optional
Type:  MapTypeId|string optional
MapTypeId initial. La valeur par défaut est ROADMAP.
maxZoom optional
Type:  number optional
Niveau de zoom maximal qui sera affiché sur la carte. Si cette valeur est omise ou définie sur null, c'est le zoom maximal du type de carte actuel qui est utilisé. 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 sera affiché sur la carte. Si cette valeur est omise ou définie sur null, le zoom minimal par rapport au type de carte actuel est utilisé. 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, n'effacez pas le contenu de l'élément div "Map".
panControl optional
Type:  boolean optional
État activé/désactivé de la commande panoramique.

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

restriction optional
Type:  MapRestriction optional
Définit une limite restreignant la zone de la carte accessible aux utilisateurs. Lorsqu'elle est définie, l'utilisateur ne peut effectuer un panoramique et un zoom que lorsque la vue de la caméra reste à l'intérieur des 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 activé/désactivé de la commande de scaling.
scaleControlOptions optional
Type:  ScaleControlOptions optional
Options d'affichage initial de la commande de mise à l'échelle.
scrollwheel optional
Type:  boolean optional
Si la valeur est false, désactive le zoom sur la carte avec la molette de la souris. La molette 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, vous pouvez utiliser la propriété gestureHandling et la définir sur "cooperative" ou "none".
streetView optional
Type:  StreetViewPanorama optional
Élément StreetViewPanorama à afficher lorsque Pegman est déposé sur la carte. Si aucun panorama n'est spécifié, un StreetViewPanorama par défaut s'affiche dans le div de la carte lorsque Pegman est déposé.
streetViewControl optional
Type:  boolean optional
État initial activé/désactivé de la commande Pegman de Street View. Cette commande fait partie de l'interface utilisateur par défaut et doit être définie sur false lors de l'affichage d'un type de carte sur lequel la superposition de route Street View ne doit pas apparaître (par exemple, une carte autre que Google Earth).
streetViewControlOptions optional
Type:  StreetViewControlOptions optional
Options d'affichage initiales de la commande Pegman de 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.
tilt optional
Type:  number optional
Pour les cartes vectorielles, définissez 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 changement automatique de l'angle d'incidence de la carte. Les seules valeurs autorisées sont 0 et 45. Avec la valeur 0, la carte utilise toujours une vue aérienne à 0°, quels que soient le niveau de zoom et la fenêtre d'affichage. Avec la valeur 45, l'angle d'inclinaison passe automatiquement à 45 chaque fois que des images à 45° sont disponibles pour le niveau de zoom et la fenêtre d'affichage actuels, et sur 0 lorsque les images à 45° ne sont pas disponibles (comportement par défaut). Les images à 45° ne sont disponibles que pour les types de carte satellite et hybrid, pour certains lieux et 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'utilisez pas bind() pour la propriété tilt. Cela pourrait entraîner des effets imprévisibles.
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 d'afficher des cartes. Après avoir chargé la bibliothèque maps, vous pouvez créer une carte en HTML. Par 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 à l'aide de la propriété innerMap.

Élément personnalisé:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>

Cette classe étend HTMLElement.

Cette classe implémente MapElementOptions.

Accès en appelant const {MapElement} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques dans l'API Maps JavaScript.
center
Type:  LatLng|LatLngLiteral optional
Latitude/longitude du centre de la carte.
Attribut HTML:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
Type:  Map
Référence au Map utilisé en interne par MapElement.
mapId
Type:  string optional
ID de carte de la carte. Pour en savoir plus, consultez la documentation sur les ID de carte.
Attribut HTML:
  • <gmp-map map-id="string"></gmp-map>
zoom
Type:  number optional
Niveau de zoom de la carte.
Attribut HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Place l'élément positionné à la position ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Place l'élément positionné à la position ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Place l'élément positionné à la position ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Place l'élément positionné à la position ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Place l'élément positionné à la position ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Place l'élément positionné à la position ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Place l'élément positionné à la position ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Place l'élément positionné à la position ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Place l'élément positionné à la position ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Place l'élément positionné à la position ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Place l'élément positionné à la position ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Place l'élément positionné à la position ControlPosition.INLINE_START_BLOCK_START.
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres: 
  • type:  string Chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener:  EventListener|EventListenerObject objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent
  • options:  boolean|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é est envoyé à la cible. Découvrez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres: 
  • type:  string chaîne spécifiant le type d'événement pour lequel supprimer un écouteur d'événements.
  • listener:  EventListener|EventListenerObject Écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options:  boolean|EventListenerOptions optional Voir les options
Valeur renvoyée:  void
Supprime de la cible un écouteur d'événements précédemment enregistré avec "addEventListener". Consultez la section removeEventListener.
gmp-zoomchange
function(event)
Arguments: 
Cet événement est déclenché lorsque la propriété de zoom de la carte est modifiée.

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
Centre initial du plan.
mapId optional
Type:  string optional
L'ID de carte de la carte. Ce paramètre ne peut pas être défini ni modifié après qu'une carte a été instanciée.
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.

Classe ZoomChangeEvent

Classe google.maps.ZoomChangeEvent

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

Cette classe étend Event.

Accès en appelant const {ZoomChangeEvent} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques dans l'API Maps JavaScript.

Interface MapTypeStyle

Interface google.maps.MapTypeStyle

MapTypeStyle est un ensemble de sélecteurs et de stylers qui définissent le style de la carte. Les sélecteurs indiquent les éléments géographiques et/ou les éléments de la carte qui doivent être affectés, et les stylers précisent la manière dont ces éléments et éléments doivent être modifiés. Pour en savoir plus, consultez la référence de style.
stylers
Type:  Array<Object>
Règles de style à appliquer aux éléments géographiques et aux éléments sélectionnés sur la carte. Les règles sont appliquées dans l'ordre que vous spécifiez dans ce tableau. Pour obtenir des consignes sur l'utilisation et les valeurs autorisées, consultez la référence de style.
elementType optional
Type:  string optional
Élément auquel un styler doit être appliqué. Un élément est un aspect visuel d'un élément géographique sur la carte. 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 étant 'all'. Pour en savoir plus sur l'utilisation et les valeurs autorisées, consultez la référence de style.
featureType optional
Type:  string optional
Élément géographique ou groupe d'éléments géographiques auxquels un styler doit être appliqué. Facultatif. Si featureType n'est pas spécifié, la valeur est considérée comme étant 'all'. Pour en savoir plus sur l'utilisation et les valeurs autorisées, consultez la référence de style.

Interface MapMouseEvent

Interface google.maps.MapMouseEvent

Cet objet est renvoyé par différents é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 compter 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 Google Maps. En raison du mappage d'événements interne, domEvent peut avoir une sémantique différente de MapMouseEvent (par exemple, un "clic" MapMouseEvent peut avoir une domEvent de type KeyboardEvent).
latLng optional
Type:  LatLng optional
Latitude/longitude situées sous le curseur lorsque l'événement s'est produit.
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 de la carte. L'ID de lieu de ce lieu est stocké dans le membre placeId. Pour empêcher l'affichage de la fenêtre d'informations par défaut, appelez la méthode stop() sur cet événement afin d'empêcher sa propagation. 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 sur lequel l'utilisateur a cliqué. 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 MapTypeId

constantes google.maps.MapTypeId

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

Accès en appelant const {MapTypeId} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques dans l'API Maps JavaScript.
HYBRID Ce type de carte affiche un calque transparent des principales rues sur les images satellite.
ROADMAP Ce type de carte affiche un plan de ville normal.
SATELLITE Ce type de carte affiche des images satellite.
TERRAIN Ce type de carte permet d'afficher des cartes présentant des caractéristiques physiques telles que le relief et la végétation.

Classe MapTypeRegistry

Classe google.maps.MapTypeRegistry

Registre des instances MapType, associées à l'ID MapType.

Cette classe étend MVCObject.

Accès en appelant const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques dans l'API Maps JavaScript.
MapTypeRegistry
MapTypeRegistry()
Paramètres:aucun
MapTypeRegistry contient l'ensemble des types de carte personnalisés que la carte peut utiliser. Par exemple, l'API consulte ce registre lorsqu'elle fournit la liste des types de carte disponibles dans des commandes.
set
set(id, mapType)
Paramètres: 
  • id:  string identifiant du MapType à ajouter au registre.
  • mapType:  objet MapType MapType|* à ajouter au registre.
Valeur renvoyée:Aucune
Définit le registre de façon à 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épasse pas ces restrictions.
latLngBounds
Lorsque ce paramètre est défini, l'utilisateur ne peut effectuer un panoramique et un zoom que dans les limites données. Les limites peuvent restreindre à la fois la longitude et la latitude, ou uniquement la latitude. Pour les limites de latitude uniquement, utilisez respectivement des longitudes ouest et est de -180 et 180 (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'option strictBounds sur true. Cela réduit le niveau de zoom arrière sur lequel l'utilisateur peut effectuer un zoom arrière. Ainsi, tout ce qui se trouve en dehors des limites reste masqué. La valeur par défaut est false, ce qui signifie qu'un utilisateur peut effectuer un zoom arrière jusqu'à ce que l'intégralité de la zone délimitée soit visible, y compris des zones situées en dehors de cette zone.

Classe TrafficLayer

Classe google.maps.TrafficLayer

Un calque de trafic.

Cette classe étend MVCObject.

Accès en appelant const {TrafficLayer} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques dans l'API Maps JavaScript.
TrafficLayer
TrafficLayer([opts])
Paramètres: 
Calque qui affiche le trafic routier actuel.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:  Map
Renvoie la carte sur laquelle ce calque est affiché.
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 sera 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 le calque de trafic est actualisé automatiquement avec les informations mises à jour.
map optional
Type:  Map optional
Carte sur laquelle afficher le calque de trafic.

Classe TransitLayer

Classe google.maps.TransitLayer

Calque de transports en commun.

Cette classe étend MVCObject.

Accès en appelant const {TransitLayer} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques dans l'API Maps JavaScript.
TransitLayer
TransitLayer()
Paramètres:aucun
Calque qui affiche les lignes de transports en commun.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:  Map
Renvoie la carte sur laquelle ce calque est affiché.
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 sera supprimé.
Hérité:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Classe BicyclingLayer

Classe google.maps.BicyclingLayer

Calque affichant les pistes cyclables et les chemins.

Cette classe étend MVCObject.

Accès en appelant const {BicyclingLayer} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques dans l'API Maps JavaScript.
BicyclingLayer
BicyclingLayer()
Paramètres:aucun
Calque qui affiche les pistes cyclables et les chemins, et rétrograde les grandes routes.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:  Map
Renvoie la carte sur laquelle ce calque est affiché.
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 sera supprimé.
Hérité:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface CameraOptions

Interface google.maps.CameraOptions

Permet de définir les options de l'appareil photo 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 qui est la zone visible de la carte. Sur une carte vectorielle, ce polygone peut être un trapèze au lieu d'un rectangle lorsqu'une carte vectorielle est inclinée.
farLeft
Type:  LatLng
farRight
Type:  LatLng
latLngBounds
Type:  LatLngBounds
Plus petit cadre de délimitation qui inclut la région visible.
nearLeft
Type:  LatLng
nearRight
Type:  LatLng

Constantes RenderingType

constantes google.maps.RenderingType

Accès en appelant const {RenderingType} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques dans l'API Maps JavaScript.
RASTER Indique que la carte est matricielle.
UNINITIALIZED Indique que l'initialisation de la carte n'est pas encore terminé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 concernés sont chargés ou initialisés, mais 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 la valeur est "true", cette carte est correctement configurée pour permettre l'utilisation de repères avancés. Notez que vous devez quand même importer la bibliothèque marker pour utiliser les repères avancés. Pour en savoir plus, consultez la page https://goo.gle/gmp-isAdvancedMarkersAvailable.
isDataDrivenStylingAvailable optional
Type:  boolean optional
Si la valeur est "true", cette carte est correctement configurée pour permettre l'utilisation du style basé sur les données pour au moins un FeatureLayer. Pour en savoir plus, consultez les pages https://goo.gle/gmp-data-driven-styling et https://goo.gle/gmp-FeatureLayerIsAvailable.