De nouveaux styles de cartes seront bientôt disponibles dans Google Maps Platform. Cette modification des styles de cartes inclut une nouvelle palette de couleurs par défaut, et améliore l'expérience utilisateur et l'usabilité des cartes. Tous les styles de cartes seront automatiquement mis à jour en mars 2025. Pour en savoir plus sur la disponibilité et la façon de s'inscrire plus tôt, consultez Nouveau style de carte pour Google Maps Platform.

Cette page a été traduite par l'API Cloud Translation.

Maps

Classe Map

Classe google.maps.Map

Cette classe étend MVCObject.

Pour y accéder, appelez const {Map} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constructeur
`Map`	`Map(mapDiv[, opts])` Paramètres: `mapDiv`: `HTMLElement` Le rendu de la carte s'effectue 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`.

Constantes
`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 et ne peut pas être utilisé pour des fonctionnalités qui nécessitent une configuration cloud (telles que la personnalisation dans le cloud).

Propriétés
`controls`	Type:`Array<MVCArray<HTMLElement>>` Commandes supplémentaires à associer à la carte Pour ajouter une commande à la carte, ajoutez son `<div>` au `MVCArray` correspondant à l'élément `ControlPosition` où elle doit être affichée.
`data`	Type:`Data` Une instance de `Data`, liée à la carte. Ajoutez des éléments géographiques à cet objet `Data` pour les afficher facilement sur cette carte.
`mapTypes`	Type:`MapTypeRegistry` Registre d'instances `MapType` par ID de chaîne.
`overlayMapTypes`	Type:`MVCArray<MapType optional>` Types de carte supplémentaires à superposer. Les types de cartes en 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 avant celles dont les valeurs d'index sont les plus faibles).

Méthodes
`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 extérieure. Une valeur numérique donnera la même marge intérieure sur les quatre côtés. Indiquez 0 ici pour que la valeur FitBounds soit idempotente 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 la taille de la carte comme étant 0x0 et n'effectue donc rien. Pour modifier la fenêtre d'affichage lorsque la carte est masquée, définissez la carte sur `visibility: hidden`, afin de vous assurer 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 les valeurs zéro par défaut. Appeler cette méthode peut générer une animation fluide, car 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` : 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, les limites de longitude sont comprises 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 l'orientation sont différentes de zéro, les limites de latitude et de 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 carte. Une icône de carte représente un point d'intérêt (également appelé POI). Si la valeur renvoyée est `true`, il est possible de cliquer sur les icônes sur la carte.
`getDatasetFeatureLayer`	Avertissement:Disponible uniquement dans la version v=beta. `getDatasetFeatureLayer(datasetId)` Paramètres: `datasetId`: `string` Valeur renvoyée: `FeatureLayer` Renvoie la valeur `FeatureLayer` pour l'élément `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 vectorielles, ni 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: `featureType`: `FeatureType` Valeur renvoyée: `FeatureLayer` Renvoie l'élément `FeatureLayer` de l'élément `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 (pas d'ID de carte, pas de tuiles vectorielles et pas de `FeatureLayer` activé dans le style de carte), une erreur est consignée, 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, dans le 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 reflétées dans l'affichage d'un 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 le plan de la carte. Pour les cartes matricielles, le résultat est `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`.
`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: `cameraOptions`: `CameraOptions` 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: `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 sera animée 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: `latLng` : `LatLng\|LatLngLiteral` : nouvelle latitude/longitude du centre de la carte. Valeur renvoyée:Aucune Modifie le centre de la carte en fonction du `LatLng` donné. Si la modification est inférieure à la largeur et à la hauteur de la carte, la transition sera animée de façon fluide.
`panToBounds`	`panToBounds(latLngBounds[, padding])` Paramètres: `latLngBounds`: `LatLngBounds\|LatLngBoundsLiteral` les limites sur lesquelles effectuer un panoramique sur la carte. `padding`: `number\|Padding optional` Marge intérieure en pixels. Une valeur numérique donnera la même marge intérieure sur les quatre côtés. La valeur par défaut est 0. Valeur renvoyée:Aucune Fait pivoter la carte selon la valeur minimale nécessaire pour contenir l'élément `LatLngBounds` donné. L'emplacement des limites sur la carte n'est pas garanti. Toutefois, un panoramique sera effectué sur la carte pour afficher autant de limites que 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: `latlng`: `LatLng\|LatLngLiteral` 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, mesurée en degrés à partir du nord, au niveau cardinal. Pour les cartes matricielles, cette méthode ne s'applique qu'aux images aériennes.
`setMapTypeId`	`setMapTypeId(mapTypeId)` Paramètres: `mapTypeId`: `MapTypeId\|string` Valeur renvoyée:Aucune
`setOptions`	`setOptions(options)` Paramètres: `options`: `MapOptions optional` Valeur renvoyée:Aucune
`setStreetView`	`setStreetView(panorama)` Paramètres: `panorama`: `StreetViewPanorama optional` (panorama à lier à la carte) Valeur renvoyée:Aucune Lie 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` 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, ce paramètre 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ôlez 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 utilise toujours une vue aérienne à 0°, quels que soient le niveau de zoom et la fenêtre d'affichage. `setTilt(45)` définit automatiquement l'angle d'inclinaison sur 45 chaque fois que des images à 45° sont disponibles pour le niveau de zoom et la fenêtre d'affichage actuels, et repasse à 0 lorsqu'aucune image à 45° n'est disponible (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 choses différentes, n'utilisez pas `bind()` 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 grande, plus la résolution est élevée. Valeur renvoyée:Aucune Définit le zoom de la carte.
Hérités: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Événements
`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é au centre de la carte change.
`click`	`function(event)` Arguments: `event`: `MapMouseEvent\|IconMouseEvent` Cet événement est déclenché lorsque l'utilisateur clique sur la carte. Un MapMouseEvent avec les propriétés de 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, si ce n'est qu'IconMouseEvent comporte le champ d'ID 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 clique sur un repère ou une fenêtre d'informations.
`contextmenu`	`function(event)` Arguments: `event`: `MapMouseEvent` 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: `event`: `MapMouseEvent` 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, voire 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: `event`: `MapMouseEvent` Cet événement est déclenché chaque fois que l'utilisateur passe la souris sur le conteneur de la carte.
`mouseout`	`function(event)` Arguments: `event`: `MapMouseEvent` Cet événement est déclenché lorsque l'utilisateur quitte le conteneur de carte en faisant glisser son doigt.
`mouseover`	`function(event)` Arguments: `event`: `MapMouseEvent` Cet événement est déclenché lorsque l'utilisateur place le curseur de la souris 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 est déclenché 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 change.
`zoom_changed`	`function()` Arguments:aucun Cet événement est déclenché lorsque la propriété de zoom de la carte change.
`rightclick`	Obsolète:utilisez plutôt l'événement `Map.contextmenu` pour prendre en charge les modèles d'utilisation tels que la combinaison de touches Ctrl+clic sur macOS. `function(event)` Arguments: `event`: `MapMouseEvent` 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 une Map.

Propriétés
`backgroundColor optional`	Type:`string optional` Couleur utilisée pour l'arrière-plan du div de la carte. Cette couleur sera visible lorsque les tuiles n'ont pas encore été chargées, lorsque l'utilisateur fera 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 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 en pixels des commandes affichées sur la carte. Cette valeur doit être fournie directement lors de la création de l'objet Map. Si vous la modifiez ultérieurement, les commandes passeront peut-être à l'état `undefined`. Ne régit que les commandes effectuées par l'API Google Maps elle-même. Ne permet pas de faire évoluer 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 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`	Obsolète:obsolète depuis 2017. Pour désactiver la fonction de déplacement sur la carte, vous pouvez utiliser la propriété `gestureHandling` et la définir sur `"none"`. Type:`boolean optional` Si la valeur est `false`, empêche le déplacement de la carte. Le déplacement est activé par défaut.
`draggableCursor optional`	Type:`string optional` Nom ou URL du curseur à afficher lorsque l'utilisateur pointe 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 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 d'un doigt permettent de faire défiler la page. Il n'est pas nécessaire de zoomer ni de faire un panoramique sur la carte. Les gestes tactiles à deux doigts se déplacent et zooment sur la carte. Faites défiler les événements en appuyant sur la touche Ctrl ou ⌘ pour effectuer 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 de zoomer sur la carte. `"none"`: l'utilisateur ne peut pas effectuer 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 dans un iFrame.
`heading optional`	Type:`number optional` Cap de l'imagerie aérienne en degrés mesurés dans le sens des aiguilles d'une montre à partir du nord. Les caps sont aligné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` Identifiant de carte de la carte. Ce paramètre ne peut pas être défini ni modifié après l'instanciation d'une carte.
`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 affiché sur la carte. Si cette valeur est omise ou définie sur `null`, c'est le niveau de 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`, c'est le niveau de zoom minimal 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é.
`noClear optional`	Type:`boolean optional` Si la valeur est `true`, n'effacez pas le contenu de l'élément div "Map".
`panControl optional`	Obsolète:la commande de panoramique est obsolète depuis septembre 2015. Type:`boolean optional` État activé/désactivé de la commande de panoramique.
`panControlOptions optional`	Obsolète:la commande de panoramique est obsolète depuis septembre 2015. 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. Lorsque cette option 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 mise à l'échelle.
`scaleControlOptions optional`	Type:`ScaleControlOptions optional` Options d'affichage initiales de la commande de mise à l'échelle.
`scrollwheel optional`	Type:`boolean optional` Si la valeur est `false`, désactive le zoom sur la carte à l'aide de 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` Un `StreetViewPanorama` à afficher lorsque Pegman Street View 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 n'appartenant pas à 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, ce paramètre 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ôlez 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. La valeur `45` permet à l'angle d'inclinaison de passer automatiquement à 45 chaque fois que des images à 45° sont disponibles pour le niveau de zoom et de la fenêtre d'affichage actuels, et de rebasculer sur 0 lorsqu'aucune image à 45° n'est disponible (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 choses différentes, 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 au format 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, elle utilise Map, accessible avec 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.

Pour y accéder, appelez const {MapElement} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constructeur
`MapElement`	`MapElement([options])` Paramètres: `options`: `MapElementOptions optional`

Propriétés
`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 l'élément MapElement.
`mapId`	Type:`string optional` ID 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>`

Emplacements
`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`.

Méthodes
`addEventListener`	Avertissement:Disponible uniquement dans la version v=beta. `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.
`removeEventListener`	Avertissement:Disponible uniquement dans la version v=beta. `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 un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez la section removeEventListener.

Méthodes

addEventListener

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.

removeEventListener

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 un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez la section removeEventListener.

Événements
`gmp-zoomchange`	`function(event)` Arguments: `event`: `ZoomChangeEvent` 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.

Propriétés
`center optional`	Type:`LatLng\|LatLngLiteral optional` Centre initial de la carte.
`mapId optional`	Type:`string optional` Identifiant de carte de la carte. Ce paramètre ne peut pas être défini ni modifié après l'instanciation d'une carte.
`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.

Pour y accéder, appelez 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 stylers qui définissent le style de la carte. Les sélecteurs spécifient les éléments géographiques et/ou les éléments de la carte qui doivent être affectés, et les stylers spécifient la manière dont ces éléments géographiques et éléments doivent être modifiés. Pour en savoir plus, consultez la référence de style.

Propriétés
`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 les références 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. Exemples: 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 supposée être `'all'`. Pour en savoir plus sur l'utilisation et les valeurs autorisées, consultez les références de style.
`featureType optional`	Type:`string optional` Élément géographique ou groupe d'éléments géographiques auquel un styler doit être appliqué. Facultatif. Si `featureType` n'est pas spécifié, la valeur est supposée être `'all'`. Pour en savoir plus sur l'utilisation et les valeurs autorisées, consultez les références 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.

Propriétés
`domEvent`	Type:`MouseEvent\|TouchEvent\|PointerEvent\|KeyboardEvent\|Event` É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 la mise en œuvre interne de l'API Google Maps. En raison du mappage d'événements interne, la `domEvent` peut avoir une sémantique différente de celle 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.

Propriétés

domEvent

Type:MouseEvent|TouchEvent|PointerEvent|KeyboardEvent|Event

É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 la mise en œuvre interne de l'API Google Maps. En raison du mappage d'événements interne, la domEvent peut avoir une sémantique différente de celle 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.

Méthodes
`stop`	`stop()` Paramètres:aucun Valeur renvoyée: `void` Empêche la propagation de cet événement.

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 pour 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.

Propriétés
`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és: `domEvent`, `latLng`

Méthodes
Hérité: `stop`

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.

Pour y accéder, appelez const {MapTypeId} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constantes
`HYBRID`	Ce type de carte affiche un calque transparent des rues principales 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 affiche 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, classées par identifiant MapType.

Cette classe étend MVCObject.

Pour y accéder, appelez const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constructeur
`MapTypeRegistry`	`MapTypeRegistry()` Paramètres:aucun `MapTypeRegistry` contient l'ensemble des types de cartes personnalisés disponibles pour la carte. Par exemple, l'API consulte ce registre lorsqu'elle fournit la liste des types de carte disponibles dans les commandes.

Méthodes
`set`	`set(id, mapType)` Paramètres: `id`: `string` identifiant du MapType à ajouter au registre. `mapType`: `MapType\|` objet MapType à ajouter au registre. Valeur renvoyée*:Aucune Définit le registre de sorte qu'il associe l'identifiant de chaîne transmis au MapType transmis.
Hérités: `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 doit pas dépasser ces restrictions.

Propriétés
`latLngBounds`	Type:`LatLngBounds\|LatLngBoundsLiteral` Lorsque cette option est définie, l'utilisateur ne peut effectuer un panoramique et un zoom qu'à l'intérieur des limites données. Les limites peuvent restreindre à la fois la longitude et la latitude, ou limiter uniquement la latitude. Pour les limites de latitude uniquement, utilisez respectivement des longitudes ouest et est de -180 et de 180. Par exemple : `latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}`.
`strictBounds optional`	Type:`boolean optional` Vous pouvez restreindre davantage les limites en définissant l'indicateur `strictBounds` sur `true`. Cela permet de réduire le niveau de 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.

Propriétés

latLngBounds

Type:LatLngBounds|LatLngBoundsLiteral

Lorsque cette option est définie, l'utilisateur ne peut effectuer un panoramique et un zoom qu'à l'intérieur des limites données. Les limites peuvent restreindre à la fois la longitude et la latitude, ou limiter uniquement la latitude. Pour les limites de latitude uniquement, utilisez respectivement des longitudes ouest et est de -180 et de 180. Par exemple : latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.

strictBounds optional

Type:boolean optional

Vous pouvez restreindre davantage les limites en définissant l'indicateur strictBounds sur true. Cela permet de réduire le niveau de 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.

Pour y accéder, appelez const {TrafficLayer} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constructeur
`TrafficLayer`	`TrafficLayer([opts])` Paramètres: `opts`: `TrafficLayerOptions optional` Calque qui affiche le trafic routier actuel.

Méthodes
`getMap`	`getMap()` Paramètres:aucun Valeur renvoyée: `Map` Renvoie la carte sur laquelle ce calque est affiché.
`setMap`	`setMap(map)` Paramètres: `map`: `Map` 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: `options`: `TrafficLayerOptions` Valeur renvoyée:Aucune
Hérités: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

TrafficLayerOptions

Interface google.maps.TrafficLayerOptions

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

Propriétés
`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

Une couche de transports en commun.

Cette classe étend MVCObject.

Pour y accéder, appelez const {TransitLayer} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constructeur
`TransitLayer`	`TransitLayer()` Paramètres:aucun Calque qui affiche les lignes de transports en commun.

Méthodes
`getMap`	`getMap()` Paramètres:aucun Valeur renvoyée: `Map` Renvoie la carte sur laquelle ce calque est affiché.
`setMap`	`setMap(map)` Paramètres: `map`: `Map` 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és: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Classe BicyclingLayer

Classe google.maps.BicyclingLayer

Calque affichant les bandes cyclables et les chemins.

Cette classe étend MVCObject.

Pour y accéder, appelez const {BicyclingLayer} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constructeur
`BicyclingLayer`	`BicyclingLayer()` Paramètres:aucun Calque qui affiche les bandes cyclables et les chemins, et rétrograde les grandes routes.

Méthodes
`getMap`	`getMap()` Paramètres:aucun Valeur renvoyée: `Map` Renvoie la carte sur laquelle ce calque est affiché.
`setMap`	`setMap(map)` Paramètres: `map`: `Map` 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és: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

CameraOptions.

Interface google.maps.CameraOptions

Permet de définir les options de l'appareil photo de la carte.

Propriétés
`center optional`	Type:`LatLngLiteral\|LatLng optional`
`heading optional`	Type:`number optional`
`tilt optional`	Type:`number optional`
`zoom optional`	Type:`number optional`

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.

Propriétés
`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

Pour y accéder, appelez const {RenderingType} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constantes
`RASTER`	Indique que la carte est une carte matricielle.
`UNINITIALIZED`	Indique qu'il n'est pas encore possible de déterminer si la carte est vectorielle ou matricielle, car son initialisation 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.

Propriétés
`isAdvancedMarkersAvailable optional`	Type:`boolean optional` Si la valeur est "true", la 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 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 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.

Maps

Classe Map

Constructeur

Constantes

Propriétés

Méthodes

Événements

Interface MapOptions

Propriétés

Classe MapElement

Constructeur

Propriétés

Emplacements

Méthodes

Événements

Interface MapElementOptions

Propriétés

Classe ZoomChangeEvent

Interface MapTypeStyle

Propriétés

Interface MapMouseEvent

Propriétés

Méthodes

IconMouseEvent.

Propriétés

Méthodes

Constantes MapTypeId

Constantes

Classe MapTypeRegistry

Constructeur

Méthodes

Interface MapRestriction

Propriétés

Classe TrafficLayer

Constructeur

Méthodes

TrafficLayerOptions

Propriétés

Classe TransitLayer

Constructeur

Méthodes

Classe BicyclingLayer

Constructeur

Méthodes

CameraOptions.

Propriétés

VisibleRegion.

Propriétés

Constantes RenderingType

Constantes

Interface MapCapabilities

Propriétés