Maps

Classe Map

Classe google.maps.Map

Cette classe étend MVCObject.

Accédez au compte en appelant const {Map} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.

Constructeur
Map	Map(mapDiv[, opts]) Paramètres: mapDiv:  HTMLElement la carte s'affiche pour remplir cet élément. opts:  MapOptions optional options Crée une nouvelle carte à l'intérieur du conteneur HTML, qui est généralement un élément DIV.

Propriétés
controls	Type:Array<MVCArray<HTMLElement>> Commandes supplémentaires à associer à la carte. Pour ajouter une commande à la carte, ajoutez l'élément <div> de la commande à l'élément MVCArray correspondant au ControlPosition dans lequel 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	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 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).

Méthodes
fitBounds	fitBounds(bounds[, padding]) Paramètres: bounds:  LatLngBounds|LatLngBoundsLiteral limites à afficher. padding:  number|Padding optional marge intérieure (en pixels). Les limites seront ajustées dans la partie de la carte qui reste après la suppression de la marge intérieure. Une valeur numérique donne la même marge intérieure sur les quatre côtés. Fournissez ici la valeur 0 pour que l'élément 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 données. Remarque:Lorsque la carte est définie sur display: none, la fonction fitBounds lit la taille de la carte avec la valeur 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, afin de vous assurer que la taille du div de la carte est réelle. Pour les cartes vectorielles, cette méthode définit l'inclinaison et le cap de leurs valeurs par défaut sur zéro. Cette méthode peut donner une animation fluide, car la carte se déplace et zoome 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 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 la longitude sont comprises entre -180 et 180 degrés. 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 avec une inclinaison ou un cap différent de zéro, les limites de latitude et longitude renvoyées représentent le plus petit cadre de délimitation qui comprend la zone visible de la fenêtre d'affichage de la carte. Pour connaître la région exacte de la fenêtre d'affichage de la carte, consultez MapCanvasProjection.getVisibleRegion.
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, les icônes sont cliquables sur la carte.
getDatasetFeatureLayer	Avertissement:Disponible uniquement dans la version v=beta. getDatasetFeatureLayer(datasetId) Paramètres: datasetId:  string Valeur renvoyée:  FeatureLayer Renvoie le FeatureLayer correspondant à la datasetId spécifiée. Les ID d'ensembles de données doivent être configurés dans Google Cloud Console. Si l'ID de l'ensemble de données n'est pas associé au style de carte ou si le style basé sur les données n'est pas disponible (aucun ID de carte, aucune tuile vectorielle, aucun calque d'éléments géographiques ni aucun ensemble de données configuré dans le style de carte), une erreur est consignée, et la valeur FeatureLayer.isAvailable renvoyée 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 le FeatureLayer du FeatureType spécifique. Un FeatureLayer doit être activé dans Google Cloud Console. Si aucun élément 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 carte vectorielle ni aucune FeatureLayer activée dans le style de carte), une erreur est consignée, et la valeur FeatureLayer.isAvailable renvoyée est "false".
getHeading	getHeading() Paramètres:aucun Valeur renvoyée:  number|undefined Renvoie l'en-tête de la carte. La valeur du cap est mesurée en degrés (dans le sens des aiguilles d'une montre) à partir de la direction nord. Si la carte n'est pas encore initialisée, le résultat est undefined.
getMapCapabilities	getMapCapabilities() Paramètres:aucun Valeur renvoyée:  MapCapabilities Indique à l'appelant les fonctionnalités actuelles 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 le Projection actuel. 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 type de rendu actuel de la carte.
getStreetView	getStreetView() Paramètres:aucun Valeur renvoyée:StreetViewPanorama 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 le panorama auquel il est lié.
getTilt	getTilt() Paramètres:aucun Valeur renvoyée:  number|undefined Renvoie l'angle actuel de la carte, en degrés, entre le plan de la fenêtre d'affichage et le plan. Pour les cartes matricielles, le résultat sera 0 pour les images prises directement au-dessus du plafond 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 l'appareil photo de la carte sur les options de caméra cible, sans animation.
panBy	panBy(x, y) Paramètres: x:  number nombre de pixels permettant de déplacer la carte dans le sens X. y:  number nombre de pixels permettant de 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. Notez que le système de coordonnées de 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 centrale de la carte. Valeur renvoyée:aucune Modifie le centre de la carte sur la valeur LatLng donnée. Si la modification est inférieure à la largeur et à la hauteur de la carte, la transition sera animée.
panToBounds	panToBounds(latLngBounds[, padding]) Paramètres: latLngBounds:  LatLngBounds|LatLngBoundsLiteral limites permettant de faire un panoramique sur la carte. padding:  number|Padding optional marge intérieure (en pixels). Une valeur numérique donne la même marge intérieure sur les quatre côtés. La valeur par défaut est 0. Valeur renvoyée:aucune Panoramique sur la carte en fonction du nombre minimal nécessaire pour contenir le LatLngBounds donné. Il n'est pas garanti que les limites de la carte soient placées à l'extérieur, si ce n'est que celle-ci sera affichée de manière à afficher le plus de limites possible dans {currentMapSizeInPx} - {padding}. Pour les cartes matricielles et vectorielles, le zoom, l'inclinaison et le cap 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 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 une valeur false à cette méthode.
setHeading	setHeading(heading) Paramètres: heading:  number Valeur renvoyée:aucune Définit la direction de la boussole pour une carte mesurée en degrés à partir de la direction nord. 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 à associer à la carte. Valeur renvoyée:aucune Lie un StreetViewPanorama à la carte. Ce panorama remplace la valeur par défaut StreetViewPanorama, ce qui permet à la carte de s'associer à un panorama externe en dehors de la carte. La définition du panorama sur null lie 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é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 changement automatique de l'angle de la carte. Les seules valeurs autorisées sont 0 et 45. setTilt(0) fait en sorte que la carte utilise toujours une vue aérienne de 0°, quels que soient le niveau de zoom et la fenêtre d'affichage. setTilt(45) entraîne l'inclinaison automatique de l'angle d'inclinaison à 45 chaque fois que les images à 45° sont disponibles pour le niveau de zoom et la fenêtre d'affichage actuels, et redéfinissent sur 0 lorsque les images à 45° ne sont pas disponibles (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. Comme getTilt et setTilt font référence à des éléments différents, ne créez pas bind() la propriété tilt. Vous risqueriez d'obtenir des effets imprévisibles.
setZoom	setZoom(zoom) Paramètres: zoom:  number des valeurs de zoom plus importantes correspondent à une résolution plus élevée. Valeur renvoyée:aucune Définit le zoom de la carte.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Constantes
DEMO_MAP_ID	ID de carte pouvant ê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 dans le cloud (telles que les styles cloud).

É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é du 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" contenant les propriétés de l'établissement sur lequel l'utilisateur a cliqué est renvoyé, sauf s'il a cliqué sur une icône de lieu, auquel cas un élément "MouseMouseEvent" avec un ID de lieu est renvoyé. IconMouseEvent et MapMouseEvent sont identiques, sauf que IconMouseEvent comporte le champ "ID de lieu". L'événement peut toujours être traité comme un événement MapMouseEvent lorsque l'ID de lieu n'est pas important. L'événement de clic ne se déclenche pas si l'utilisateur a cliqué sur un repère ou une fenêtre d'informations.
contextmenu	function(event) Arguments: event:  MapMouseEvent Cet événement se déclenche lorsque le menu contextuel DOM est déclenché au niveau du 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 peut se déclencher 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 est déclenché 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 est déclenché lorsque la propriété du titre de la carte change.
idle	function() Arguments:aucun Cet événement est déclenché lorsque la carte est 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 se déclenche lorsque les capacité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: 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 la souris de l'utilisateur quitte le conteneur de la carte.
mouseover	function(event) Arguments: event:  MapMouseEvent Cet événement se déclenche lorsque la souris de l'utilisateur accède au 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 renduType 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 change.
zoom_changed	function() Arguments:aucun Cet événement est déclenché lorsque la propriété de zoom sur la carte change.
rightclick	Obsolète:utilisez plutôt l'événement Map.contextmenu afin d'accepter les modèles d'utilisation tels que Ctrl + clic sous macOS. function(event) Arguments: event:  MapMouseEvent Cet événement est déclenché lorsque l'utilisateur clique avec le bouton 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.

Propriétés
backgroundColor optional	Type:string optional Couleur utilisée pour l'arrière-plan de la carte div. 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 Map.
clickableIcons optional	Type:boolean optional Par défaut:true Lorsque 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 la map. Si vous la modifiez ultérieurement, les commandes risquent de passer à l'état undefined. Ne régit que les commandes effectuées par l'API Google Maps. mais pas les commandes personnalisées créées par les développeurs.
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 centre lorsque l'utilisateur double-clique. 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 le 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 lors du survol d'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 vous faites glisser 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, et ne font pas de zoom ni de panoramique. Les gestes tactiles à deux doigts permettent de faire un panoramique et de zoomer sur la carte. Pour faire défiler les événements, appuyez sur la touche Ctrl ou ⌘ et agrandissez 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 de faire un panoramique ou de zoomer sur la carte. "none": vous ne pouvez pas faire un panoramique sur la carte ni zoomer sur ceux-ci en fonction des gestes de l'utilisateur. "auto": (par défaut) la gestion des gestes est coopérative ou gourmande, selon que l'utilisateur peut faire défiler la page ou dans un iFrame.
heading optional	Type:number optional Cap pour les images aériennes en degrés mesurées dans le sens horaire à partir du nord cardinal. Les titres sont alignés sur 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 des 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, la carte ne peut pas être contrôlée par le clavier. Les raccourcis clavier sont activés par défaut.
mapId optional	Type:string optional ID de 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 MapMapId 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, le zoom maximal du 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é.
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 du 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 de la carte.
panControl optional	Type:boolean optional État activé/désactivé de la commande de panoramique. Remarque: La commande Panoramique n'est pas disponible dans le nouvel ensemble de commandes introduit dans la version 3.22 de l'API Google Maps JavaScript. Avec les versions 3.22 et 3.23, vous pouvez choisir d'utiliser l'ensemble de commandes précédent plutôt que les nouveaux, ce qui rend la commande de panoramique disponible dans l'ancien ensemble de commandes. Pour en savoir plus, consultez Nouveautés de la version 3.22 des commandes de carte.
panControlOptions optional	Type:PanControlOptions optional Options d'affichage de la commande de panoramique. Remarque: La commande Panoramique n'est pas disponible dans le nouvel ensemble de commandes introduit dans la version 3.22 de l'API Google Maps JavaScript. Avec les versions 3.22 et 3.23, vous pouvez choisir d'utiliser l'ensemble de commandes précédent plutôt que les nouveaux, ce qui rend la commande de panoramique disponible dans l'ancien ensemble de commandes. Pour en savoir plus, consultez Nouveautés de la version 3.22 des commandes de carte.
restriction optional	Type:MapRestriction optional Définit une limite qui limite la zone de la carte accessible aux utilisateurs. Lorsqu'elle est définie, l'utilisateur ne peut faire un panoramique et zoomer que lorsque la vue de la caméra ne dépasse pas les limites.
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 Scale.
scaleControlOptions optional	Type:ScaleControlOptions optional Options d'affichage initiales de la commande d'é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 l'icône Street View est déposée sur la carte. Si aucun panorama n'est spécifié, un StreetViewPanorama par défaut sera affiché dans le div de la carte lorsque l'utilisateur 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 lorsque vous affichez un type de carte sur lequel la superposition de route Street View ne doit pas s'afficher (par exemple, un type de carte autre que Earth).
streetViewControlOptions optional	Type:StreetViewControlOptions optional Options d'affichage initiales de la commande Pegman Street View.
styles optional	Type:Array<MapTypeStyle> optional Styles à appliquer à chaque type 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é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 changement automatique de l'angle de la carte. Les seules valeurs autorisées sont 0 et 45. Avec la valeur 0, la carte utilise toujours une vue aérienne de 0°, quel que soit 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 revient à 0 lorsque les images à 45° ne sont pas disponibles (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. Comme getTilt et cette option font référence à des éléments différents, ne définissez pas bind() sur la propriété tilt, car cela pourrait avoir 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é. Les valeurs de zoom plus importantes correspondent à une résolution plus é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

Avertissement:Disponible uniquement dans la version v=beta.

MapElement est une sous-classe HTMLElement pour le rendu 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"></gmp-map>

En interne, il 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.

Accédez au compte en appelant const {MapElement} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.

Propriétés
center	Type:LatLng|LatLngLiteral optional Attribut HTML: <gmp-map center="lat,lng"></gmp-map>
innerMap	Type:Map Référence au Map que MapElement utilise en interne.
mapId	Type:string optional Attribut HTML: <gmp-map map-id="string"></gmp-map>
zoom	Type:number optional Attribut HTML: <gmp-map zoom="number"></gmp-map>

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 consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive. Valeur renvoyée:  void Configure une fonction qui est appelée chaque fois que l'événement spécifié est diffusé vers la cible. Voir GroupByKey
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 vous souhaitez supprimer un écouteur d'événements. listener:  EventListener|EventListenerObject écouteur d'événements du gestionnaire d'événements à supprimer de la cible d'é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é auprès de GroupByKey. Voir removeEventListener

Interface MapElementOptions

Interface google.maps.MapElementOptions

Avertissement:Disponible uniquement dans la version v=beta.

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

Propriétés
center optional	Type:LatLng|LatLngLiteral optional Centre initial de Map.
mapId optional	Type:string optional ID de 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é. Les valeurs de zoom plus importantes correspondent à une résolution plus élevée.

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, tandis que les stylers spécifient la manière dont ces éléments géographiques et/ou éléments doivent être modifiés. Pour en savoir plus, consultez la documentation de référence sur le style.

Propriétés
stylers	Type:Array<Object> Règles de style à appliquer aux éléments géographiques et aux éléments de la carte sélectionnés. Les règles sont appliquées dans l'ordre que vous indiquez dans ce tableau. Pour obtenir des consignes sur l'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 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és à 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 auxquels un styler 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 différents événements de souris sur la carte et les superpositions. Il contient tous les champs affichés ci-dessous.

Propriétés
domEvent	Type:MouseEvent|TouchEvent|PointerEvent|KeyboardEvent|Event Événement DOM natif correspondant. Les développeurs ne doivent pas s'appuyer sur les propriétés target, currentTarget, relatedTarget et path définies et cohérentes. 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 des événements internes, 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 qui étaient sous le curseur lorsque l'événement s'est produit.

Méthodes
stop	stop() Paramètres:aucun Valeur renvoyée:  void Empêcher la diffusion 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'identifiant 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 éviter qu'elle ne soit propagée. 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 identifiant de lieu peut être utilisé pour interroger 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

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.

Accédez au compte en appelant const {MapTypeId} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.

Constantes
HYBRID	Ce type de carte affiche un calque transparent des principales rues sur les images satellite.
ROADMAP	Ce type de carte affiche une carte de rue normale.
SATELLITE	Ce type de carte affiche des images satellite.
TERRAIN	Ce type de carte affiche des cartes comportant des éléments physiques comme le relief et la végétation.

Classe MapTypeRegistry

Classe google.maps.MapTypeRegistry

Registre des instances MapType, associé à l'identifiant MapType.

Cette classe étend MVCObject.

Accédez au compte en appelant const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.

Constructeur
MapTypeRegistry	MapTypeRegistry() Paramètres:aucun MapTypeRegistry contient la collection de types de carte personnalisés disponibles pour la carte. L'API consulte ce registre pour fournir la liste des types de carte disponibles dans les commandes, par exemple.

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 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 qui peut être appliquée à la carte. La fenêtre d'affichage de la carte ne dépasse pas ces restrictions.

Propriétés
latLngBounds	Type:LatLngBounds|LatLngBoundsLiteral Lorsqu'elle est définie, l'utilisateur ne peut faire un panoramique et zoomer que dans les limites données. Les limites peuvent limiter à la fois la longitude et la latitude, ou seulement la latitude. Pour les limites concernant la latitude uniquement, utilisez les longitudes ouest et -180 et 180, respectivement (par exemple, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}).
strictBounds optional	Type:boolean optional Pour rendre les limites plus restrictives, définissez l'indicateur strictBounds sur true. Cela permet de réduire le niveau de zoom possible par l'utilisateur, de sorte que les éléments en dehors des limites restreintes restent masqués. La valeur par défaut est false, ce qui signifie qu'un utilisateur peut faire un zoom arrière jusqu'à ce que la totalité de la zone limitée soit visible, y compris les zones en dehors de celle-ci.

Classe TrafficLayer

Classe google.maps.TrafficLayer

Une couche de trafic

Cette classe étend MVCObject.

Accédez au compte en appelant const {TrafficLayer} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.

Constructeur
TrafficLayer	TrafficLayer([opts]) Paramètres: opts:  TrafficLayerOptions optional Calque qui affiche le trafic 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 est supprimé.
setOptions	setOptions(options) Paramètres: options:  TrafficLayerOptions 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.

Propriétés
autoRefresh optional	Type:boolean optional Par défaut:true Indique si le calque de trafic s'actualise 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 Transit.

Cette classe étend MVCObject.

Accédez au compte en appelant const {TransitLayer} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.

Constructeur
TransitLayer	TransitLayer() Paramètres:aucun Calque affichant 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 est supprimé.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Classe BicyclingLayer

Classe google.maps.BicyclingLayer

Calque montrant les pistes cyclables et les chemins.

Cette classe étend MVCObject.

Accédez au compte en appelant const {BicyclingLayer} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.

Constructeur
BicyclingLayer	BicyclingLayer() Paramètres:aucun Calque qui affiche les pistes cyclables et les routes rétrogradées

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 est supprimé.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface CameraOptions

Interface google.maps.CameraOptions

Avertissement:Disponible uniquement dans la version v=beta.

Permet de définir les options d'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

Interface VisibleRegion

Interface google.maps.VisibleRegion

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

Propriétés
farLeft	Type:LatLng
farRight	Type:LatLng
latLngBounds	Type:LatLngBounds Le 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édez au compte en appelant const {RenderingType} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans 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 vectorielle.

Interface MapCapabilities

Interface google.maps.MapCapabilities

Objet contenant un instantané des capacité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 que la carte actuelle est autorisée à utiliser ces API. Consultez les propriétés pour connaître la liste des fonctionnalités possibles.

Propriétés
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 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 afin de permettre l'utilisation du style basé sur les données pour au moins un élément LayerLayer. Pour en savoir plus, consultez https://goo.gle/gmp-data-driven-styling et https://goo.gle/gmp-FeatureLayerIsAvailable.