Google Maps Platform 即将推出全新地图样式。此次地图样式更新包括全新默认调色板，以及地图体验和易用性方面的改进。所有地图样式将于 2025 年 3 月自动更新。如需详细了解适用范围以及如何提前选择启用，请参阅全新 Google Maps Platform 地图样式。

此页面由 Cloud Translation API 翻译。

Info Window

InfoWindow 类

google.maps.InfoWindow 类

叠加层外观与提示框类似，通常会连接到某个标记。

此类扩展 MVCObject。

可通过调用 const {InfoWindow} = await google.maps.importLibrary("maps") 或 const {InfoWindow} = await google.maps.importLibrary("streetView") 进行访问。请参阅 Maps JavaScript API 中的库。

构造函数
`InfoWindow`	`InfoWindow([opts])` 参数： `opts`：`InfoWindowOptions optional` 使用指定选项创建一个信息窗口。信息窗口可以放置在地图上的特定位置，也可以放置在标记上方，具体取决于选项中指定的内容。除非停用自动平移，否则信息窗口会在打开时平移地图，以便让自己显示出来。信息窗口构建完毕后，必须调用 open 函数，才能将其显示在地图上。用户可以点击信息窗口上的关闭按钮将其从地图中关闭，开发人员也可以调用 close() 函数实现同样的效果。

构造函数

InfoWindow

InfoWindow([opts])

参数：

opts：InfoWindowOptions optional

使用指定选项创建一个信息窗口。信息窗口可以放置在地图上的特定位置，也可以放置在标记上方，具体取决于选项中指定的内容。除非停用自动平移，否则信息窗口会在打开时平移地图，以便让自己显示出来。信息窗口构建完毕后，必须调用 open 函数，才能将其显示在地图上。用户可以点击信息窗口上的关闭按钮将其从地图中关闭，开发人员也可以调用 close() 函数实现同样的效果。

属性
`isOpen`	类型：`boolean` 检查信息窗口是否打开。

方法
`close`	`close()` 参数：无返回值：None 关闭此信息窗口，方法是将其从 DOM 结构中删除。
`focus`	`focus()` 参数：无返回值：None 将焦点设置在此`InfoWindow`上。您不妨考虑将此方法与 `visible` 事件结合使用，以确保 `InfoWindow` 在设置焦点之前可见。不可见的 `InfoWindow` 无法获得焦点。
`getContent`	`getContent()` 参数：无返回值：`string\|Element\|Text\|null\|undefined`此信息窗口的内容。与之前为内容设置的内容相同。
`getHeaderContent`	`getHeaderContent()` 参数：无返回值：`string\|Element\|Text\|null\|undefined`此信息窗口的标头内容。请参阅 `InfoWindowOptions.headerContent`。
`getHeaderDisabled`	`getHeaderDisabled()` 参数：无返回值：`boolean\|undefined` 是否停用整个标题行。请参阅 `InfoWindowOptions.headerDisabled`。
`getPosition`	`getPosition()` 参数：无返回值：`LatLng\|null\|undefined`此信息窗口的 LatLng 位置。
`getZIndex`	`getZIndex()` 参数：无返回值：`number`该信息窗口的 zIndex。
`open`	`open([options, anchor])` 参数： `options`：`InfoWindowOpenOptions\|Map\|StreetViewPanorama optional` InfoWindowOpenOptions 对象（推荐）或要在其上呈现此信息窗口的地图\|全景图片。 `anchor`：`MVCObject\|AdvancedMarkerElement optional`信息窗口将放置到的锚点。如果锚点为非空，则信息窗口将定位在锚点的上中心。信息窗口将渲染在与锚点相同的地图或全景上（如果可用）。返回值：None 在指定的地图上打开此信息窗口。信息窗口可以与锚点相关联（可选）。在核心 API 中，唯一的锚点是 Marker 类。不过，锚点可以是公开 LatLng `position` 属性以及用于计算 `pixelOffset` 的 Point `anchorPoint` 属性的任意 MVCObject（请参见 InfoWindowOptions）。`anchorPoint` 是从锚点位置到信息窗口顶端的偏移量。建议使用 `InfoWindowOpenOptions` 接口作为此方法的单个参数。为了防止将浏览器焦点更改为打开时，请将 `InfoWindowOpenOptions.shouldFocus` 设置为 `false`。
`setContent`	`setContent([content])` 参数： `content`：`string\|Element\|Text optional`此信息窗口要显示的内容。返回值：None
`setHeaderContent`	`setHeaderContent([headerContent])` 参数： `headerContent`：`string\|Element\|Text optional`此信息窗口要显示的标题内容。请参阅 `InfoWindowOptions.headerContent`。返回值：None
`setHeaderDisabled`	`setHeaderDisabled([headerDisabled])` 参数： `headerDisabled`：`boolean optional` 指定是否停用整个标题行。请参阅 `InfoWindowOptions.headerDisabled`。返回值：None
`setOptions`	`setOptions([options])` 参数： `options`：`InfoWindowOptions optional` 返回值：None
`setPosition`	`setPosition([position])` 参数： `position`：`LatLng\|LatLngLiteral optional`显示此信息窗口的 LatLng 位置。返回值：None
`setZIndex`	`setZIndex(zIndex)` 参数： `zIndex`：`number`此信息窗口的 Z-index。Z-index 较高的信息窗口会显示在其他所有 Z-index 较低的信息窗口前面。返回值：None
已继承： `addListener`、`bindTo`、`get`、`notify`、`set`、`setValues`、`unbind`、`unbindAll`

活动
`close`	`function()` 参数：None 每当 `InfoWindow` 关闭时都会触发此事件。例如，调用 `InfoWindow.close` 方法、按 Esc 键关闭信息窗口、点击关闭按钮或将信息窗口移至其他地图。
`closeclick`	`function()` 参数：None 点击关闭按钮时会触发此事件。
`content_changed`	`function()` 参数：None 内容属性更改时会触发此事件。
`domready`	`function()` 参数：None 当包含 `InfoWindow` 内容的 `<div>` 附加到 DOM 时，会触发此事件。如果您要动态构建信息窗口内容，则可能希望监视此事件。
`headercontent_changed`	`function()` 参数：None 当 headerContent 属性更改时会触发此事件。
`headerdisabled_changed`	`function()` 参数：None 当 headerDisabled 属性更改时会触发此事件。
`position_changed`	`function()` 参数：None 位置属性更改时会触发此事件。
`visible`	`function()` 参数：None 当 `InfoWindow` 完全可见时会触发此事件。当 `InfoWindow` 平移关闭然后返回到屏幕上时，不会触发此事件。
`zindex_changed`	`function()` 参数：None 当 `InfoWindow` 的 zIndex 发生更改时会触发此事件。

InfoWindowOptions 接口

google.maps.InfoWindowOptions 接口

InfoWindowOptions 对象，用于定义可在信息窗口上设置的属性。

属性
`ariaLabel optional`	类型：`string optional` 要分配给信息窗口的 AriaLabel。
`content optional`	类型：`string\|Element\|Text optional` 要在信息窗口中显示的内容。这可以是 HTML 元素、纯文本字符串或包含 HTML 的字符串。信息窗口将根据内容调整大小。要设置内容的具体大小，请将内容设置为相应大小的 HTML 元素。
`disableAutoPan optional`	类型：`boolean optional` 默认值：`false` 停用平移地图的功能，使信息窗口在打开后完全可见。
`headerContent optional`	类型：`string\|Element\|Text optional` 要在信息窗口标题行中显示的内容。这可以是 HTML 元素或纯文本字符串。信息窗口将根据内容调整大小。要为标头内容设置明确的尺寸，请将 headerContent 设置为该尺寸的 HTML 元素。
`headerDisabled optional`	类型：`boolean optional` 停用信息窗口中的整个标题行。如果设为 true，系统会移除页眉，以便隐藏页眉内容和关闭按钮。
`maxWidth optional`	类型：`number optional` 信息窗口的最大宽度（与内容的宽度无关）。只有在调用 `open()` 之前设置此值时，系统才会考虑使用此值。如需在更改内容时更改最大宽度，请调用 `close()`、`setOptions()`，然后调用 `open()`。
`minWidth optional`	类型：`number optional` 信息窗口的最小宽度（与内容的宽度无关）。使用此属性时，强烈建议将 `minWidth` 设置为小于地图宽度（以像素为单位）的值。只有在调用 `open()` 之前设置此值时，系统才会考虑使用此值。如需在更改内容时更改最小宽度，请调用 `close()`、`setOptions()`，然后调用 `open()`。
`pixelOffset optional`	类型：`Size optional` 信息窗口的顶端相对于地图上锚定信息窗口的地理坐标点的偏移量（以像素为单位）。如果信息窗口是通过锚点打开的，则系统将根据锚点的 `anchorPoint` 属性计算 `pixelOffset`。
`position optional`	类型：`LatLng\|LatLngLiteral optional` 用于显示此信息窗口的 LatLng。如果信息窗口通过锚点打开，则系统将使用锚点的位置。
`zIndex optional`	类型：`number optional` 所有信息窗口都按其 zIndex 的顺序显示在地图上，值较高的信息窗口显示在值较低的信息窗口前面。默认情况下，信息窗口根据纬度显示，纬度较低的信息窗口显示在纬度较高的信息窗口前面。信息窗口始终在标记前面显示。

InfoWindowOpenOptions 接口

google.maps.InfoWindowOpenOptions 接口

用于打开信息窗口的选项

属性
`anchor optional`	类型：`MVCObject\|AdvancedMarkerElement optional` 此信息窗口将放置到的锚点。如果锚点为非空，则信息窗口将定位在锚点的上中心。信息窗口将渲染在与锚点相同的地图或全景上（如果可用）。
`map optional`	类型：`Map\|StreetViewPanorama optional` 用来渲染此信息窗口的地图或全景图片。
`shouldFocus optional`	类型：`boolean optional` 信息窗口打开时是否应将其移动至该窗口内。如果未设置此属性或者将其设置为 `null` 或 `undefined`，系统会使用启发法来确定是否应移动焦点。建议您根据自己的需求明确设置此属性，因为启发法随时可能更改，并且可能不适合所有用例。

Info Window

InfoWindow 类

构造函数

属性

方法

活动

InfoWindowOptions 接口

属性

InfoWindowOpenOptions 接口

属性