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

# GeoObject

Расширяет [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md).

Геообъект. В зависимости от типа геометрии может отображаться как метка, линия, полигон и т.д. Вы также можете использовать вспомогательные классы для упрощенного создания геообъектов с определенным типом геометрии.

**См.:** [Placemark](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Placemark.md)[Polyline](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Polyline.md)[Polygon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Polygon.md)[Circle](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Circle.md)[Rectangle](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Rectangle.md)

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

```javascript
GeoObject([feature[, options]])
```

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

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

Описание геообъекта. ||
|| `feature.geometry` | feature.geometry | Тип: [IGeometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeometry.md)\|Object

Геометрия геообъекта. Может задаваться как экземпляр класса, реализующего интерфейс [IGeometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeometry.md), либо в виде хэша с полями type и coordinates. ||
|| `feature.properties` | — | Тип: [IDataManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDataManager.md)\|Object

Данные геообъекта. Могут задаваться как экземпляр класса, реализующего интерфейс [IDataManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDataManager.md), либо в виде хэша. При значениях опций по умолчанию, геообъектом трактуются следующие поля данных:

• iconContent - содержимое иконки геообъекта;

• hintContent - содержимое всплывающей подсказки геообъекта;

• balloonContent - содержимое балуна геообъекта;

• balloonContentHeader - содержимое заголовка балуна геообъекта;

• balloonContentBody - содержимое основой части балуна геообъекта;

• balloonContentFooter - содержимое нижней части балуна геообъекта.

Поле balloonContent является кратким обозначением для поля balloonContentBody, но при одновременном задании balloonContentBody более приоритетен. Также вы можете дополнить данные геообъекта своими собственными полями и использовать их везде, где это возможно. Например в макете метки или макете балуна. ||
|| `options` | — | Тип: Object

Опции геообъекта. Используя этот параметр можно задавать как опции самого геообъекта, так и опции его составных частей: 
• Опции [балуна геообъекта](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Balloon.md#constructor-summary) с префиксом `balloon`.

• Опции [всплывающей подсказки геообъекта](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Hint.md#constructor-summary) с префиксом `hint`.

• Опции редактора геометрии геообъекта с префиксом `editor`. Тип редактора и перечень доступных опций зависит от типа геометрии геообъекта. Смотрите описание классов [geometryEditor.LineString](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geometryEditor.LineString.md), [geometryEditor.Polygon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geometryEditor.Polygon.md), [geometryEditor.Point](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geometryEditor.Point.md).

• Опции геометрии могут задаваться без префикса. Смотрите описание классов [IGeometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeometry.md) геометрий [geometry.Point](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geometry.Point.md), [geometry.Polygon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geometry.Polygon.md) и др. ||
|| `options.balloonIconImageHref` | — | Тип: String

URL графического файла иконки в балуне кластера [Cluster](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Cluster.md). ||
|| `options.balloonIconImageOffset` | —	| Тип: Number[]

Пиксельный сдвиг иконки в балуне кластера [Cluster](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Cluster.md) по отношению к родительскому элементу. ||
|| `options.balloonIconImageSize` | — | Тип: Number[]

Размер иконки в балуне кластера [Cluster](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Cluster.md) в пикселях. ||
|| `options.cursor` | "pointer" | Тип: String

Вид курсора над геообъектом. ||
|| `options.draggable` | false | Тип: Boolean

Определяет возможность перетаскивания геообъекта. ||
|| `options.fill` | true | Тип: Boolean

Наличие заливки фигуры. ||
|| `options.fillColor` | "0066ff99"| Тип: String

Цвет заливки. ||
|| `options.fillImageHref` | — | Тип: String

Фоновое изображение. При включении данной опции в режиме заливки stretch значение fillColor игнорируется. ||
|| `options.fillMethod` | 'stretch' | Тип: String

Тип заливки фоном. Может принимать одно из двух значений:
• stretch - Фоновое изображение растягивается по размеру оверлея.

• tile - Фоновое изображение повторяется без изменений размера. Аналог background-repeat в css. Можно использовать для заливки фигуры неким шаблоном. ||
|| `options.fillOpacity` | 1 | Тип: Number

Прозрачность заливки. ||
|| `options.hasBalloon` | true | Тип: Boolean

Определяет наличие поля balloon у геообъекта. ||
|| `options.hasHint` | true | Тип: Boolean

Определяет наличие поля hint у геообъекта. ||
|| `options.hideIconOnBalloonOpen` | true | Тип: Boolean

Скрывать иконку при открытии балуна. ||
|| `options.iconColor` | — | Тип: String

Цвет иконки (для растягивающихся под содержимое иконок). ||
|| `options.iconContentLayout` | — | Тип: Function\|String

Макет содержимого иконки. (Тип: конструктор объекта с интерфейсом ILayout или его ключ в хранилище). ||
|| `options.iconContentOffset` | — | Тип: Number[]

Пиксельный сдвиг содержимого иконки относительно родительского элемента. Используется в макете default#imageWithContent. ||
|| `options.iconContentPadding` | — | Тип: Number[]

Отступ для содержимого в иконке. ||
|| `options.iconContentSize` | — | Тип: Number[]

Размер содержимого. Используется в макете default#imageWithContent. ||
|| `options.iconImageClipRect` | [[0, 0], [{imageWidth}, {imageHeight}]]| Тип: Number[][]

Прямоугольная область (указывается левый верхний и правый нижний углы), которая будет вырезана из исходного графического файла и смасштабирована под размеры иконки (например для использования спрайтов). По умолчанию исходная картинка подставляется полностью. ||
|| `options.iconImageHref` | — | Тип: String

URL графического файла иконки. ||
|| `options.iconImageOffset` | — | Тип: Number[]

Пиксельный сдвиг изображения иконки внутри родительского элемента. ||
|| `options.iconImageSize` | — | Тип: Number[]

Размер иконки в пикселях. ||
|| `options.iconLayout` | — | Тип: Function\|String

Макет иконки. (Тип: конструктор объекта с интерфейсом ILayout или его ключ в хранилище). ||
|| `options.iconMaxHeight` | — | Тип: Number

Максимальная высота иконки с содержимым. ||
|| `options.iconMaxWidth` | — | Тип: Number

Максимальная ширина иконки с содержимым. ||
|| `options.iconOffset` | — | Тип: Number[]

Пиксельное смещение иконки относительно заданной позиции. ||
|| `options.iconShadow` | false | Тип: Boolean

Флаг наличия тени у иконки. ||
|| `options.iconShadowImageClipRect` | [[0, 0], [{imageWidth}, {imageHeight}]] | Тип: Number[][]

Прямоугольная область (указывается левый верхний и правый нижний углы), которая будет вырезана из исходного графического файла и смасштабирована под размеры тени (например для использования спрайтов). По умолчанию исходная картинка подставляется полностью. ||
|| `options.iconShadowImageHref` | — | Тип: String

URL графического файла тени иконки. ||
|| `options.iconShadowImageOffset` | — | Тип: Number[]

Пиксельный сдвиг изображения тени иконки внутри родительского элемента. ||
|| `options.iconShadowImageSize` | — | Тип: Number[]

Размер тени иконки. ||
|| `options.iconShadowLayout` | — | Тип: Function\|String

Макет тени иконки. (Тип: конструктор объекта с интерфейсом ILayout или его ключ в хранилище). ||
|| `options.iconShadowOffset` | — | Тип: Number[]

Пиксельное смещение тени иконки относительно заданной позиции. ||
|| `options.interactivityModel` | "default#geoObject" | Тип: String

Модель интерактивности. Доступные ключи и их значения перечислены в описании [interactivityModel.storage](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/interactivityModel.storage.md). ||
|| `options.opacity` | 1 | Тип: Number

Прозрачность. ||
|| `options.openBalloonOnClick` | true | Тип: Boolean

Определяет показывать ли балун при щелчке на геообъекте. ||
|| `options.openEmptyBalloon` | false | Тип: Boolean

Определяет показывать ли пустой балун при щелчке на геообъекте. ||
|| `options.outline` | true | Тип: Boolean

Наличие обводки фигуры. ||
|| `options.overlayFactory` | "default#interactive" | Тип: String\|[IOverlayFactory](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IOverlayFactory.md)

Фабрика оверлеев. На основе типа геометрии геообъекта создает те или иные оверлеи для отображения геообъекта. Список доступных фабрик смотрите в описании [geoObject.overlayFactory.storage](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.overlayFactory.storage.md). ||
|| `options.pane` | "overlays" | Тип: [IPane](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPane.md)\|String

Контейнер оверлея геообъекта. ||
|| `options.preset` | — | Тип: String

Ключ предустановленных опций геообъекта. Список ключей, доступных в пакетах package.standard и package.full, содержится в описании [option.presetStorage](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/option.presetStorage.md). ||
|| `options.showEmptyHint` | false | Тип: Boolean

Определяет показывать ли пустой хинт при наведении указателя мыши на геообъект. ||
|| `options.showHintOnHover` | true| Тип: Boolean

Определяет показывать ли хинт при наведении указателя мыши на геообъект. ||
|| `options.strokeColor` | "0066ffff" | Тип: String

Цвет линии или обводки. ||
|| `options.strokeOpacity` | 1 | Тип: Number

Прозрачность линии или обводки. ||
|| `options.strokeStyle` | — | Тип: String

Стиль линии или обводки. ||
|| `options.strokeWidth` | 1 | Тип: Number

Толщина линии или обводки. ||
|| `options.visible` | true | Тип: Boolean

Определяет видимость геообъекта. ||
|| `options.zIndex` | — | Тип: Number

z-index геообъекта в обычном состоянии. Наименее приоритетный. ||
|| `options.zIndexActive` | — | Тип: Number

z-index геообъекта с открытым балуном. Наиболее приоритетный. ||
|| `options.zIndexDrag` | — | Тип: Number

z-index геообъекта при перетаскивании. ||
|| `options.zIndexHover` | — | Тип: Number

z-index геообъекта при наведении на него указателя мыши. ||
|#

**Примеры:**

**1.**

```javascript
var myGeoObject = new ymaps.GeoObject({
        // Описываем геометрию типа "Ломаная линия".
        geometry: {
            type: "LineString",
            coordinates: [
                [37.61, 55.75], [13.38, 52.51]
            ]
        },
        // Описываем данные геообъекта.
        properties: {
            hintContent: "Москва-Берлин"
        }
    }, {
        // Включаем отображение в форме геодезических кривых.
        geodesic: true,
        // Задаем ширину в 5 пикселей.
        strokeWidth: 5,
        // Задаем цвет линии.
        strokeColor: "#F008"
    });
// Добавляем геообъект на карту.
geoMap.geoObjects.add(myGeoObject);
```

**2.**

```javascript
var myGeoObject = new ymaps.GeoObject({
        // Описываем геометрию типа "Точка".
        geometry: {
            type: "Point",
            coordinates: [37.61, 55.75]
        },
        // Описываем данные геообъекта.
        properties: {
            hintContent: "Москва",
            balloonContentHeader: "Москва",
            balloonContentBody: "Столица России",
            population: 11848762
        }
    }, {
        // Задаем пресет метки с точкой без содержимого.
        preset: "twirl#redDotIcon",
        // Включаем возможность перетаскивания.
        draggable: true,
        // Переопределяем макет содержимого нижней части балуна.
        balloonContentFooterLayout: ymaps.templateLayoutFactory.createClass(
            'население: $[properties.population], координаты: $[geometry.coordinates]'
        ),
        // Отключаем задержку закрытия всплывающей подсказки.
        hintHideTimeout: 0
    });
// Добавляем геообъект на карту.
geoMap.geoObjects.add(myGeoObject);
```

## Поля {#fields}

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

Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#geometry). ||
|| [hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#hint) | [geoObject.Hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoObject.Hint.md) | Хинт геообъекта. ||
|| [options](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#options) | [option.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/option.Manager.md) | Менеджер опций геообъекта. ||
|| [properties](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#properties) | [data.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/data.Manager.md) | Менеджер данных геообъекта. ||
|| [state](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#state) | [data.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/data.Manager.md) | Состояние геообъекта. Определяется следующими полями: 
• active - признак того, что на геообъекте открыт балун.

• hover - признак того, что в данный момент на геообъект наведен указатель мыши.

• drag - признак того, что геообъект перетаскивается. ||
|#

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

#|
|| **Имя** | **Описание** ||
|| [balloonclose](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#event-balloonclose) | Закрытие балуна. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). ||
|| [balloonopen](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#event-balloonopen) | Открытие балуна на геообъекте. Экземпляр класса [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). ||
|| [beforedrag](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#event-beforedrag) | Событие, предшествующее событию drag. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• pixelOffset - массив из двух чисел, описывающий пиксельный сдвиг на данном шаге.

Имена методов, доступных через метод Event.callMethod:

• setPixelOffset - метод, позволяющий скорректировать значение пиксельного сдвига, который будет фактически применен. В качестве аргумента принимает новый пиксельный сдвиг в виде массива из двух чисел.

Если у данного события вызвать метод Event.preventDefault, то последующее событие drag будет отменено. ||
|| [beforedragstart](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#event-beforedragstart) | Событие, предшествующее событию dragstart. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/DomEvent.md)), если оно имеется.

Если у данного события вызвать метод Event.preventDefault, то последующее перетаскивание, как и событие dragstart, будет отменено. ||
|| [click](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-click) | Однократное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-click). ||
|| [contextmenu](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-contextmenu) | Вызов контекстного меню на элементе. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-contextmenu). ||
|| [dblclick](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-dblclick) | Двойное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-dblclick). ||
|| [drag](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#event-drag) | Перетаскивание геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• pixelOffset - массив из двух чисел, описывающий пиксельный сдвиг на данном шаге. ||
|| [dragend](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#event-dragend) | Завершение перетаскивания геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). ||
|| [dragstart](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#event-dragstart) | Начало перетаскивания геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/DomEvent.md)), если оно имеется. ||
|| [editorstatechange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#event-editorstatechange) | Изменение состояния редактора геометрии геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

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

• originalEvent - оригинальное событие геометрии.

Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-geometrychange). ||
|| [mapchange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#event-mapchange) | Сменилась карта. Поля данных: 
• oldMap - старая карта;

• newMap - новая карта.

Унаследовано от [IParentOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#event-mapchange). ||
|| [mousedown](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mousedown) | Нажатие кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mousedown). ||
|| [mouseenter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mouseenter) | Наведение курсора на объект. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mouseenter). ||
|| [mouseleave](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mouseleave) | Вывод курсора за пределы объекта. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mouseleave). ||
|| [mousemove](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mousemove) | Перемещение курсора над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mousemove). ||
|| [mouseup](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mouseup) | Отпускание кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mouseup). ||
|| [multitouchend](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-multitouchend) | Окончание мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях.

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-multitouchend). ||
|| [multitouchmove](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-multitouchmove) | Повторящееся событие при мультисенсорном управлении. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях.

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-multitouchmove). ||
|| [multitouchstart](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-multitouchstart) | Начало мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях.

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-multitouchstart). ||
|| [optionschange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#event-optionschange) | Изменение в опциях объекта.

Унаследовано от [ICustomizable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#event-optionschange). ||
|| [overlaychange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-overlaychange) | Изменение оверлея геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• newOverlay - новый оверлей, либо null, если оверлея нет;

• oldOverlay - старый оверлей, либо null, если оверлея нет.

Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-overlaychange). ||
|| [parentchange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChild.md#event-parentchange) | Сменился родительский объект.

Поля данных:

• oldParent - старый родитель;

• newParent - новый родитель.

Унаследовано от [IChild](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChild.md#event-parentchange). ||
|| [pixelgeometrychange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-pixelgeometrychange) | Изменение пиксельной геометрии геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• newPixelGeometry - новая пиксельная геометрия;

• oldPixelGeometry - старая пиксельная геометрия.

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

• originalEvent - оригинальное событие менеджера данных.

Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-propertieschange). ||
|| [wheel](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-wheel) | Скролл мышкой. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-wheel). ||
|#

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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [getMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#getMap)() | [Map](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md) | Returns ссылку на карту.

Унаследован от [IParentOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#getMap). ||
|| [getOverlay](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#getOverlay)() | [IOverlay](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IOverlay.md)\|null | Returns оверлей геообъекта, либо null.

Унаследован от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#getOverlay). ||
|| [getParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#getParent)() | [IParentOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md) | Returns ссылку на родительский объект.

Унаследован от [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#getParent). ||
|| [setParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#setParent)([parent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#setParent-param-parent)) | [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md) | Устанавливает родительский объект.

Унаследован от [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#setParent). ||
|#

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

### balloon

```javascript
{geoObject.Balloon} balloon
```

Балун геообъекта.

**Пример:**

```javascript
// Открывает балун геообъекта и позиционирует его максимально близко к центру карты.
geoObject.balloon.open(myMap.getCenter());
```
### editor

```javascript
{IGeometryEditor} editor
```

Редактор геометрии геообъекта.

**Пример:**

```javascript
// Начало редактирования геометрии геообъекта.
geoObject.editor.startEditing();
// ...
// Завершение редактирования.
geoObject.editor.stopEditing();
```

### events

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

Менеджер событий.

### hint

```javascript
{geoObject.Hint} hint
```

Хинт геообъекта.

**Пример:**

```javascript
// Показывает хинт над геообъектом.
geoObject.hint.show();
```

### options

```javascript
{option.Manager} options
```

Менеджер опций геообъекта.

### properties

```javascript
{data.Manager} properties
```

Менеджер данных геообъекта.

### state

```javascript
{data.Manager} state
```

Состояние геообъекта. Определяется следующими полями: 
• active - признак того, что на геообъекте открыт балун.

• hover - признак того, что в данный момент на геообъект наведен указатель мыши.

• drag - признак того, что геообъект перетаскивается.

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

### balloonclose

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

### balloonopen

Открытие балуна на геообъекте. Экземпляр класса [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).

### beforedrag

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

• pixelOffset - массив из двух чисел, описывающий пиксельный сдвиг на данном шаге.

Имена методов, доступных через метод Event.callMethod:

• setPixelOffset - метод, позволяющий скорректировать значение пиксельного сдвига, который будет фактически применен. В качестве аргумента принимает новый пиксельный сдвиг в виде массива из двух чисел.

Если у данного события вызвать метод Event.preventDefault, то последующее событие drag будет отменено.

**Пример:**

```javascript
// Разрешаем перетаскивание геообъекта только вдоль горизонтальной оси.
geoObject.events.add("beforedrag", function (event) {
    var originalOffset = event.get("pixelOffset");
    event.callMethod("setPixelOffset", [originalOffset[0], 0]);
});
```

### beforedragstart

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

• domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/DomEvent.md)), если оно имеется.

Если у данного события вызвать метод Event.preventDefault, то последующее перетаскивание, как и событие dragstart, будет отменено.

### drag

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

• pixelOffset - массив из двух чисел, описывающий пиксельный сдвиг на данном шаге.

### dragend

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

### dragstart

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

• domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/DomEvent.md)), если оно имеется.

### editorstatechange

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

• originalEvent - оригинальное событие редактора геометрии.