--- metadata: - name: generator content: Diplodoc Platform v5.39.1 alternate: - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/GeoObject.md - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/llms.txt # GeoObject Расширяет [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md). Геообъект. В зависимости от типа геометрии может отображаться как метка, линия, полигон и т.д. Вы также можете использовать вспомогательные классы для упрощенного создания геообъектов с определенным типом геометрии. **См.:** [Placemark](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Placemark.md)[Polyline](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Polyline.md)[Polygon](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Polygon.md)[Circle](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Circle.md)[Rectangle](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Rectangle.md) [Конструктор](#constructor-summary) | [Поля ](#properties-summary) | [События ](#events-summary) | [Методы ](#methods-summary) ## Конструктор {#constructor-summary} ```javascript GeoObject([feature[, options]]) ``` **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`feature`](#param-feature) | — | Тип: Object Описание геообъекта. || || [`feature.geometry`](#param-feature.geometry) | — | Тип: [IGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md)\|[IGeometryJson](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometryJson.md) Геометрия геообъекта. Может задаваться непосредственно объектом, либо в виде объекта JSON-представления геометрии. Примеры классов и объектов, которые могут представлять геометрию - [geometry.Point](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geometry.Point.md), [geometry.json.Point](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geometry.json.Point.md). || || [`feature.properties`](#param-feature.properties) | — | Тип: [IDataManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDataManager.md)\|Object Данные геообъекта. Могут задаваться как экземпляр класса, реализующего интерфейс [IDataManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDataManager.md), либо в виде хэша. При значениях опций по умолчанию геообъектом трактуются следующие поля данных: - iconContent - содержимое иконки геообъекта; - iconCaption — подпись иконки геообъекта; - hintContent - содержимое всплывающей подсказки геообъекта; - balloonContent - содержимое балуна геообъекта; - balloonContentHeader - содержимое заголовка балуна геообъекта; - balloonContentBody - содержимое основой части балуна геообъекта; - balloonContentFooter - содержимое нижней части балуна геообъекта. Поле balloonContent является кратким обозначением для поля balloonContentBody, но при одновременном задании balloonContentBody более приоритетен. Также вы можете дополнить данные геообъекта своими собственными полями и использовать их везде, где это возможно. Например в макете метки или макете балуна. || || [`options`](#param-options) | — | Тип: Object Опции геообъекта. Используя этот параметр можно задавать как опции самого геообъекта, так и опции его составных частей: - Опции [балуна геообъекта](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Balloon.md#constructor-summary) с префиксом `balloon`. - Опции [всплывающей подсказки](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Hint.md#constructor-summary) геообъекта с префиксом `hint`. - Опции редактора геометрии геообъекта с префиксом `editor`. Тип редактора и перечень доступных опций зависит от типа геометрии геообъекта. Смотрите описание классов [geometryEditor.LineString](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geometryEditor.LineString.md), [geometryEditor.Polygon](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geometryEditor.Polygon.md), [geometryEditor.Point](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geometryEditor.Point.md). - Опции геометрии могут задаваться без префикса. Смотрите описание классов [IGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md) геометрий [geometry.Point](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geometry.Point.md), [geometry.Polygon](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geometry.Polygon.md) и др. || || [`options.circleOverlay`](#param-options.circleOverlay) | "default#circle" | Тип: String\|Function Ключ-идентификатор из хранилища [overlay.storage](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/overlay.storage.md) или класс оверлея. Функция-генератор принимает три параметра: - geometry: [IPixelCircleGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPixelCircleGeometry.md) - непосредственно пиксельная геометрия; - data: Object - данные оверлея; - options: Object - опции оверлея. Функция возвращает объект [vow.Promise](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md). || || [`options.cursor`](#param-options.cursor) | "pointer" | Тип: String Вид курсора над геообъектом. || || [`options.draggable`](#param-options.draggable) | false | Тип: Boolean Определяет возможность перетаскивания геообъекта. || || [`options.fill`](#param-options.fill) | true | Тип: Boolean Наличие заливки фигуры. || || [`options.fillColor`](#param-options.fillColor) | "0066ff99" | Тип: String Цвет заливки. || || [`options.fillImageHref`](#param-options.fillImageHref) | — | Тип: String Фоновое изображение. При включении данной опции в режиме заливки **stretch** значение опции fillColor игнорируется. || || [`options.fillMethod`](#param-options.fillMethod) | 'stretch' | Тип: String Тип заливки фоном. Может принимать одно из двух значений: - stretch - фоновое изображение растягивается по размеру оверлея. - tile - Фоновое изображение повторяется без изменений размера. Аналог background-repeat в css. Можно использовать для заливки фигуры неким шаблоном. || || [`options.fillOpacity`](#param-options.fillOpacity) | 1 | Тип: Number Прозрачность заливки. || || [`options.hasBalloon`](#param-options.hasBalloon) | true | Тип: Boolean Определяет наличие поля balloon у геообъекта. || || [`options.hasHint`](#param-options.hasHint) | true | Тип: Boolean Определяет наличие поля hint у геообъекта. || || [`options.hideIconOnBalloonOpen`](#param-options.hideIconOnBalloonOpen) | true | Тип: Boolean Скрывать иконку при открытии балуна. || || [`options.iconCaptionMaxWidth`](#param-options.iconCaptionMaxWidth) | 188 | Тип: Number Максимальная ширина подписи метки. || || [`options.iconColor`](#param-options.iconColor) | — | Тип: String Цвет иконки. Эта опция применяется для стандартных иконок в браузерах, поддерживающих SVG. || || [`options.iconContentLayout`](#param-options.iconContentLayout) | — | Тип: Function\|String Макет содержимого иконки. (Тип: конструктор объекта с интерфейсом ILayout или его ключ в хранилище). || || [`options.iconContentOffset`](#param-options.iconContentOffset) | — | Тип: Number[] Пиксельный сдвиг содержимого иконки относительно родительского элемента. Используется в макете default#imageWithContent. || || [`options.iconContentPadding`](#param-options.iconContentPadding) | — | Тип: Number[] Отступ для содержимого в иконке. || || [`options.iconContentSize`](#param-options.iconContentSize) | — | Тип: Number[] Размер содержимого. Используется в макете default#imageWithContent. || || [`options.iconImageClipRect`](#param-options.iconImageClipRect) | [[0, 0], [{imageWidth}, {imageHeight}]] | Тип: Number[][] Прямоугольная область (указывается левый верхний и правый нижний углы), которая будет вырезана из исходного графического файла и смасштабирована под размеры иконки (например для использования спрайтов). По умолчанию исходная картинка подставляется полностью. || || [`options.iconImageHref`](#param-options.iconImageHref) | — | Тип: String URL графического файла иконки. Применяется только в комбинации с макетами (iconLayout) 'default#image' и 'default#imageWithContent'. || || [`options.iconImageOffset`](#param-options.iconImageOffset) | — | Тип: Number[] Пиксельный сдвиг изображения иконки внутри родительского элемента. || || [`options.iconImageShape`](#param-options.iconImageShape) | — | Тип: [IShape](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IShape.md)\|null Фигура активной области. Если не задана, то автоматически будет рассчитана прямоугольная фигура на основе размера и смещения картинки. Координаты геометрии фигуры отсчитываются от точки привязки. Применяется только в комбинации с макетами (iconLayout) 'default#image' и 'default#imageWithContent'. || || [`options.iconImageSize`](#param-options.iconImageSize) | — | Тип: Number[] Размер иконки в пикселях. || || [`options.iconLayout`](#param-options.iconLayout) | — | Тип: Function\|String Макет иконки. (Тип: конструктор объекта с интерфейсом ILayout или его ключ в хранилище). || || [`options.iconMaxHeight`](#param-options.iconMaxHeight) | — | Тип: Number Максимальная высота иконки с содержимым. || || [`options.iconMaxWidth`](#param-options.iconMaxWidth) | — | Тип: Number Максимальная ширина иконки с содержимым. || || [`options.iconOffset`](#param-options.iconOffset) | [0, 0] | Тип: Number[] Пиксельное смещение левого верхнего угла иконки относительно географической точки привязки метки. || || [`options.iconShadow`](#param-options.iconShadow) | false | Тип: Boolean Флаг наличия тени у иконки. || || [`options.iconShadowImageClipRect`](#param-options.iconShadowImageClipRect) | [[0, 0], [{imageWidth}, {imageHeight}]] | Тип: Number[][] Прямоугольная область (указывается левый верхний и правый нижний углы), которая будет вырезана из исходного графического файла и смасштабирована под размеры тени (например для использования спрайтов). По умолчанию исходная картинка подставляется полностью. || || [`options.iconShadowImageHref`](#param-options.iconShadowImageHref) | — | Тип: String URL графического файла тени иконки. Применяется только в комбинации с макетами (iconShadowLayout) 'default#image' и 'default#imageWithContent'. || || [`options.iconShadowImageOffset`](#param-options.iconShadowImageOffset) | — | Тип: Number[] Пиксельный сдвиг изображения тени иконки внутри родительского элемента. || || [`options.iconShadowImageSize`](#param-options.iconShadowImageSize) | — | Тип: Number[] Размер тени иконки. || || [`options.iconShadowLayout`](#param-options.iconShadowLayout) | — | Тип: Function\|String Макет тени иконки. (Тип: конструктор объекта с интерфейсом ILayout или его ключ в хранилище). || || [`options.iconShadowOffset`](#param-options.iconShadowOffset) | — | Тип: Number[] Пиксельное смещение тени иконки относительно заданной позиции. || || [`options.interactiveZIndex`](#param-options.interactiveZIndex) | — | Тип: Boolean Включает режим автоматического изменения z-index геообъекта в зависимости от его состояния. По умолчанию принимает значение true для геометрии [geometry.Point](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geometry.Point.md) и false для других геометрий. || || [`options.interactivityModel`](#param-options.interactivityModel) | "default#geoObject" | Тип: String Модель интерактивности. Доступные ключи и их значения перечислены в описании [interactivityModel.storage](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/interactivityModel.storage.md). || || [`options.lineStringOverlay`](#param-options.lineStringOverlay) | "default#polyline" | Тип: String\|Function Ключ-идентификатор из хранилища [overlay.storage](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/overlay.storage.md) или класс оверлея. Функция-генератор принимает три параметра: - geometry:[IPixelLineStringGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPixelLineStringGeometry.md) - непосредственно пиксельная геометрия; - data: [IDataManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDataManager.md) или Object - данные оверлея; - options: Object - опции оверлея. Функция возвращает объект [vow.Promise](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md). || || [`options.opacity`](#param-options.opacity) | 1 | Тип: Number Прозрачность. || || [`options.openBalloonOnClick`](#param-options.openBalloonOnClick) | true | Тип: Boolean Определяет показывать ли балун при щелчке на геообъекте. || || [`options.openEmptyBalloon`](#param-options.openEmptyBalloon) | false | Тип: Boolean Определяет показывать ли пустой балун при щелчке на геообъекте. || || [`options.openEmptyHint`](#param-options.openEmptyHint) | false | Тип: Boolean Определяет показывать ли пустой хинт при наведении указателя мыши на геообъект. || || [`options.openHintOnHover`](#param-options.openHintOnHover) | true | Тип: Boolean Определяет показывать ли хинт при наведении указателя мыши на геообъект. || || [`options.outline`](#param-options.outline) | true | Тип: Boolean Наличие обводки фигуры. || || [`options.pane`](#param-options.pane) | — | Тип: String Ключ пейна, в который помещается оверлей геообъекта. Значение по умолчанию определяется текущим оверлеем. || || [`options.pointOverlay`](#param-options.pointOverlay) | "default#placemark" | Тип: String\|Function Ключ-идентификатор из хранилища [overlay.storage](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/overlay.storage.md) или класс оверлея. Функция-генератор принимает три параметра: - geometry: [IPixelPointGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPixelPointGeometry.md) — непосредственно пиксельная геометрия; - data: [IDataManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDataManager.md) или Object - данные оверлея; - options: Object - опции оверлея. Функция возвращает объект [vow.Promise](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md). || || [`options.polygonOverlay`](#param-options.polygonOverlay) | "default#polygon" | Тип: String\|Function Ключ-идентификатор из хранилища [overlay.storage](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/overlay.storage.md) или класс оверлея. Функция-генератор принимает три параметра: - geometry: [IPixelPolygonGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPixelPolygonGeometry.md) - непосредственно пиксельная геометрия; - data: [IDataManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDataManager.md) или Object - данные оверлея; - options: Object - опции оверлея. Функция возвращает объект [vow.Promise](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md). || || [`options.preset`](#param-options.preset) | — | Тип: String Ключ предустановленных опций геообъекта. Список ключей содержится в описании [option.presetStorage](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/option.presetStorage.md). || || [`options.rectangleOverlay`](#param-options.rectangleOverlay) | "default#rectangle" | Тип: String\|Function Ключ-идентификатор из хранилища [overlay.storage](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/overlay.storage.md) или класс оверлея. Функция-генератор принимает три параметра: - geometry: [IPixelCircleGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPixelCircleGeometry.md) - непосредственно пиксельная геометрия; - data: [IDataManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDataManager.md) или Object - данные оверлея; - options: Object - опции оверлея. Функция возвращает объект [vow.Promise](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md). || || [`options.setMapCursorInDragging`](#param-options.setMapCursorInDragging) | false | Тип: Boolean true — при перетаскивании объекта выставлять курсор «сжатая рука» и на объект, и на карту, false — только на сам объект. || || [`options.strokeColor`](#param-options.strokeColor) | "0066ffff" | Тип: String\|String[] Цвет линии или обводки. Можно задать несколько значений для множественной обводки. || || [`options.strokeOpacity`](#param-options.strokeOpacity) | 1 | Тип: Number\|Number[] Прозрачность линии или обводки. Можно задать несколько значений для множественной обводки. || || [`options.strokeStyle`](#param-options.strokeStyle) | — | Тип: String\|Object\|String\[]\|Object[] Стиль линии или обводки. Можно задать несколько значений для множественной обводки. Доступные стили перечислены в объекте [graphics.style.stroke](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/graphics.style.stroke.md). || || [`options.strokeWidth`](#param-options.strokeWidth) | 1 | Тип: Number\|Number[] Толщина линии или обводки. Можно задать несколько значений для множественной обводки. || || [`options.syncOverlayInit`](#param-options.syncOverlayInit) | false | Тип: Boolean Включает синхронное добавление оверлея на карту. По умолчанию добавление оверлея осуществляется асинхронно, что позволяет предотвратить зависания браузера при добавлении на карту большого числа геообъектов. Однако, асинхронное добавление не позволяет получать доступ к оверлею сразу после добавления геообъекта на карту. || || [`options.useMapMarginInDragging`](#param-options.useMapMarginInDragging) | true | Тип: Boolean При перетаскивании объекта к краю карты происходит автоматическое изменение центра карты. Нужно ли учитывать отступы карты при автоматическом смещении центра карты [map.margin.Manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md). || || [`options.visible`](#param-options.visible) | true | Тип: Boolean Определяет видимость геообъекта. || || [`options.zIndex`](#param-options.zIndex) | — | Тип: Number z-index геообъекта в обычном состоянии. Наименее приоритетный. || || [`options.zIndexActive`](#param-options.zIndexActive) | — | Тип: Number z-index геообъекта с открытым балуном. Наиболее приоритетный. || || [`options.zIndexDrag`](#param-options.zIndexDrag) | — | Тип: Number z-index геообъекта при перетаскивании. || || [`options.zIndexHover`](#param-options.zIndexHover) | — | Тип: Number z-index геообъекта при наведении на него указателя мыши. || |# **Примеры:** **1.** ```javascript var myGeoObject = new ymaps.GeoObject({ // Определение типа геометрии" Полилиния". geometry: { type: "LineString", coordinates: [ [55.75, 37.61], [52.51, 13.38] ] }, // Определение данных геообъекта. properties: { hintContent: "Москва-Берлин" } }, { // Включение режима отображения в виде геодезических кривых. geodesic: true, // Установка ширины до 5 пикселей. strokeWidth: 5, // Установка цвета линии. strokeColor: "#F008" }); // Добавление геообъекта на карту. geoMap.geoObjects.add(myGeoObject); ``` **2.** ```javascript var myGeoObject = new ymaps.GeoObject({ // Определение геометрии" Point". geometry: { type: "Point", coordinates: [55.75, 37.61] }, // Определение данных геообъекта. properties: { hintContent: "Москва", balloonContentHeader: "Москва", balloonContentBody: "Столица России", population: 11848762 } }, { // Установка предустановки для метки с точкой и без содержимого. preset: "islands#redDotIcon", // Включение перетаскивания. draggable: true, // Переопределение макета для содержимого в нижней части воздушного шара. balloonContentFooterLayout: ymaps.templateLayoutFactory.createClass( 'population: {{ properties.population }}, coordinates: {{ geometry.coordinates }}' ), // Отключение задержки для закрытия всплывающей подсказки. hintCloseTimeout: null }); // Добавление геообъекта на карту. geoMap.geoObjects.add(myGeoObject); ``` ## Поля {#properties-summary} #| || **Имя** | **Тип** | **Описание** || || [balloon](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#balloon) | [geoObject.Balloon](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geoObject.Balloon.md) | Балун геообъекта. || || [editor](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#editor) | [IGeometryEditor](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometryEditor.md) | Редактор геометрии геообъекта. || || [events](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#events) | [event.Manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/event.Manager.md) | Менеджер событий. || || [geometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#geometry) | [IGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md)\|null | Геометрия геообъекта. || || [hint](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#hint) | [geoObject.Hint](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geoObject.Hint.md) | Хинт геообъекта. || || [options](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#options) | [option.Manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/option.Manager.md) | Менеджер опций геообъекта. || || [properties](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#properties) | [data.Manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/data.Manager.md) | Менеджер данных геообъекта. || || [state](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#state) | [data.Manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/data.Manager.md) | Состояние геообъекта. Определяется следующими полями: - active: Boolean - признак того, что на геообъекте открыт балун. - hover: Boolean - признак того, что в данный момент на геообъект наведен указатель мыши; - drag: Boolean - признак того, что в данный момент геообъект перетаскивается. || |# ## События {#events-summary} #| || **Имя** | **Описание** || || [balloonclose](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#event-balloonclose) | Закрытие балуна. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). || || [balloonopen](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#event-balloonopen) | Открытие балуна на геообъекте. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). || || [beforedrag](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#event-beforedrag) | Событие, предшествующее событию drag. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - position - координаты относительно документа. Массива вида [pageX, pageY]; - pixelOffset - массив из двух чисел, описывающий пиксельный сдвиг на данном шаге; - domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/DomEvent.md)), если оно имеется. Имена методов, доступных через метод [Event.callMethod](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#callMethod): - setPixelOffset - метод, позволяющий скорректировать значение пиксельного сдвига, который будет фактически применен. В качестве аргумента принимает новый пиксельный сдвиг в виде массива из двух чисел. Если у данного события вызвать метод [Event.preventDefault](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#preventDefault), то последующее событие "drag" будет отменено. || || [beforedragstart](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#event-beforedragstart) | Событие, предшествующее событию dragstart. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - position - координаты относительно документа. Массива вида [pageX, pageY]; - domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/DomEvent.md)), если оно имеется. Если у данного события вызвать метод [Event.preventDefault](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#preventDefault), то последующее перетаскивание, как и событие "dragstart", будет отменено. || || [click](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-click) | Однократное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-click). || || [contextmenu](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-contextmenu) | Вызов контекстного меню на элементе. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-contextmenu). || || [dblclick](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-dblclick) | Двойное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-dblclick). || || [drag](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#event-drag) | Перетаскивание геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - position - координаты относительно документа. Массива вида [pageX, pageY]; - pixelOffset - массив из двух чисел, описывающий пиксельный сдвиг на данном шаге; - domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/DomEvent.md)), если оно имеется. || || [dragend](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#event-dragend) | Завершение перетаскивания геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - position - координаты относительно документа. Массива вида [pageX, pageY]; - domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/DomEvent.md)), если оно имеется. || || [dragstart](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#event-dragstart) | Начало перетаскивания геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - position - координаты относительно документа. Массива вида [pageX, pageY]; - domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/DomEvent.md)), если оно имеется. || || [editorstatechange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#event-editorstatechange) | Изменение состояния редактора геометрии геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - originalEvent - оригинальное событие редактора геометрии. || || [geometrychange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-geometrychange) | Изменение геометрии геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - originalEvent: [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md) - оригинальное событие геометрии. Унаследовано от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-geometrychange). || || [hintclose](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#event-hintclose) | Закрытие хинта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). || || [hintopen](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#event-hintopen) | Открытие хинта на геообъекте. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). || || [mapchange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#event-mapchange) | Сменилась карта. Поля данных: - oldMap - старая карта; - newMap - новая карта. Унаследовано от [IParentOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#event-mapchange). || || [mousedown](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousedown) | Нажатие кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousedown). || || [mouseenter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseenter) | Наведение курсора на объект. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseenter). || || [mouseleave](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseleave) | Вывод курсора за пределы объекта. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseleave). || || [mousemove](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousemove) | Перемещение курсора над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousemove). || || [mouseup](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseup) | Отпускание кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseup). || || [multitouchend](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchend) | Окончание мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent. Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchend). || || [multitouchmove](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchmove) | Повторящееся событие при мультисенсорном управлении. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Определяет свойство touches, которое содержит список прикосновений. Каждое прикосновение описано объектом, которое содержит поля: - clientX - координата касания X относительно видимой области браузера; - clientY - координата касания Y относительно видимой области браузера; - pageX - координата касания X касания относительно начала документа; - pageY - координата касания Y касания относительно начала документа. Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchmove). || || [multitouchstart](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchstart) | Начало мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Определяет свойство touches, которое содержит список прикосновений. Каждое прикосновение описано объектом, которое содержит поля: - clientX - координата касания X относительно видимой области браузера; - clientY - координата касания Y относительно видимой области браузера; - pageX - координата касания X касания относительно начала документа; - pageY - координата касания Y касания относительно начала документа. Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchstart). || || [optionschange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange) | Изменение в опциях объекта. Унаследовано от [ICustomizable](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange). || || [overlaychange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-overlaychange) | Изменение оверлея геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - overlay: [IOverlay](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOverlay.md)\|null - ссылка на оверлей; - oldOverlay: [IOverlay](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOverlay.md)\|null - предыдущий оверлей геообъекта. Унаследовано от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-overlaychange). || || [parentchange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChild.md#event-parentchange) | Сменился родительский объект. Поля данных: - oldParent - старый родитель; - newParent - новый родитель. Унаследовано от [IChild](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChild.md#event-parentchange). || || [propertieschange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-propertieschange) | Изменение данных геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - originalEvent: [IEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md) - оригинальное событие менеджера данных. Унаследовано от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-propertieschange). || || [wheel](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-wheel) | Скролл мышкой. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-wheel). || |# ## Методы {#methods-summary} #| || **Имя** | **Возвращает** | **Описание** || || [getMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#getMap)() | [Map](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md) | Возвращает ссылку на карту. Унаследован от [IParentOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#getMap). || || [getOverlay](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#getOverlay)() | [vow.Promise](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Возвращает объект-обещание, который подтверждается объектом оверлея в момент его фактического создания, либо отклоняется с передачей соответствующей ошибки. Унаследован от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#getOverlay). || || [getOverlaySync](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#getOverlaySync)() | [IOverlay](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOverlay.md)\|null | Метод предоставляет синхронный доступ к оверлею. Унаследован от [IGeoObject](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#getOverlaySync). || || [getParent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#getParent)() | [IParentOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md)\|null | Возвращает ссылку на родительский объект или null, если родительский элемент не был установлен. Унаследован от [IChildOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#getParent). || || [setParent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#setParent)([parent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#setParent-param-parent)) | [IChildOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md) | Устанавливает родительский объект. Если передать значение null, то элемент управления будет только удален из текущего родительского объекта. Унаследован от [IChildOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#setParent). || |# ## Описание полей {#field_detail} ### balloon {#balloon } ```javascript {geoObject.Balloon} balloon ``` Балун геообъекта. ### editor {#editor} ```javascript {IGeometryEditor} editor ``` Редактор геометрии геообъекта. **Пример:** ```javascript // Начало редактирования геометрии геообъекта. geoObject.editor.startEditing(); // ... // Завершение редактирования. geoObject.editor.stopEditing(); ``` ### events {#events} ```javascript {event.Manager} events ``` Менеджер событий. ### geometry {#geometry} ```javascript {IGeometry|null} geometry ``` Геометрия геообъекта. **Пример:** ```javascript // При изменении координат геометрии геообъекта устанавливаем карте границы так, // чтобы охватить геообъект целиком. myMap.geoObjects.add(myGeoObject); myGeoObject.geometry.events.add("change", function () { myMap.setBounds(myGeoObject.geometry.getBounds()); }); ``` ### hint {#hint} ```javascript {geoObject.Hint} hint ``` Хинт геообъекта. ### options {#options} ```javascript {option.Manager} options ``` Менеджер опций геообъекта. ### properties {#properties} ```javascript {data.Manager} properties ``` Менеджер данных геообъекта. **Пример:** ```javascript // При изменении данных выводим пользовательский идентификатор // (если у объекта поле "synchronized" принимает значение false). myGeoObject.properties.events.add("change", function () { if (!myGeoObject.properties.get("synchronized")) { console.log(myGeoObject.properties.get("myID")); } }); ``` ### state {#state} ```javascript {data.Manager} state ``` Состояние геообъекта. Определяется следующими полями: - active: Boolean - признак того, что на геообъекте открыт балун. - hover: Boolean - признак того, что в данный момент на геообъект наведен указатель мыши; - drag: Boolean - признак того, что в данный момент геообъект перетаскивается. ## Описание событий {#event_detail} ### balloonclose {#balloonclose } Закрытие балуна. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ### balloonopen {#balloonopen} Открытие балуна на геообъекте. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ### beforedrag {#beforedrag} Событие, предшествующее событию drag. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - position - координаты относительно документа. Массива вида [pageX, pageY]; - pixelOffset - массив из двух чисел, описывающий пиксельный сдвиг на данном шаге; - domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/DomEvent.md)), если оно имеется. Имена методов, доступных через метод [Event.callMethod](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#callMethod): - setPixelOffset - метод, позволяющий скорректировать значение пиксельного сдвига, который будет фактически применен. В качестве аргумента принимает новый пиксельный сдвиг в виде массива из двух чисел. Если у данного события вызвать метод [Event.preventDefault](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#preventDefault), то последующее событие "drag" будет отменено. **Пример:** ```javascript // Разрешаем перетаскивание геообъекта только вдоль горизонтальной оси. geoObject.events.add("beforedrag", function (event) { var originalOffset = event.get("pixelOffset"); event.callMethod("setPixelOffset", [originalOffset[0], 0]); }); ``` ### beforedragstart {#beforedragstart} Событие, предшествующее событию dragstart. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - position - координаты относительно документа. Массива вида [pageX, pageY]; - domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/DomEvent.md)), если оно имеется. Если у данного события вызвать метод [Event.preventDefault](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#preventDefault), то последующее перетаскивание, как и событие "dragstart", будет отменено. ### drag {#drag} Перетаскивание геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - position - координаты относительно документа. Массива вида [pageX, pageY]; - pixelOffset - массив из двух чисел, описывающий пиксельный сдвиг на данном шаге; - domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/DomEvent.md)), если оно имеется. ### dragend {#dragend} Завершение перетаскивания геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - position - координаты относительно документа. Массива вида [pageX, pageY]; - domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/DomEvent.md)), если оно имеется. ### dragstart {#dragstart} Начало перетаскивания геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - position - координаты относительно документа. Массива вида [pageX, pageY]; - domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/DomEvent.md)), если оно имеется. ### editorstatechange {#editorstatechange} Изменение состояния редактора геометрии геообъекта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - originalEvent - оригинальное событие редактора геометрии. ### hintclose {#hintclose} Закрытие хинта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ### hintopen {#hintopen} Открытие хинта на геообъекте. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md).