---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/MapEvent.md
  - https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/jsapi-v2-1/doc/ru/llms.txt

# MapEvent

Расширяет [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md).

Объект, описывающий произошедшее над картой событие. Имена полей, доступных через метод [Event.get](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- coords - географические координаты точки, в которой произошло событие;
- globalPixels - координаты события в глобальных пикселях от левого верхнего угла мира;
- pagePixels - координаты события в глобальных пикселях от левого верхнего угла страницы (также доступно под именем position);
- clientPixels - координаты события в пикселях от левого верхнего угла окна браузера;
- domEvent - исходное DOM-событие (в виде объекта [DomEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/DomEvent.md)), если оно имеется.

[Конструктор](#constructor-summary) | [Методы ](#methods-summary)

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

```javascript
MapEvent(originalEvent[, sourceEvent])
```

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

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

Данные, связанные с событием. Должны содержать поле "map" указывающее на карту, над которой произошло событие. ||
|| [`sourceEvent`](#param-sourceEvent) | — | Тип: [IEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md)

Исходное событие. ||
|#

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

**Пример:**

```javascript
// Откроем балун в точке клика по карте.
map.events.add('click', function (e) {
    map.balloon.open(e.get('coords'), 'Щелк!');});
```

## Методы {#methods-summary}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [allowMapEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md#allowMapEvent)() | | Разрешает распространение данного события на карту.

Унаследован от [IEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md#allowMapEvent). ||
|| [callMethod](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#callMethod)([name](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#callMethod-param-name)) | Object | Вызывает указанный метод. Операция эквивалентна поиску поля через get и вызову с передачей в качестве контекста originalEvent. Все аргументы после первого передаются в качестве параметров вызываемому методу.

Унаследован от [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#callMethod). ||
|| [get](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get)([name](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get-param-name)) | Object | Возвращает значение поля из originalEvent. originalEvent всегда имеет следующие поля:
- type - строковый тип события;
- target - ссылка на объект, породивший событие.

Унаследован от [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get). ||
|| [getSourceEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md#getSourceEvent)() | [IEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md)\|null | Возвращает исходное событие.

Унаследован от [IEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md#getSourceEvent). ||
|| [isDefaultPrevented](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#isDefaultPrevented)() | Boolean | Проверяет, отменена ли реакция по умолчанию на событие в рамках системы событий API Яндекс Карт.

Унаследован от [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#isDefaultPrevented). ||
|| [isImmediatePropagationStopped](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#isImmediatePropagationStopped)() | Boolean | Определяет, прекращено ли распространение события в системе событий API Яндекс Карт.

Унаследован от [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#isImmediatePropagationStopped). ||
|| [isMapEventAllowed](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md#isMapEventAllowed)() | Boolean | Возвращает true, если событие карты разрешено.

Унаследован от [IEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md#isMapEventAllowed). ||
|| [isPropagationStopped](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#isPropagationStopped)() | Boolean | Проверяет, остановлено ли распространение события по иерархии объектов и коллекций в системе событий API Яндекс Карт.

Унаследован от [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#isPropagationStopped). ||
|| [preventDefault](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#preventDefault)() | | Отменяет реакцию по умолчанию на событие в рамках системы событий API Яндекс Карт. Вызов этого метода никак не влияет на распространение исходного DOM-события (если оно есть) по DOM-дереву.

Унаследован от [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#preventDefault). ||
|| [stopImmediatePropagation](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#stopImmediatePropagation)() | | Прекращает распространение события в системе событий API Яндекс Карт. Вызов этого метода никак не влияет на распространение исходного DOM-события (если оно есть) по DOM-дереву.

Унаследован от [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#stopImmediatePropagation). ||
|| [stopPropagation](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#stopPropagation)() | | Прекращает распространение события по иерархии объектов и коллекций в системе событий API Яндекс Карт. Вызов этого метода никак не влияет на распространение исходного DOM-события (если оно есть) по DOM-дереву.

Унаследован от [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#stopPropagation). ||
|#

<!-- XLIFF_FARM_N2RlODRk_CACHING -->

[*star]: Обязательный параметр.