Info Window

Classe InfoWindow

google.maps.InfoWindow classe

Un overlay dall'aspetto di una bolla spesso collegato a un indicatore.

Questa classe estende MVCObject.

Accedi chiamando const {InfoWindow} = await google.maps.importLibrary("maps") o const {InfoWindow} = await google.maps.importLibrary("streetView"). Consulta la sezione Librerie nell'API Maps JavaScript.
InfoWindow
InfoWindow([opts])
Parametri: 
Crea una finestra informativa con le opzioni fornite. Una finestra informativa può essere posizionata su una mappa in una determinata posizione o sopra un indicatore, a seconda di ciò che è specificato nelle opzioni. A meno che la panoramica automatica non sia disabilitata, una InfoWindow esegue la panoramica della mappa per rendersi visibile all'apertura. Dopo aver creato una InfoWindow, devi richiamare open per poterla visualizzare sulla mappa. L'utente può fare clic sul pulsante di chiusura in InfoWindow per rimuoverlo dalla mappa oppure lo sviluppatore può richiamare la funzione Close() per ottenere lo stesso effetto.
close
close()
Parametri: nessuno
Valore restituito: nessuno
Chiude la InfoWindow rimuovendola dalla struttura DOM.
focus
focus()
Parametri: nessuno
Valore restituito: nessuno
Imposta lo stato attivo su questo InfoWindow. Ti consigliamo di utilizzare questo metodo insieme a un evento visible per assicurarti che InfoWindow sia visibile prima di impostare lo stato attivo su questo metodo. Impossibile mettere a fuoco un elemento InfoWindow non visibile.
getContent
getContent()
Parametri: nessuno
Valore restituito:  string|Element|Text|null|undefined i contenuti di questa InfoWindow. Uguale a quanto impostato in precedenza per i contenuti.
getPosition
getPosition()
Parametri: nessuno
Valore restituito:  LatLng|null|undefined la posizione LatLng di questa InfoWindow.
getZIndex
getZIndex()
Parametri: nessuno
Valore restituito:  number il valore zIndex di questa InfoWindow.
open
open([options, anchor])
Parametri: 
  • options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional un oggetto InfoWindowOpenOptions (consigliato) o la mappa|panorama su cui eseguire il rendering di InfoWindow.
  • anchor:  MVCObject|AdvancedMarkerElement optional l'ancoraggio a cui verrà posizionata questa InfoWindow. Se l'ancoraggio è diverso da null, la finestra InfoWindow verrà posizionata nella parte superiore centrale dell'ancoraggio. La finestra InfoWindow verrà visualizzata sulla stessa mappa o panoramica dell'ancoraggio (se disponibile).
Valore restituito: nessuno
Apre questa InfoWindow sulla mappa specificata. Facoltativamente, una InfoWindow può essere associata a un ancoraggio. Nell'API principale, l'unico ancoraggio è la classe Marker. Tuttavia, un ancoraggio può essere qualsiasi MVCObject che espone una proprietà position LatLng e, facoltativamente, una proprietà Punto anchorPoint per calcolare pixelOffset (vedi InfoWindowOptions). anchorPoint è l'offset dalla posizione dell'ancoraggio alla punta della InfoWindow. Ti consigliamo di utilizzare l'interfaccia InfoWindowOpenOptions come argomento singolo per questo metodo. Per impedire la modifica dello stato attivo del browser per l'apertura, imposta InfoWindowOpenOptions.shouldFocus su false.
setContent
setContent([content])
Parametri: 
  • content:  string|Element|Text optional i contenuti da visualizzare in questa InfoWindow.
Valore restituito: nessuno
setOptions
setOptions([options])
Parametri: 
Valore restituito: nessuno
setPosition
setPosition([position])
Parametri: 
  • position:  LatLng|LatLngLiteral optional la posizione LatLng in cui visualizzare la finestra informativa.
Valore restituito: nessuno
setZIndex
setZIndex(zIndex)
Parametri: 
  • zIndex:  number lo z-index per questa InfoWindow. Una InfoWindow con uno z-index maggiore viene visualizzata davanti a tutte le altre InfoWindows con uno z-index più basso.
Valore restituito: nessuno
Ereditate: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function()
Argomenti: nessuno
Questo evento viene attivato quando l'utente ha fatto clic sul pulsante di chiusura.
content_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà dei contenuti cambia.
domready
function()
Argomenti: nessuno
Questo evento viene attivato quando l'elemento <div> con i contenuti di InfoWindow è collegato al DOM. Ti consigliamo di monitorare questo evento se stai creando in modo dinamico i contenuti della finestra informativa.
position_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà di posizione cambia.
visible
function()
Argomenti: nessuno
Questo evento viene attivato quando InfoWindow è completamente visibile. Questo evento non viene attivato quando InfoWindow viene spostato fuori dalla panoramica e poi di nuovo sullo schermo.
zindex_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando lo zIndex di InfoWindow viene modificato.

Interfaccia InfoWindowOptions

Interfaccia google.maps.InfoWindowOptions

Oggetto InfoWindowOptions utilizzato per definire le proprietà che possono essere impostate in una InfoWindow.
ariaLabel optional
Tipo:  string optional
AriaLabel da assegnare alla finestra informativa.
content optional
Tipo:  string|Element|Text optional
Contenuti da visualizzare nella finestra informativa. Può essere un elemento HTML, una stringa di testo normale o una stringa contenente HTML. La finestra InfoWindow verrà dimensionata in base ai contenuti. Per impostare una dimensione esplicita per i contenuti, imposta i contenuti in modo che siano un elemento HTML con quella dimensione.
disableAutoPan optional
Tipo:  boolean optional
Predefinita: false
Disattiva la panoramica della mappa per rendere la InfoWindow completamente visibile all'apertura.
maxWidth optional
Tipo:  number optional
Larghezza massima della InfoWindow, indipendentemente dalla larghezza dei contenuti. Questo valore viene preso in considerazione solo se viene impostato prima di una chiamata a open(). Per cambiare la larghezza massima quando modifichi i contenuti, chiama close(), setOptions() e poi open().
minWidth optional
Tipo:  number optional
Larghezza minima della InfoWindow, indipendentemente dalla larghezza dei contenuti. Quando utilizzi questa proprietà, ti consigliamo vivamente di impostare minWidth su un valore inferiore alla larghezza della mappa (in pixel). Questo valore viene preso in considerazione solo se viene impostato prima di una chiamata a open(). Per modificare la larghezza minima quando modifichi i contenuti, chiama close(), setOptions() e poi open().
pixelOffset optional
Tipo:  Size optional
L'offset, in pixel, della punta della finestra informativa rispetto al punto sulla mappa alle cui coordinate geografiche è ancorata la finestra informativa. Se una InfoWindow viene aperta con un ancoraggio, pixelOffset verrà calcolato dalla proprietà anchorPoint dell'ancoraggio.
position optional
Tipo:  LatLng|LatLngLiteral optional
Il LatLng in cui visualizzare la InfoWindow. Se la InfoWindow viene aperta con un ancoraggio, al suo posto verrà utilizzata la posizione dell'ancoraggio.
zIndex optional
Tipo:  number optional
Tutte le InfoWindows vengono visualizzate sulla mappa in ordine zIndex, con i valori più alti visualizzati davanti a InfoWindows con valori più bassi. Per impostazione predefinita, le finestre informative vengono visualizzate in base alla latitudine, mentre le finestre InfoWindows delle latitudini inferiori vengono visualizzate davanti a Windows Info a latitudine più elevate. Le finestre informative vengono sempre visualizzate davanti agli indicatori.

Interfaccia InfoWindowOpenOptions

Interfaccia google.maps.InfoWindowOpenOptions

Opzioni per l'apertura di una finestra informativa
anchor optional
L'ancoraggio a cui verrà posizionata questa InfoWindow. Se l'ancoraggio è diverso da null, la finestra InfoWindow verrà posizionata nella parte superiore centrale dell'ancoraggio. La finestra InfoWindow verrà visualizzata sulla stessa mappa o panoramica dell'ancoraggio (se disponibile).
map optional
Tipo:  Map|StreetViewPanorama optional
La mappa o la panoramica su cui eseguire il rendering di questa InfoWindow.
shouldFocus optional
Tipo:  boolean optional
Indica se lo stato attivo deve essere spostato o meno all'interno della InfoWindow quando viene aperta. Se questa proprietà non è impostata o è impostata su null o undefined, viene utilizzata un'euristica per decidere se spostare o meno lo stato attivo. Ti consigliamo di impostare esplicitamente questa proprietà in base alle tue esigenze perché l'euristica è soggetta a modifiche e potrebbe non funzionare bene per tutti i casi d'uso.