Info Window

Класс InfoWindow

google.maps.InfoWindow class
extends MVCObject
library "maps", "streetView"

Оверлей, который выглядит как всплывающая подсказка и часто связан с маркером.

const {InfoWindow} = await google.maps.importLibrary("maps");

или

const {InfoWindow} = await google.maps.importLibrary("streetView");

Конструктор

InfoWindow

InfoWindow([opts]) Параметры: opts: InfoWindowOptions optional. Создает информационное окно с заданными параметрами. Объект InfoWindow можно разместить на карте в определенной позиции или над маркером в зависимости от того, что указано в параметрах. Если автоматическое панорамирование не отключено, при открытии информационного окна карта будет сдвинута так, чтобы окно было видно. После создания информационного окна InfoWindow, необходимо вызвать open, чтобы отобразить его на карте Пользователь может нажать кнопку закрытия в окне InfoWindow, чтобы убрать его с карты. Разработчик может добиться того же эффекта, вызвав метод close().

Свойства
isOpen readonly	Тип: boolean Проверяет, открыто ли информационное окно.

Методы
close	close() Параметры: нет. Возвращаемое значение: нет. Закрывает это окно InfoWindow, удаляя его из структуры DOM.
focus	focus() Параметры: нет. Возвращаемое значение: нет. Устанавливает фокус на этом 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 – привязка, по которой будет позиционироваться это информационное окно. Если привязка не равна null, окно InfoWindow будет расположено вверху по центру привязки. Информационное окно будет показано на той же карте или панораме, что и привязка (если доступно). Возвращаемое значение: нет. Открывает это информационное окно на указанной карте. При необходимости объект InfoWindow можно связать с якорем. В основном API единственным якорем является класс Marker. Однако в качестве привязки можно использовать любой объект MVCObject, который предоставляет свойство LatLng position и, при необходимости, свойство Point anchorPoint для расчета pixelOffset (см. InfoWindowOptions). anchorPoint – это смещение от позиции маркера до указателя информационного окна. Рекомендуется использовать интерфейс InfoWindowOpenOptions в качестве единственного аргумента для этого метода. Чтобы фокус не менялся, задайте для параметра InfoWindowOpenOptions.shouldFocus значение false.
setContent	setContent([content]) Параметры: content: string|Element|Text optional Контент, который будет показан в этом окне InfoWindow. Возвращаемое значение: нет.
setHeaderContent	setHeaderContent([headerContent]) Параметры: headerContent: string|Element|Text optional Содержимое заголовка, которое будет отображаться в этом информационном окне. Подробнее InfoWindowOptions.headerContent… Возвращаемое значение: нет.
setHeaderDisabled	setHeaderDisabled([headerDisabled]) Параметры: headerDisabled: boolean optional указывает, нужно ли отключить всю строку заголовка. Подробнее InfoWindowOptions.headerDisabled… Возвращаемое значение: нет.
setOptions	setOptions([options]) Параметры: options: InfoWindowOptions optional. Возвращаемое значение: нет.
setPosition	setPosition([position]) Параметры: position: LatLng|LatLngLiteral optional Координаты LatLng, в которых должно показываться это окно InfoWindow. Возвращаемое значение: нет.
setZIndex	setZIndex(zIndex) Параметры: zIndex: number Значение z-index для этого информационного окна. Информационное окно с более высоким Z-индексом будет отображаться поверх всех остальных информационных окон с более низким Z-индексом. Возвращаемое значение: нет.
Унаследованные: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll.

События
close	function() Аргументы: нет. Это событие активируется при закрытии InfoWindow. Например, это может произойти при вызове метода InfoWindow.close, нажатии клавиши Esc, нажатии кнопки закрытия или перемещении InfoWindow на другую карту.
closeclick	function() Аргументы: нет. Это событие активируется, когда пользователь нажимает кнопку закрытия.
content_changed	function() Аргументы: нет. Это событие активируется при изменении свойства content.
domready	function() Аргументы: нет. Это событие активируется, когда элемент <div>, содержащий контент InfoWindow, прикрепляется к DOM. Это событие можно отслеживать, если содержание информационного окна создается динамически.
headercontent_changed	function() Аргументы: нет. Это событие активируется при изменении свойства headerContent.
headerdisabled_changed	function() Аргументы: нет. Это событие активируется при изменении свойства headerDisabled.
position_changed	function() Аргументы: нет. Это событие активируется при изменении свойства position.
visible	function() Аргументы: нет. Это событие активируется, когда InfoWindow полностью виден. Это событие не регистрируется, если InfoWindow перемещается за пределы экрана, а затем возвращается.
zindex_changed	function() Аргументы: нет. Это событие активируется при изменении zIndex объекта InfoWindow.

Интерфейс InfoWindowOptions

google.maps.InfoWindowOptions интерфейс

Объект InfoWindowOptions, используемый для определения свойств, которые можно задать для InfoWindow.

Свойства
ariaLabel необязательно	Тип: string optional AriaLabel, который нужно назначить для InfoWindow.
content необязательно	Тип: string|Element|Text optional Контент, который будет показываться в информационном окне. Это может быть элемент HTML, строка обычного текста или строка, содержащая HTML. Размер окна InfoWindow будет соответствовать размеру контента. Чтобы задать точный размер контента, укажите его в элементе HTML.
disableAutoPan необязательно	Тип: boolean optional По умолчанию: false. Отключить панорамирование карты, чтобы сделать окно InfoWindow полностью видимым при открытии.
headerContent необязательно	Тип: string|Element|Text optional Контент, который будет показываться в строке заголовка InfoWindow. Это может быть элемент HTML или строка обычного текста. Размер окна InfoWindow будет соответствовать размеру контента. Чтобы задать точный размер контента заголовка, укажите для headerContent элемент HTML с нужным размером.
headerDisabled необязательно	Тип: boolean optional Отключает всю строку заголовка в информационном окне. Если задано значение true, заголовок будет удален, а его контент и кнопка закрытия будут скрыты.
maxWidth необязательно	Тип: number optional Максимальная ширина информационного окна независимо от ширины контента. Это значение учитывается, только если оно задано до вызова open(). Чтобы изменить максимальную ширину при изменении контента, вызовите close(), setOptions(), а затем open().
minWidth необязательно	Тип: number optional Минимальная ширина информационного окна независимо от ширины контента. При использовании этого свойства настоятельно рекомендуется задать для minWidth значение, которое меньше ширины карты (в пикселях). Это значение учитывается, только если оно задано до вызова open(). Чтобы изменить минимальную ширину при изменении контента, вызовите close(), setOptions(), а затем open().
pixelOffset необязательно	Тип: Size optional Смещение (в пикселях) указателя информационного окна относительно точки на карте, к географическим координатам которой привязано это окно. Если информационное окно открывается с привязкой, pixelOffset будет рассчитываться на основе свойства anchorPoint привязки.
position необязательно	Тип: LatLng|LatLngLiteral optional Координаты LatLng, по которым должно показываться информационное окно. Если окно InfoWindow открывается с привязкой, вместо этого будет использоваться положение привязки.
zIndex необязательно	Тип: number optional Все окна InfoWindow отображаются на карте в порядке, определяемом значением zIndex. Окна с более высокими значениями отображаются поверх окон с низкими значениями. По умолчанию информационные окна отображаются в соответствии с их широтой: окна с меньшей широтой показываются перед окнами с большей широтой. Информационные окна всегда отображаются поверх маркеров.

Интерфейс InfoWindowOpenOptions

google.maps.InfoWindowOpenOptions интерфейс

Параметры открытия информационного окна

Свойства
anchor необязательно	Тип: MVCObject|AdvancedMarkerElement optional Якорь, к которому будет привязано информационное окно. Если привязка не равна null, окно InfoWindow будет расположено вверху по центру привязки. Информационное окно будет показано на той же карте или панораме, что и привязка (если доступно).
map необязательно	Тип: Map|StreetViewPanorama optional Карта или панорама, на которой нужно показать это информационное окно.
shouldFocus необязательно	Тип: boolean optional Указывает, нужно ли перемещать фокус в информационное окно при его появлении. Если это свойство не задано или ему присвоено значение null или undefined, то для принятия решения о перемещении фокуса используется эвристика. Рекомендуется явно задать это свойство в соответствии с вашими потребностями, поскольку эвристика может измениться и не всегда работает хорошо.