Info Window

klasa InfoWindow

google.maps.InfoWindow zajęcia

Nakładka przypominająca dymek i często połączona ze znacznikiem.

Te zajęcia są rozszerzone na MVCObject.

Aby uzyskać dostęp, zadzwoń pod numer const {InfoWindow} = await google.maps.importLibrary("maps") lub const {InfoWindow} = await google.maps.importLibrary("streetView"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
InfoWindow
InfoWindow([opts])
Parametry: 
Tworzy okno informacyjne z podanymi opcjami. Okno InfoWindow można umieścić na mapie w określonym miejscu lub nad znacznikiem, w zależności od tego, co zostało określone w opcjach. Jeśli automatyczne przesuwanie nie jest wyłączone, okno InfoWindow przesuwa mapę, by była widoczna po jej otwarciu. Po utworzeniu okna informacyjnego musisz wywołać polecenie open, aby wyświetlić je na mapie. Użytkownik może kliknąć przycisk zamykania w oknie InfoWindow, by usunąć je z mapy, lub programista może użyć funkcji Close() w celu uzyskania tego samego efektu.
close
close()
Parametry: brak
Zwracana wartość: brak
Zamyka to InfoWindow przez usunięcie go ze struktury DOM.
focus
focus()
Parametry: brak
Zwracana wartość: brak
Uaktywnia fokus na tym elemencie: InfoWindow. Zastanów się nad użyciem tej metody razem ze zdarzeniem visible, aby przed ustawieniem zaznaczenia na mapie było widoczne pole InfoWindow. Nie można zaznaczyć niewidocznego elementu InfoWindow.
getContent
getContent()
Parametry: brak
Zwracana wartość:  string|Element|Text|null|undefined zawartość tego okna informacyjnego. Taka sama jak wcześniej ustawiona jako treść.
getPosition
getPosition()
Parametry: brak
Zwracana wartość:  LatLng|null|undefined położenie położenia geograficznego tego okna informacyjnego.
getZIndex
getZIndex()
Parametry: brak
Zwracana wartość:  number wartość zIndex tego okna informacyjnego.
open
open([options, anchor])
Parametry: 
  • options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional obiekt InfoWindowOpenOptions (zalecany) lub mapa|panorama, na której ma być renderowane to okno InfoWindow.
  • anchor:  MVCObject|AdvancedMarkerElement optional kotwica, w której zostanie umieszczone to okno informacyjne. Jeśli kotwica nie ma wartości null, okno informacyjne zostanie umieszczone w górnej środkowej części kotwicy. Okno InfoWindow będzie renderowane na tej samej mapie lub w panoramie co reklama zakotwiczona (jeśli będzie dostępna).
Zwracana wartość: brak
Otwiera okno InfoWindow na podanej mapie. Opcjonalnie okno InfoWindow może być powiązane z kotwicą. W podstawowym interfejsie API jedyną kotwicą jest klasa Marka. Kotwica może być jednak dowolnym obiektem MVCObject, który udostępnia właściwość latLng position i opcjonalnie właściwość Point anchorPoint do obliczania pixelOffset (zobacz InfoWindowOptions). anchorPoint to odsunięcie położenia kotwicy do końca okna informacyjnego. Zaleca się użycie interfejsu InfoWindowOpenOptions jako jednego argumentu tej metody. Aby zapobiec zmianie fokusu przeglądarki przy otwarciu, ustaw InfoWindowOpenOptions.shouldFocus na false.
setContent
setContent([content])
Parametry: 
  • content:  string|Element|Text optional treść, która ma być wyświetlana w tym oknie InfoWindow.
Zwracana wartość: brak
setOptions
setOptions([options])
Parametry: 
Zwracana wartość: brak
setPosition
setPosition([position])
Parametry: 
  • position:  LatLng|LatLngLiteral optional położenie geograficzne, w którym ma być wyświetlane okno informacyjne.
Zwracana wartość: brak
setZIndex
setZIndex(zIndex)
Parametry: 
  • zIndex:  number kolejność nakładania elementów w oknie InfoWindow. Okno InfoWindow o większej wartości kolejności nakładania elementów będzie wyświetlane przed wszystkimi innymi systemami InfoWindows i o niższej wartości.
Zwracana wartość: brak
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
Argumenty: brak
To zdarzenie jest uruchamiane przy każdym zamknięciu InfoWindow. Może to być na przykład wywołanie metody InfoWindow.close, naciśnięcie klawisza Escape w celu zamknięcia okna informacyjnego, kliknięcie przycisku zamykania lub przeniesienie okna InfoWindow na inną mapę.
closeclick
function()
Argumenty: brak
Zdarzenie to jest wywoływane po kliknięciu przycisku zamykania.
content_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości treści.
domready
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy element <div> zawierający treść elementu InfoWindow jest dołączony do DOM. Jeśli treść okna informacyjnego jest tworzona dynamicznie, możesz monitorować to zdarzenie.
position_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości pozycji.
visible
function()
Argumenty: brak
To zdarzenie jest uruchamiane, gdy InfoWindow jest w pełni widoczny. To zdarzenie nie jest uruchamiane, gdy przesuniesz kamerę InfoWindow, a następnie ponownie pojawi się na ekranie.
zindex_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy wartość zIndex zmieni się dla parametru InfoWindow.

Interfejs InfoWindowOptions

google.maps.InfoWindowOptions interfejs

Obiekt InfoWindowOptions używany do definiowania właściwości, które można ustawić w InfoWindow.
ariaLabel optional
Typ:  string optional
AriaLabel do przypisania do InfoWindow.
content optional
Typ:  string|Element|Text optional
Zawartość do wyświetlenia w oknie InfoWindow. Może to być element HTML, zwykły ciąg tekstowy lub ciąg tekstowy zawierający kod HTML. Rozmiar okna InfoWindow jest dostosowywany do treści. Aby ustawić jawny rozmiar treści, skonfiguruj ją jako element HTML o tym rozmiarze.
disableAutoPan optional
Typ:  boolean optional
Wartość domyślna: false
Wyłącz przesuwanie mapy, aby okno InfoWindow było w pełni widoczne po otwarciu.
maxWidth optional
Typ:  number optional
Maksymalna szerokość okna InfoWindow niezależnie od szerokości treści. Ta wartość jest brana pod uwagę tylko wtedy, gdy została ustawiona przed wywołaniem funkcji open(). Aby zmienić maksymalną szerokość przy zmianie treści, wywołaj close(), setOptions(), a następnie open().
minWidth optional
Typ:  number optional
Minimalna szerokość okna InfoWindow, niezależnie od szerokości treści. Jeśli używasz tej właściwości, zdecydowanie zalecamy ustawienie parametru minWidth na wartość mniejszą niż szerokość mapy (w pikselach). Ta wartość jest brana pod uwagę tylko wtedy, gdy została ustawiona przed wywołaniem funkcji open(). Aby zmienić minimalną szerokość przy zmianie treści, wywołaj close(), setOptions(), a następnie open().
pixelOffset optional
Typ:  Size optional
Przesunięcie (w pikselach) końcówki okna informacyjnego od punktu na mapie, w którym zakotwiczone jest okno informacyjne ze współrzędnymi geograficznymi. Jeśli okno InfoWindow jest otwarte z kotwicą, wartość pixelOffset zostanie obliczona na podstawie właściwości anchorPoint kotwicy.
position optional
Typ:  LatLng|LatLngLiteral optional
Lokalizacja geograficzna, do której ma być wyświetlane to okno informacyjne. Jeśli okno InfoWindow jest otwarte za pomocą kotwicy, zostanie użyta jej pozycja.
zIndex optional
Typ:  number optional
Wszystkie systemy InfoWindows są wyświetlane na mapie w kolejności według ich zIndex – wyższe wartości są wyświetlane przed systemem InfoWindows, a niższe. Domyślnie InfoWindows są wyświetlane według szerokości geograficznej. W większych miejscach przed systemem InfoWindows wyświetlane są niższe szerokości geograficzne. System InfoWindows jest zawsze wyświetlany przed znacznikami.

Interfejs InfoWindowOpenOptions

google.maps.InfoWindowOpenOptions interfejs

Opcje otwierania okna informacyjnego
anchor optional
Kotwica, w której zostanie umieszczone to okno InfoWindow. Jeśli kotwica nie ma wartości null, okno informacyjne zostanie umieszczone w górnej środkowej części kotwicy. Okno InfoWindow będzie renderowane na tej samej mapie lub w panoramie co reklama zakotwiczona (jeśli będzie dostępna).
map optional
Typ:  Map|StreetViewPanorama optional
Mapa lub panorama, na których ma być renderowane to okno informacyjne.
shouldFocus optional
Typ:  boolean optional
Określa, czy należy przenieść zaznaczenie w oknie InfoWindow, gdy jest ono otwarte. Gdy właściwość jest nieskonfigurowana lub ma wartość null lub undefined, do ustalenia, czy należy przenieść zaznaczenie, używana jest heurystyka. Zalecamy wyraźne ustawienie tej właściwości zgodnie ze swoimi potrzebami, ponieważ heurystyka może się zmieniać i może nie działać dobrze w niektórych przypadkach.