Info Window

Classe InfoWindow

Classe google.maps.InfoWindow

Calque qui ressemble à une bulle et qui est souvent associé à un repère.

Cette classe étend MVCObject.

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

Constructeur

InfoWindow

InfoWindow([opts]) Paramètres : opts : InfoWindowOptions optional Crée une fenêtre d'informations avec les options spécifiées. Une InfoWindow peut être placée sur une carte à un emplacement spécifique ou au-dessus d'un repère, selon ce qui est spécifié dans les options. Sauf si le déplacement automatique est désactivé, une InfoWindow déplacera la carte pour se rendre visible lorsqu'elle sera ouverte. Après avoir créé une InfoWindow, vous devez appeler open pour l'afficher sur la carte. L'utilisateur peut cliquer sur le bouton de fermeture de la fenêtre d'informations pour la supprimer de la carte, ou le développeur peut appeler close() pour obtenir le même résultat.

Propriétés
isOpen	Type : boolean Vérifie si la fenêtre d'informations est ouverte.

Méthodes
close	close() Paramètres : aucun Valeur renvoyée : aucune Ferme cette InfoWindow en la supprimant de la structure DOM.
focus	focus() Paramètres : aucun Valeur renvoyée : aucune Définit la mise au point sur ce InfoWindow. Vous pouvez utiliser cette méthode avec un événement visible pour vous assurer que InfoWindow est visible avant de définir le focus dessus. Un InfoWindow non visible ne peut pas être sélectionné.
getContent	getContent() Paramètres : aucun Valeur renvoyée : string|Element|Text|null|undefined Le contenu de cette info-bulle. Identique à celui qui était précédemment défini comme contenu.
getHeaderContent	getHeaderContent() Paramètres : aucun Valeur renvoyée : string|Element|Text|null|undefined Contenu de l'en-tête de cette info-bulle. Consultez InfoWindowOptions.headerContent.
getHeaderDisabled	getHeaderDisabled() Paramètres : aucun Valeur renvoyée : boolean|undefined indique si l'ensemble de la ligne d'en-tête est désactivé ou non. Consultez InfoWindowOptions.headerDisabled.
getPosition	getPosition() Paramètres : aucun Valeur renvoyée : LatLng|null|undefined La position LatLng de cette InfoWindow.
getZIndex	getZIndex() Paramètres : aucun Valeur renvoyée : number, le zIndex de cette info-bulle.
open	open([options, anchor]) Paramètres : options : InfoWindowOpenOptions|Map|StreetViewPanorama optional objet InfoWindowOpenOptions (recommandé) ou carte/panorama sur lesquels afficher cette InfoWindow. anchor : MVCObject|AdvancedMarkerElement optional ancre à laquelle cette InfoWindow sera positionnée. Si l'ancrage n'est pas nul, la fenêtre d'informations est positionnée en haut au centre de l'ancrage. La fenêtre info sera affichée sur la même carte ou le même panorama que l'ancrage (le cas échéant). Valeur renvoyée : aucune Ouvre cette InfoWindow sur la carte donnée. Une InfoWindow peut éventuellement être associée à une ancre. Dans l'API Core, le seul ancrage est la classe Marker. Toutefois, une ancre peut être n'importe quel MVCObject qui expose une propriété LatLng position et, éventuellement, une propriété Point anchorPoint pour calculer pixelOffset (voir InfoWindowOptions). anchorPoint correspond au décalage entre la position de l'ancrage et l'extrémité de la fenêtre d'informations. Il est recommandé d'utiliser l'interface InfoWindowOpenOptions comme argument unique pour cette méthode. Pour empêcher le changement de focus du navigateur à l'ouverture, définissez InfoWindowOpenOptions.shouldFocus sur false.
setContent	setContent([content]) Paramètres : content : string|Element|Text optional contenu à afficher par cette info-bulle. Valeur renvoyée : aucune
setHeaderContent	setHeaderContent([headerContent]) Paramètres : headerContent : string|Element|Text optional contenu de l'en-tête à afficher par cette InfoWindow. Consultez InfoWindowOptions.headerContent. Valeur renvoyée : aucune
setHeaderDisabled	setHeaderDisabled([headerDisabled]) Paramètres : headerDisabled : boolean optional indique s'il faut désactiver l'ensemble de la ligne d'en-tête. Consultez InfoWindowOptions.headerDisabled. Valeur renvoyée : aucune
setOptions	setOptions([options]) Paramètres : options : InfoWindowOptions optional Valeur renvoyée : aucune
setPosition	setPosition([position]) Paramètres : position : LatLng|LatLngLiteral optional Position LatLng à laquelle afficher cette InfoWindow. Valeur renvoyée : aucune
setZIndex	setZIndex(zIndex) Paramètres : zIndex : number L'index Z de cette info-bulle. Une InfoWindow avec un z-index plus élevé s'affichera devant toutes les autres InfoWindows avec un z-index plus faible. Valeur renvoyée : aucune
Hérité : addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Événements
close	function() Arguments : aucun Cet événement est déclenché chaque fois que InfoWindow se ferme. Par exemple, cela peut se produire en appelant la méthode InfoWindow.close, en appuyant sur la touche Échap pour fermer la fenêtre d'informations, en cliquant sur le bouton de fermeture ou en déplaçant la fenêtre d'informations vers une autre carte.
closeclick	function() Arguments : aucun Cet événement est déclenché lorsque l'utilisateur clique sur le bouton de fermeture.
content_changed	function() Arguments : aucun Cet événement est déclenché lorsque la propriété de contenu change.
domready	function() Arguments : aucun Cet événement est déclenché lorsque le <div> contenant le contenu du InfoWindow est associé au DOM. Vous pouvez surveiller cet événement si vous créez le contenu de votre fenêtre d'informations de manière dynamique.
headercontent_changed	function() Arguments : aucun Cet événement est déclenché lorsque la propriété headerContent change.
headerdisabled_changed	function() Arguments : aucun Cet événement est déclenché lorsque la propriété headerDisabled change.
position_changed	function() Arguments : aucun Cet événement est déclenché lorsque la propriété de position change.
visible	function() Arguments : aucun Cet événement est déclenché lorsque l'élément InfoWindow est entièrement visible. Cet événement ne se déclenche pas lorsque InfoWindow est déplacé hors écran, puis de nouveau à l'écran.
zindex_changed	function() Arguments : aucun Cet événement est déclenché lorsque le z-index de InfoWindow change.

Interface InfoWindowOptions

Interface google.maps.InfoWindowOptions

Objet InfoWindowOptions utilisé pour définir les propriétés pouvant être définies sur une info-bulle.

Propriétés
ariaLabel optional	Type : string optional AriaLabel à attribuer à l'InfoWindow.
content optional	Type : string|Element|Text optional Contenu à afficher dans l'info-bulle. Il peut s'agir d'un élément HTML, d'une chaîne de texte brut ou d'une chaîne contenant du code HTML. La taille de la fenêtre d'informations est définie en fonction du contenu. Pour définir une taille explicite pour le contenu, définissez le contenu comme un élément HTML avec cette taille.
disableAutoPan optional	Type : boolean optional Par défaut : false Désactivez le déplacement de la carte pour rendre l'info-bulle entièrement visible lorsqu'elle s'ouvre.
headerContent optional	Type : string|Element|Text optional Contenu à afficher dans la ligne d'en-tête de la fenêtre d'informations. Il peut s'agir d'un élément HTML ou d'une chaîne de texte brut. La taille de la fenêtre d'informations est définie en fonction du contenu. Pour définir une taille explicite pour le contenu de l'en-tête, définissez headerContent comme un élément HTML de cette taille.
headerDisabled optional	Type : boolean optional Désactive l'intégralité de la ligne d'en-tête dans la fenêtre d'informations. Si la valeur est définie sur "true", l'en-tête est supprimé, de sorte que son contenu et le bouton de fermeture sont masqués.
maxWidth optional	Type : number optional Largeur maximale de la fenêtre info, quelle que soit la largeur du contenu. Cette valeur n'est prise en compte que si elle est définie avant un appel à open(). Pour modifier la largeur maximale lors du changement de contenu, appelez close(), setOptions(), puis open().
minWidth optional	Type : number optional Largeur minimale de la fenêtre info, quelle que soit la largeur du contenu. Lorsque vous utilisez cette propriété, il est fortement recommandé de définir minWidth sur une valeur inférieure à la largeur de la carte (en pixels). Cette valeur n'est prise en compte que si elle est définie avant un appel à open(). Pour modifier la largeur minimale lors du changement de contenu, appelez close(), setOptions(), puis open().
pixelOffset optional	Type : Size optional Décalage, en pixels, de l'extrémité de la fenêtre d'informations par rapport au point de la carte dont les coordonnées géographiques servent de point d'ancrage à la fenêtre d'informations. Si une info-bulle est ouverte avec une ancre, la propriété pixelOffset est calculée à partir de la propriété anchorPoint de l'ancre.
position optional	Type : LatLng|LatLngLiteral optional LatLng auquel afficher cette InfoWindow. Si la fenêtre d'informations est ouverte avec une ancre, la position de l'ancre sera utilisée à la place.
zIndex optional	Type : number optional Toutes les info-bulles sont affichées sur la carte par ordre de zIndex, les valeurs plus élevées s'affichant devant les info-bulles ayant des valeurs plus faibles. Par défaut, les fenêtres d'informations sont affichées en fonction de leur latitude. Celles dont la latitude est la plus faible apparaissent devant celles dont la latitude est la plus élevée. Les info-bulles sont toujours affichées devant les repères.

Interface InfoWindowOpenOptions

Interface google.maps.InfoWindowOpenOptions

Options d'ouverture d'une info-bulle

Propriétés
anchor optional	Type : MVCObject|AdvancedMarkerElement optional Point d'ancrage auquel cette info-bulle sera positionnée. Si l'ancrage n'est pas nul, la fenêtre d'informations est positionnée en haut au centre de l'ancrage. La fenêtre info sera affichée sur la même carte ou le même panorama que l'ancrage (le cas échéant).
map optional	Type : Map|StreetViewPanorama optional Carte ou panorama sur lesquels afficher cette info-bulle.
shouldFocus optional	Type : boolean optional Indique si le curseur doit être déplacé dans la fenêtre d'informations lorsqu'elle est ouverte. Lorsque cette propriété n'est pas définie ou qu'elle est définie sur null ou undefined, une heuristique est utilisée pour déterminer si la mise au point doit être déplacée ou non. Nous vous recommandons de définir explicitement cette propriété en fonction de vos besoins, car l'heuristique est susceptible de changer et peut ne pas fonctionner correctement pour tous les cas d'utilisation.