Info Window

Klasse InfoWindow

google.maps.InfoWindow-Klasse

Ein Overlay, das wie eine Blase aussieht und oft mit einer Markierung verbunden ist.

Diese Klasse erweitert MVCObject.

Rufen Sie const {InfoWindow} = await google.maps.importLibrary("maps") oder const {InfoWindow} = await google.maps.importLibrary("streetView") auf, um darauf zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
InfoWindow
InfoWindow([opts])
Parameter:
Erstellt ein Infofenster mit den angegebenen Optionen. Ein Infofenster kann auf einer Karte, je nach angegebenen Optionen, an einer bestimmten Position oder oberhalb einer Markierung platziert werden. Ein InfoFenster schwenkt die Karte, so dass es beim Öffnen sichtbar wird, es sei denn, automatisches Schwenken ist inaktiviert. Nachdem Sie ein InfoWindow konstruiert haben, rufen Sie Öffnen auf, damit es auf der Karte angezeigt wird. Der Nutzer kann auf die Schaltfläche "Schließen" in InfoWindow klicken, um es aus der Karte zu entfernen. Alternativ kann der Entwickler zum gleichen Zweck "close()" aufrufen.
close
close()
Parameter:Keine
Rückgabewert: Keine
Schließt dieses Infofenster, indem es aus der DOM-Struktur entfernt wird.
focus
focus()
Parameter:Keine
Rückgabewert: Keine
Legt den Fokus auf dieses InfoWindow-Objekt. Sie können diese Methode zusammen mit einem visible-Ereignis verwenden, damit InfoWindow sichtbar ist, bevor Sie den Fokus darauf richten. Ein InfoWindow, das nicht sichtbar ist, kann nicht fokussiert werden.
getContent
getContent()
Parameter:Keine
Rückgabewert:  string|Element|Text|null|undefined Der Inhalt dieses Infofensters. Es sind die Einstellungen, die zuvor für die Inhalte festgelegt wurden.
getPosition
getPosition()
Parameter:Keine
Rückgabewert:  LatLng|null|undefined Die Position „LatLng“ dieses Infofensters.
getZIndex
getZIndex()
Parameter:Keine
Rückgabewert:number Der zIndex dieses InfoWindow.
open
open([options, anchor])
Parameter:
  • options: InfoWindowOpenOptions|Map|StreetViewPanorama optional: Entweder ein InfoWindowOpenOptions-Objekt (empfohlen) oder die Karte|Panorama, für das dieses InfoWindow gerendert werden soll.
  • anchor:  MVCObject|AdvancedMarkerElement optional Der Anker, an dem dieses Infofenster platziert wird. Wenn der Anker nicht null ist, wird das InfoWindow oben in der Mitte des Ankers positioniert. Das InfoWindow wird auf derselben Karte oder demselben Panorama gerendert wie der Anker (sofern verfügbar).
Rückgabewert: Keine
Öffnet dieses InfoWindow in der angegebenen Karte. Optional kann ein InfoWindow mit einem Anker verbunden werden. Im Kern-API ist der einzige Anker die Markierungsklasse. Ein Anker kann jedoch ein beliebiges MVCObject, das eine LatLng-position-Eigenschaft verfügbar macht, und optional eine Point-anchorPoint-Property für die Berechnung des pixelOffsets (siehe „InfoWindowOptions“). anchorPoint ist der Abstand von der Position des Ankers zur Spitze des Infofensters. Es wird empfohlen, die Schnittstelle InfoWindowOpenOptions als einzelnes Argument für diese Methode zu verwenden. Wenn der Browserfokus nicht geöffnet werden soll, legen Sie für InfoWindowOpenOptions.shouldFocus den Wert false fest.
setContent
setContent([content])
Parameter:
  • content:  string|Element|Text optional Der Inhalt, der von diesem Infofenster angezeigt werden soll
Rückgabewert: Keine
setOptions
setOptions([options])
Parameter:
Rückgabewert: Keine
setPosition
setPosition([position])
Parameter:
  • position:  LatLng|LatLngLiteral optional die Position „LatLng“, an der dieses Infofenster angezeigt werden soll
Rückgabewert: Keine
setZIndex
setZIndex(zIndex)
Parameter:
  • zIndex:  number Der Z-Index für dieses Infofenster. Ein InfoWindow mit einem größeren Z-Index wird vor allen anderen InfoWindows mit einem niedrigeren Z-Index angezeigt.
Rückgabewert: Keine
Übernommen: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn auf die Schalfläche Schließen geklickt wurde.
content_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft Inhalt ändert.
domready
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn der <div> mit dem Inhalt von InfoWindow an das DOM angehängt wird. Möglicherweise möchten Sie dieses Ereignis überwachen, falls Sie Ihren Infofenster-Inhalt dynamisch erstellen.
position_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft Position ändert.
visible
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn InfoWindow vollständig sichtbar ist. Dieses Ereignis wird nicht ausgelöst, wenn InfoWindow geschwenkt wird und dann wieder auf dem Bildschirm erscheint.
zindex_changed
function()
Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich der zIndex der InfoWindow ändert.

Schnittstelle InfoWindowOptions

Schnittstelle google.maps.InfoWindowOptions

InfoWindowOptions-Objekt, mit dem die Attribute definiert werden, die für ein Infofenster festgelegt werden können.
ariaLabel optional
Typ:string optional
AriaLabel, das dem InfoWindow zugewiesen werden soll.
content optional
Typ:string|Element|Text optional
Im InfoFenster anzuzeigender Inhalt. Dies kann ein HTML-Element sein, eine reine Zeichenfolge oder eine Zeichenfolge, die HTML enthält. Die Größe des InfoFensters wird seinem Inhalt angepasst. Um ausdrücklich eine Größe für den Inhalt zu bestimmen, legen Sie fest, dass der Inhalt ein HTML-Element mit dieser Größe sein soll.
disableAutoPan optional
Typ:boolean optional
Standard: false
Schwenke die Karte nicht, damit das Infofenster beim Öffnen vollständig sichtbar ist.
maxWidth optional
Typ:number optional
Maximale Breite des Infofensters, unabhängig von der Breite des Contents. Dieser Wert wird nur berücksichtigt, wenn er vor einem Aufruf von open() festgelegt wird. Um die maximale Breite beim Ändern von Inhalten zu ändern, rufen Sie close(), setOptions() und dann open() auf.
minWidth optional
Typ:number optional
Mindestbreite des Infofensters, unabhängig von der Breite des Contents. Bei Verwendung dieser Eigenschaft wird dringend empfohlen, für minWidth einen Wert festzulegen, der kleiner als die Breite der Karte ist (in Pixeln). Dieser Wert wird nur berücksichtigt, wenn er vor einem Aufruf von open() festgelegt wird. Um die Mindestbreite beim Ändern von Inhalten zu ändern, rufen Sie close(), setOptions() und dann open() auf.
pixelOffset optional
Typ:Size optional
Der Abstand in Pixeln zwischen der Spitze des Infofensters und dem Punkt auf der Karte, an dessen geografischen Koordinaten das Infofenster verankert ist. Wenn ein Infofenster mit einem Anker geöffnet wird, wird die pixelOffset aus der Eigenschaft anchorPoint des Ankers berechnet.
position optional
Typ:LatLng|LatLngLiteral optional
Der LatLng-Wert, bei der diesem InfoWindow angezeigt werden soll. Wird das Infofenster mit einem Anker geöffnet, wird stattdessen die Position des Ankers verwendet.
zIndex optional
Typ:number optional
Sämtliche InfoWindow-Elemente werden auf der Karte in der Reihenfolge ihrer zIndex angezeigt, wobei InfoWindow-Elemente mit höheren Werten vor InfoWindow-Elementen mit niedrigeren Werten rangieren. Standardmäßig wird InfoWindows entsprechend dem Breitengrad angezeigt. InfoWindows-Elemente werden immer vor Markierungen angezeigt.

Schnittstelle InfoWindowOpenOptions

Schnittstelle google.maps.InfoWindowOpenOptions

Optionen zum Öffnen eines Infofensters
anchor optional
Der Anker, zu dem dieses Infofenster passt. Wenn der Anker nicht null ist, wird das InfoWindow oben in der Mitte des Ankers positioniert. Das InfoWindow wird auf derselben Karte oder demselben Panorama gerendert wie der Anker (sofern verfügbar).
map optional
Typ:Map|StreetViewPanorama optional
Die Karte oder das Panorama, auf der bzw. dem dieses InfoWindow gerendert werden soll.
shouldFocus optional
Typ:boolean optional
Gibt an, ob der Fokus innerhalb des Infofensters verschoben werden soll, wenn es geöffnet wird. Wenn diese Eigenschaft nicht festgelegt ist oder auf null oder undefined festgelegt ist, wird anhand einer Heuristik bestimmt, ob der Fokus verschoben werden soll. Es wird empfohlen, dieses Attribut explizit an Ihre Anforderungen anzupassen, da die Heuristik sich ändern kann und möglicherweise nicht für alle Anwendungsfälle geeignet ist.