---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Balloon.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/llms.txt

# geoObject.Balloon

Менеджер балуна геообъекта. Позволяет управлять балуном геообъекта, открывать и скрывать его. Использует внутри себя менеджер балуна карты [map.Balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Balloon.md). Геообъекты содержат экземпляр этого класса, доступный как myGeoObject.balloon. Не создавайте экземпляры этого класса без необходимости.

**См.: **[GeoObject.balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#balloon)

## Конструктор {#constructor}

```javascript
geoObject.Balloon(geoObject)
```

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `geoObject`[*](*parametr) | — | Тип: Object

Геообъект. ||
|#

\* Обязательный параметр/опция.

## Поля {#fields}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [events](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Balloon.md#events) | [event.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/event.Manager.md) | Менеджер событий балуна геообъекта. ||
|#

## События {#events}

#|
|| **Имя** | **Описание** ||
|| [close](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Balloon.md#close) | Закрытие балуна. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). ||
|| [open](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Balloon.md#open) | Открытие балуна. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• balloon - экземпляр класса [Balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Balloon.md). ||
|#

## Методы {#method}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [calculatePixelPosition](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Balloon.md#calculatePixelPosition)([[anchorPixels](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Balloon.md#calculatePixelPosition-param-anchorPixels)]) |  | Определяет пиксельные координаты для открытия балуна на геообъекте. ||
|| [close](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Balloon.md#close)() |  | Закрывает балун. ||
|| [isOpen](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Balloon.md#isOpen)() | Boolean | Проверяет, открыт ли балун в данный момент. ||
|| [open](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Balloon.md#open)([[anchorPixels](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Balloon.md#open-param-anchorPixels)]) | [Balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Balloon.md) | Открывает балун. ||
|#

## Описание полей {#description-fields}

### events

```javascript
{event.Manager} events
```

Менеджер событий балуна геообъекта.

## Описание событий {#description-events}

### close

Закрытие балуна. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md).

### open

Открытие балуна. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• balloon - экземпляр класса [Balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Balloon.md).

## Описание методов {#description-methods}

### calculatePixelPosition

```javascript
{} calculatePixelPosition([anchorPixels])
```

Определяет пиксельные координаты для открытия балуна на геообъекте.

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `anchorPixels`[*](*parametr) | — | Тип: Number[]

Координаты точки привязки. Если указать данный параметр, то результатом работы функции будет точка геообъекта, которая является ближайшей к заданной точке, иначе балун откроется по возможности ближе к центру карты. ||
|#

**Пример:**

```javascript
// Открываем балун с привязкой к центру геообъекта, а не к центру карты.
// Данный метод имеет смысл для линий или для полигонов с вырезами, на которые может приходиться его центр,
// в случае чего нужно найти ближайшую к центру точку на одном из контуров, расположенных поблизости.
var polygonBounds = polygon.geometry.getBounds(),
    polygonCenter = [
        (polygonBounds[0][0] + polygonBounds[1][0]) / 2,
        (polygonBounds[0][1] + polygonBounds[1][1]) / 2
    ],
    polygonPixelCenter = myMap.options.get('projection').toGlobalPixels(polygonCenter, myMap.getZoom()),
    balloonPosition = polygon.balloon.calculatePixelPosition(polygonPixelCenter);

polygon.balloon.open(balloonPosition);
```
### close

```javascript
{} close()
```

Закрывает балун.

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `callback`[*](*parametr) | — | Тип: ||
|#

\* Обязательный параметр/опция.

# isOpen

```javascript
{Boolean} isOpen()
```

Проверяет, открыт ли балун в данный момент.

**Returns** true, если балун открыт, false - иначе.

# open

```javascript
{Balloon} open([anchorPixels])
```

Открывает балун.

**Returns** экземпляр балуна.

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `anchorPixels` | — | Тип: Number[]

Точка привязки балуна в глобальных пиксельных координатах. По умолчанию используются текущие координаты центра карты. ||
|#

\* Обязательный параметр/опция.

**Пример:**

```javascript
// Отключает открытие хинта при наведении мыши и открывает вместо него балун.
myMap.geoObjects.options.set({
    showHintOnHover: false
});

myMap.geoObjects.events.add('mouseenter', function (e) {
    var geoObject = e.get('target'),
        position = e.get('globalPixelPosition'),
        balloon = geoObject.balloon.open(position);

    balloon.events.add('mouseleave', function () {
        balloon.close();
    });
});
```

[*parametr]:Обязательный параметр/опция.