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

# Map

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

Класс для создания и управления картой.

[Конструктор](#constructor-summary) | [Поля ](#properties-summary) | [События ](#events-summary) | [Методы ](#methods-summary)

## Конструктор

```javascript
Map(parentElement, state[, options])
```

Создает экземпляр карты.

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

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

Ссылка на HTML-элемент, в котором размещается карта, или идентификатор этого HTML-элемента. ||
|| [`state`](#param-state)[*](*star) | — | Тип: Object

Параметры карты. ||
|| [`state.behaviors`](#param-state.behaviors) | ['default'] | Тип: String[]

Включенные поведения карты. По умолчанию включаются: перетаскивание карты, масштабирование карты мультисенсорным касанием и двойным кликом на устройствах с сенсорным экраном; перетаскивание карты мышью, масштабирование двойным щелчком и выделением области правой кнопкой мыши на остальных устройствах. Можно указывать любые ключи, поддерживаемые behavior.Manager. ||
|| [`state.bounds`](#param-state.bounds) | — | Тип: Number[][]

Геокоординаты начальной области показа карты. При инициализации карты может быть задана либо пара state.zoom-state.center, либо данная область. Если совместно со state.bounds будут заданы параметры state.zoom, state.center, они будут проигнорированы. ||
|| [`state.center`](#param-state.center) | — | Тип: Number[]

Геокоординаты центра карты. Должны быть заданы совместно со state.zoom. ||
|| [`state.controls`](#param-state.controls) | ['default'] | Тип: String[]

Добавленные по умолчанию элементы управления карты. Можно указывать любые ключи, поддерживаемые [control.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/control.Manager.md). Список доступных ключей и наборы элементов управления по умолчанию описаны в control.Manager.add. ||
|| [`state.margin`](#param-state.margin) | — | Тип: Number\|Number[]

Отступы от краёв карты. Передаются в map.margin.Manager.setDefaultMargin. ||
|| [`state.type`](#param-state.type) | 'yandex#map' | Тип: String\|[MapType](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapType.md)

Тип карты. Может быть ключом или или экземпляром класса [MapType](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapType.md). Список доступных ключей:
- 'yandex#map' - тип карты "схема";
- 'yandex#satellite' - тип карты "спутник";
- 'yandex#hybrid' - тип карты "гибрид". ||
|| [`state.zoom`](#param-state.zoom) | — | Тип: Number

Коэффициент масштабирования карты. Должен быть задан совместно с опцией state.center. ||
|| [`options`](#param-options) | — | Тип: Object

Опции карты. Через опции карты можно задавать настройки как самой карты, так и добавленных на неё объектов:
- опции [поведений карты](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.behavior.Manager.md#constructor-summary);
- опции [балуна карты](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Balloon.md#constructor-summary) с префиксом `balloon`;
- опции [хинта карты](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Hint.md#constructor-summary) с префиксом `hint`;
- опции [геообъектов](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md#constructor-summary) с префиксом `geoObject`;
- опции [слоев](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Layer.md) с префиксом `layer`;
- опции [слоев активных областей](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/hotspot.Layer.md) с префиксом `hotspotLayer`;
Опции, которые трактует непосредственно сама карта, перечислены ниже. ||
|| [`options.autoFitToViewport`](#param-options.autoFitToViewport) | 'ifNull' | Тип: String

Автоматическое слежение за контейнером карты. По умолчанию карта перестроится автоматически в случае, когда она инициализируется из скрытого контейнера, либо мы программно поменяли его размеры, иначе необходимо вызвать map.container.fitToViewport. Доступны следующие значения:
- 'none' — не следить за изменением отображения контейнера при инициализации из скрытого контейнера или при программном изменении его размеров;
- 'ifNull' — как только контейнер получит CSS значение «display», отличное от «none», автоматически запустится map.container.fitToViewport, чтобы подстроить карту под него. После слежение будет остановлено;
- 'always' — постоянно следить за изменением состояния отображения контейнера карты. ||
|| [`options.avoidFractionalZoom`](#param-options.avoidFractionalZoom) | true | Тип: Boolean

true - карта не будет останавливаться на дробных значениях коэффициента масштабирования, false - будет.

{% note info %}

Для десктопных браузеров данная опция по умолчанию принимает значение true, для мобильных - false.

{% endnote %} ||
|| [`options.exitFullscreenByEsc`](#param-options.exitFullscreenByEsc) | true | Тип: Boolean

Включение возможности выхода из «полноэкранного режима» с помощью нажатия на клавишу ESC. True — выходить из «полноэкранного режима» по нажатию на ESC, false — не выходить. ||
|| [`options.fullscreenZIndex`](#param-options.fullscreenZIndex) | 10000 | Тип: Number

Значение z-index контейнера карты в «полноэкранном режиме». ||
|| [`options.mapAutoFocus`](#param-options.mapAutoFocus) | true | Тип: Boolean

true - при клике на карту будет убираться фокус с текущего активного dom-элемента, false - при клике на карту фокус будет оставаться в активном элементе. ||
|| [`options.maxAnimationZoomDifference`](#param-options.maxAnimationZoomDifference) | 5 | Тип: Number

Максимальная разница между текущим и выставляемым коэффициентом масштабирования карты, при котором масштабирование будет происходить плавно. ||
|| [`options.maxZoom`](#param-options.maxZoom) | 23 | Тип: Number

Максимальный коэффициент масштабирования карты. ||
|| [`options.minZoom`](#param-options.minZoom) | 0 | Тип: Number

Минимальный коэффициент масштабирования карты. ||
|| [`options.nativeFullscreen`](#param-options.nativeFullscreen) | false | Тип: Boolean

Использовать нативный «полноэкранный режим», если возможно. При переходе в нативный «полноэкранный режим» браузер сначала запросит у пользователя подтверждение. В случае согласия пользователя браузер открывает карту на весь экран и скрывает свои управляющие элементы. Пользователь может выйти из этого режима нажав ESC. Опции fullscreenZIndex и exitFullscreenByEsc в нативном «полноэкранном режиме» ни на что не влиют. ||
|| [`options.projection`](#param-options.projection) | ymaps.projection.wgs84Mercator | Тип: [IProjection](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция карты. ||
|| [`options.restrictMapArea`](#param-options.restrictMapArea) | false | Тип: Boolean\|Number[][]

Устанавливает область просмотра карты так, чтобы пользователь не мог выйти за пределы этой области. True — установить область в соответствии с текущей областью отображения, false — отключить опцию. Если необходимо ограничить область с известными координатами, нужно указать эту прямоугольную область. ||
|| [`options.suppressMapOpenBlock`](#param-options.suppressMapOpenBlock) | false | Тип: Boolean

Нужно ли скрывать предложение открыть текущую карту в Яндекс Картах, максимально сохранив всю имеющуюся информацию о ней. True - скрывать, false - не скрывать. Ссылка на Яндекс Карты отображается в левом нижнем углу карты. ||
|| [`options.suppressObsoleteBrowserNotifier`](#param-options.suppressObsoleteBrowserNotifier) | false | Тип: Boolean

Нужно ли в устаревших версиях браузеров скрывать уведомление с предложением обновить браузер. True - скрывать, false - не скрывать. Уведомление отображается в левом нижнем углу карты. ||
|| [`options.yandexMapAutoSwitch`](#param-options.yandexMapAutoSwitch) | true | Тип: Boolean

true — включить автоматическое переключение на Народную Карту там, где схема недостаточно подробна, false — выключить. Эта опция работает только при значениях параметра lang=ru_RU и lang=uk_UA. ||
|| [`options.yandexMapDisablePoiInteractivity`](#param-options.yandexMapDisablePoiInteractivity) | false | Тип: boolean

True — отключить интерактивность POI (точек интереса) в подложке карты, false — включить. ||
|| [`options.yandexMapType`](#param-options.yandexMapType) | map | Тип: String

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

* `map` - базовая карта (по умолчанию)
* `future_map` - базовая карта с обновленным дизайном
* `driving` - карта для автомобильной навигации
* `transit` - карта общественного транспорта
* `admin` - административная карта ||
|#

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

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

**1.**

```javascript
// Инициализация карты с заданными центром и уровнем масштабирования.
var myMap = new ymaps.Map('map', {
        center: [55.74954, 37.621587],
         zoom: 10
    });
```

**2.**

```javascript
// Инициализация карты по известной области просмотра.
// Полагаем, что на странице подключен jQuery.
var $mapElement = $('#map'),
    myMap = new ymaps.Map(
        $mapElement[0],
        ymaps.util.bounds.getCenterAndZoom(
            [[55.7, 37.6], [55.8, 37.7]],
            [$mapElement.width(), $mapElement.height()]
        )
    );
```

**3.**

```javascript
// Инициализация карты из результата геокодирования
var myMap;
ymaps.geocode('Москва').then(function (res) {
    myMap = new ymaps.Map('map', {
        center: res.geoObjects.get(0).geometry.getCoordinates(),
        zoom :
     });
});
```

## Поля {#properties-summary}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [action](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#action) | [map.action.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.action.Manager.md) | Менеджер действий карты. ||
|| [balloon](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#balloon) | [map.Balloon](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Balloon.md) | Балун карты. ||
|| [behaviors](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#behaviors) | [map.behavior.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.behavior.Manager.md) | Менеджер поведений карты. Позволяет включать и выключать поведения, а также предоставляет доступ к их методам и свойствам. ||
|| [container](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#container) | [map.Container](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md) | Контейнер карты. ||
|| [controls](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#controls) | [control.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/control.Manager.md) | Элементы управления картой. ||
|| [converter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#converter) | [map.Converter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Converter.md) | Преобразователь пиксельных точек карты из глобальных в локальные и наоборот. ||
|| [copyrights](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#copyrights) | [map.Copyrights](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md) | Менеджер размещённой на карте информации об авторских правах. ||
|| [cursors](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#cursors) | [util.cursor.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.cursor.Manager.md) | Менеджер курсоров карты. ||
|| [events](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#events) | [event.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/event.Manager.md) | Менеджер событий карты. Поддерживает подписку с приоритетами. Бросает события типа [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). ||
|| [geoObjects](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#geoObjects) | [map.GeoObjects](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md) | Менеджер геообъектов карты. ||
|| [hint](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#hint) | [map.Hint](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Hint.md) | Хинт карты. ||
|| [layers](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#layers) | [map.layer.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.layer.Manager.md) | Менеджер слоев карты. ||
|| [margin](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#margin) | [map.margin.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md) | Менеджер отступов карты. ||
|| [options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#options) | [option.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/option.Manager.md) | Опции карты. ||
|| [panes](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#panes) | [map.pane.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.pane.Manager.md) | Менеджер контейнеров объектов карты. ||
|| [zoomRange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#zoomRange) | [map.ZoomRange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.ZoomRange.md) | Объект, предоставляющий доступ к информации о доступных в точке уровнях масштабирования. ||
|#

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

#|
|| **Имя** | **Описание** ||
|| [actionbegin](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-actionbegin) | Началось новое плавное движение карты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- action - запущенное действие. ||
|| [actionbreak](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-actionbreak) | Событие, возникающее при досрочном прекращении шага действия (например, из-за выполнения другого действия или нового шага того же действия). Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- action - действие. ||
|| [actionend](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-actionend) | Окончание плавного движения карты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- action - остановленное действие. ||
|| [actiontick](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-actiontick) | Начало исполнения нового шага плавного движения (например, сдвиг карты пользователем или шаг анимации плавного масштабирования). Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- action - выполняемое в данный момент действие;
- tick – описание шага действия в виде объекта с полями globalPixelCenter, zoom, duration и timingFunction. ||
|| [actiontickcomplete](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-actiontickcomplete) | Окончание исполнения шага плавного движения. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- action - выполняемое в данный момент действие;
- tick – описание шага действия в виде объекта с полями globalPixelCenter, zoom, duration и timingFunction. ||
|| [balloonclose](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-balloonclose) | Закрытие балуна. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ||
|| [balloonopen](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-balloonopen) | Открытие балуна на карте. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ||
|| [boundschange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-boundschange) | Событие изменения области просмотра карты (в результате изменения центра или уровня масштабирования). Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- oldCenter - предыдущий центр карты в геокоординатах;
- newCenter - новый центр карты в геокоординатах;
- oldZoom - предыдущий уровень машсштабирования;
- newZoom - новый уровень масштабирования;
- oldGlobalPixelCenter - предыдущий центр карты в глобальных пикселах;
- newGlobalPixelCenter - новый центр карты в глобальных пикселах;
- oldBounds - предыдущая область показа;
- newBounds - новая область показа. ||
|| [click](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-click) | Однократное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md).

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

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

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-dblclick). ||
|| [destroy](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-destroy) | Карта уничтожена. ||
|| [hintclose](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-hintclose) | Закрытие хинта. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ||
|| [hintopen](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-hintopen) | Открытие хинта на карте. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ||
|| [marginchange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-marginchange) | Изменились отступы карты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ||
|| [mousedown](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousedown) | Нажатие кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md).

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

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

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

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

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

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchend). ||
|| [multitouchmove](https://yandex.ru/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.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchmove). ||
|| [multitouchstart](https://yandex.ru/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.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchstart). ||
|| [optionschange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-optionschange) | Изменились опции карты. ||
|| [sizechange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-sizechange) | Изменился размер карты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- oldSize - предыдущий размер карты;
- newSize - новый размер карты. ||
|| [typechange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#event-typechange) | Изменился тип карты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ||
|| [wheel](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-wheel) | Скролл мышкой. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md).

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


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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [destroy](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#destroy)() | | Уничтожает карту. ||
|| [getBounds](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#getBounds)(\[[options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#getBounds-param-options)]) | Number[][] | Возвращает двумерный массив геокоординат левого нижнего и правого верхнего углов области показа карты. ||
|| [getCenter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#getCenter)(\[[options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#getCenter-param-options)]) | Number[] | Возвращает географические координаты текущего центра карты. ||
|| [getGlobalPixelCenter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#getGlobalPixelCenter)(\[[options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#getGlobalPixelCenter-param-options)]) | Number[] | Возвращает глобальные пиксельные координаты текущего центра карты. ||
|| [getPanoramaManager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#getPanoramaManager)() | [vow.Promise](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md).<[panorama.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Manager.md)> | Возвращает [vow.Promise](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md), который будет разрешен менеджером панорамы карты. Promise отклоняется при возникновении ошибки. ||
|| [getType](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#getType)() | String\|[MapType](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapType.md) | Возвращает текущий тип карты. ||
|| [getZoom](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#getZoom)() | Number | Возвращает текущий коэффициент масштабирования карты. ||
|| [panTo](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#panTo)([center](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#panTo-param-center)[, [options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#panTo-param-options)]) | [vow.Promise](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Устанавливает центр карты. Если передан массив точек, то карта будет перемещаться от одной точки к другой. ||
|| [setBounds](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setBounds)([bounds](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setBounds-param-bounds)[, [options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setBounds-param-options)]) | [vow.Promise](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Позиционирует карту для показа переданного района. ||
|| [setCenter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setCenter)([center](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setCenter-param-center)[, [zoom](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setCenter-param-zoom)[, [options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setCenter-param-options)]]) | [vow.Promise](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Устанавливает центр и коэффициент масштабирования карты. Центр задается в географических координатах. ||
|| [setGlobalPixelCenter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setGlobalPixelCenter)([globalPixelCenter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setGlobalPixelCenter-param-globalPixelCenter)[, [zoom](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setGlobalPixelCenter-param-zoom)[, [options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setGlobalPixelCenter-param-options)]]) | [vow.Promise](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Устанавливает центр и коэффициент масштабирования карты. Центр задается в глобальных пиксельных координатах. ||
|| [setType](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setType)([type](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setType-param-type)[, [options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setType-param-options)]) | [vow.Promise](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Устанавливает тип карты. ||
|| [setZoom](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setZoom)([zoom](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setZoom-param-zoom)[, [options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#setZoom-param-options)]) | [vow.Promise](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Устанавливает коэффициент масштабирования карты. ||
|#


## Описание полей {#field_detail}

### action {#action}

```javascript
{map.action.Manager} action
```

Менеджер действий карты.

**Пример:**

```javascript
var myAction = new ymaps.map.action.Single({
          center: [0, 0],
          zoom: 4,
          duration: 1000,
          timingFunction: "ease-in"
    });

myMap.action.execute(myAction);
```

### balloon {#balloon}

```javascript
{map.Balloon} balloon
```

Балун карты.

### behaviors {#behaviors}

```javascript
{map.behavior.Manager} behaviors
```

Менеджер поведений карты. Позволяет включать и выключать поведения, а также предоставляет доступ к их методам и свойствам.

**Пример:**

```javascript
// Включим масштабирование колесом мыши
myMap.behaviors.enable('scrollZoom');
```

### container {#container}

```javascript
{map.Container} container
```

Контейнер карты.

**Пример:**

```javascript
// Подгоним размер карты под новый размер контейнера
// (например, если изменилась верстка страницы или карта была инициализирована
// в скрытом состоянии)
map.container.fitToViewport();
```

### controls {#controls}

```javascript
{control.Manager} controls
```

Элементы управления картой.

**Пример:**

```javascript
myMap.controls.add('zoomControl', {
    float: 'none',
    position: {
        right: 40,
        top: 5
    }
});
```

### converter {#converter}

```javascript
{map.Converter} converter
```

Преобразователь пиксельных точек карты из глобальных в локальные и наоборот.

**Пример:**

```javascript
// Преобразуем координаты мыши в географические.
var projection = map.options.get('projection');
$('#map').bind('click', function (e) {
    console.log(projection.fromGlobalPixels(
        map.converter.pageToGlobal([e.pageX, e.pageY]), map.getZoom()
    ));
});
```

### copyrights {#copyrights}

```javascript
{map.Copyrights} copyrights
```

Менеджер размещённой на карте информации об авторских правах.

**Пример:**

```javascript
// Добавим информацию об авторе.
map.copyrights.add('© Вася Пупкин');
```

### cursors {#cursors}

```javascript
{util.cursor.Manager} cursors
```

Менеджер курсоров карты.

**Пример:**

```javascript
// Установим на карте курсор "знак вопроса".
var accessor = map.cursors.push('help');
// ...
// Удалим курсор.
accessor.remove();
```

### events {#events}

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

Менеджер событий карты. Поддерживает подписку с приоритетами. Бросает события типа [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md).

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

**1.**

```javascript
// Поставим метку по клику над картой.
map.events.add('click', function (e) {
    // Географические координаты точки клика можно узнать
    // посредством вызова метода .get('coords').
    var position = e.get('coords');
    map.geoObjects.add(new ymaps.Placemark(position));
});
```

**2.**

```javascript
// Будем отслеживать центр и зум карты при плавных перемещениях.
map.events.add('actiontick', function () {
    var state = map.action.getCurrentState();
    console.log(state.zoom, state.globalPixelCenter);
});
```

### geoObjects {#geoObjects}

```javascript
{map.GeoObjects} geoObjects
```

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

### hint {#hint}

```javascript
{map.Hint} hint
```

Хинт карты.

### layers {#layers}

```javascript
{map.layer.Manager} layers
```

Менеджер слоев карты.

**См.:** [Layer](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Layer.md)

**Пример:**

```javascript
// Добавим слой пользовательских тайлов на карту.
map.layers.add(new ymaps.Layer('http://some.server/tiles?&c'));
```

### margin {#margin}

```javascript
{map.margin.Manager} margin
```

Менеджер отступов карты.

### options {#options}

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

Опции карты.

**Пример:**

```javascript
// Запретим всем объектам на карте открывать балуны по щелчку мыши.
map.options.set('openBalloonOnClick', false);
```

### panes {#panes}

```javascript
{map.pane.Manager} panes
```

Менеджер контейнеров объектов карты.

**Пример:**

```javascript
// Добавим свой элемент в контейнер элементов управления карты.
$('<div><input type="button" value="Click!"/></div>')
    .css({ position: 'absolute', left: '5px', top: '50px'})
    .appendTo(map.panes.get('controls').getElement());
```

### zoomRange {#zoomRange}

```javascript
{map.ZoomRange} zoomRange
```

Объект, предоставляющий доступ к информации о доступных в точке уровнях масштабирования.

**Пример:**

```javascript
// Узнаем максимальный доступный в точке [20, 30] уровень
// масштабирования карты.
map.zoomRange.get([20, 30]).then(function (zoomRange) {
    alert(zoomRange[1]);
});
```

## Описание событий {#event_detail}

### actionbegin {#actionbegin}

Началось новое плавное движение карты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- action - запущенное действие.

### actionbreak {#actionbreak}

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

### actionend {#actionend}

Окончание плавного движения карты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- action - остановленное действие.

### actiontick {#actiontick}

Начало исполнения нового шага плавного движения (например, сдвиг карты пользователем или шаг анимации плавного масштабирования). Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- action - выполняемое в данный момент действие;
- tick – описание шага действия в виде объекта с полями globalPixelCenter, zoom, duration и timingFunction.

**Пример:**

```javascript
// Отслеживает все перемещения карты, даже перетаскивание пользователем
// и плавное масштабирование.
map.events.add('actiontick', function (e) {
    var tick = e.get('tick');
    console.log('Сейчас карта переместится в точку (' +
        map.options.get('projection').fromGlobalPixels(tick.globalPixelCenter, tick.zoom).join(',') +
        ') в течение ' + e.get('tick').duration + ' миллисекунд');
});
```

### actiontickcomplete {#actiontickcomplete}

Окончание исполнения шага плавного движения. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- action - выполняемое в данный момент действие;
- tick – описание шага действия в виде объекта с полями globalPixelCenter, zoom, duration и timingFunction.

### balloonclose {#balloonclose}

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

### balloonopen {#balloonopen}

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

### boundschange {#boundschange}

Событие изменения области просмотра карты (в результате изменения центра или уровня масштабирования). Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- oldCenter - предыдущий центр карты в геокоординатах;
- newCenter - новый центр карты в геокоординатах;
- oldZoom - предыдущий уровень машсштабирования;
- newZoom - новый уровень масштабирования;
- oldGlobalPixelCenter - предыдущий центр карты в глобальных пикселах;
- newGlobalPixelCenter - новый центр карты в глобальных пикселах;
- oldBounds - предыдущая область показа;
- newBounds - новая область показа.

**Пример:**

```javascript
// Будем отслеживать изменение уровня масштабирования карты.
map.events.add('boundschange', function (event) {
    if (event.get('newZoom') != event.get('oldZoom')) {
        alert('Уровень масштабирования изменился.');
    }
});
```

### destroy {#destroy}

Карта уничтожена.

### hintclose {#hintclose}

Закрытие хинта. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md).

### hintopen {#hintopen}

Открытие хинта на карте. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md).

### marginchange {#marginchange}

Изменились отступы карты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md).

### optionschange  {#optionschange}

Изменились опции карты.

### sizechange {#sizechange}

Изменился размер карты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- oldSize - предыдущий размер карты;
- newSize - новый размер карты.

### typechange {#typechange}

Изменился тип карты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md).

## Описание методов {#method_detail}

### destroy {#destroy}

```javascript
{} destroy()
```

Уничтожает карту.

### getBounds {#getBounds}

```javascript
{Number[][]} getBounds([options])
```

**Возвращает** двумерный массив геокоординат левого нижнего и правого верхнего углов области показа карты.

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

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

Опции. ||
|| [`options.useMapMargin`](#getBounds-param-options.useMapMargin) | false | Тип: Boolean

Нужно ли учитывать отступы, которые были рассчитаны в менеджере отступов [map.margin.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md). ||
|#

### getCenter {#getCenter}

```javascript
{Number[]} getCenter([options])
```

**Возвращает** географические координаты текущего центра карты.

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

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

Опции. ||
|| [`options.useMapMargin`](#getCenter-param-options.useMapMargin) | false | Тип: Boolean

Нужно ли учитывать отступы, которые были рассчитаны в менеджере отступов [map.margin.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md). ||
|#

### getGlobalPixelCenter {#getGlobalPixelCenter}

```javascript
{Number[]} getGlobalPixelCenter([options])
```

**Возвращает** глобальные пиксельные координаты текущего центра карты.

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

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

Опции. ||
|| [`options.useMapMargin`](#getGlobalPixelCenter-param-options.useMapMargin) | false | Тип: Boolean

Нужно ли учитывать отступы, которые были рассчитаны в менеджере отступов [map.margin.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md). ||
|#


**Пример:**

```javascript
// Сдвинем карту на 10 пикселей влево.
var position = map.getGlobalPixelCenter();
map.setGlobalPixelCenter([ position[0] - 10, position[1] ]);
```

### getPanoramaManager {#getPanoramaManager}

```javascript
{vow.Promise.<panorama.Manager>} getPanoramaManager()
```

Возвращает [vow.Promise](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md), который:

- будет **разрешен** объектом <[panorama.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/panorama.Manager.md)> — менеджером панорамы карты;
- либо **отклонен** с ошибкой.

### getType {#getType}

```javascript
{String|MapType} getType()
```

**Возвращает** текущий тип карты.

### getZoom {#getZoom}

```javascript
{Number} getZoom()
```

**Возвращает** текущий коэффициент масштабирования карты.

### panTo {#panTo}

```javascript
{vow.Promise} panTo(center[, options])
```

Устанавливает центр карты. Если передан массив точек, то карта будет перемещаться от одной точки к другой.

**Возвращает** объект-promise. В случае корректного выполнения действия будет возвращен resolve без значения. В случае ошибки будет возвращен reject с описанием ошибки.

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

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

Центр карты или массив точек для последовательного обхода. ||
|| [`options`](#panTo-param-options) | — | Тип: Object

Опции. ||
|| [`options.checkZoomRange`](#panTo-param-options.checkZoomRange) | false | Тип: Boolean

Проверка возможности установить текущий коэффициент масштабирования при изменении центра карты. Если значение опции равно true, метод вызывается асинхронно. Производится обращение к серверу, который возвращает интервал допустимых для данного центра значений коэффициентов масштабирования. После этого выставляется указанный центр и корректный зум. ||
|| [`options.delay`](#panTo-param-options.delay) | 1000 | Тип: Number

Время задержки между перемещениями в миллисекундах. ||
|| [`options.duration`](#panTo-param-options.duration) | 500 | Тип: Number

Время анимации в миллисекундах. ||
|| [`options.flying`](#panTo-param-options.flying) | true | Тип: Boolean

Разрешает уменьшать и затем увеличивать зум карты при перемещении между точками. Если расстояние между точками не превышает двух размеров контейнера карты, то карта плавно переместит центр в указанную точку без изменения масштаба. Если расстояние больше, то карта выставит себе меньший коэффициент масштабирования, затем сместится к конечной точке и выставит требуемый коэффициент масштабирования (эмуляция полета над картой). ||
|| [`options.safe`](#panTo-param-options.safe) | true | Тип: Boolean

Безопасное смещение карты. Используется при значении опции flying равной false. Если расстояние между точками не превышает двух размеров контейнера карты, то карта плавно переместит центр в указанную точку. Если расстояние больше, то произойдет мгновенный переход в выбранную точку. При помощи этого режима удобно перемещать карту без отображения незагруженных тайлов. ||
|| [`options.timingFunction`](#panTo-param-options.timingFunction) | 'ease-in-out' | Тип: String

Тайминг-функция. Аналогично значению CSS свойства transition-timing-function. Полный список значений: [http://www.w3.org/TR/css3-transitions/#transition-timing-function_tag](http://www.w3.org/TR/css3-transitions/#transition-timing-function_tag) ||
|| [`options.useMapMargin`](#panTo-param-options.useMapMargin) | false | Тип: Boolean

Нужно ли учитывать отступы, которые были рассчитаны в менеджере отступов [map.margin.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md). ||
|#

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

**Пример:**

```javascript
// Перелет из Калининграда во Владивосток через Москву.
map.setCenter([54.704815, 20.466380], 10);
map.panTo([
    [55.751574, 37.573856],
    [43.134091, 131.928478]
]).then(function () {
   alert('Прилетели!');
}, function (err) {
   alert('Произошла ошибка ' + err);
}, this);
```

### setBounds {#setBounds}

```javascript
{vow.Promise} setBounds(bounds[, options])
```

Позиционирует карту для показа переданного района.

**Возвращает** объект-promise. В случае корректного выполнения действия будет возвращен resolve без значения. В случае ошибки будет возвращен reject с описанием ошибки.

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

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

Границы области видимости, заданные координатами левого нижнего и правого верхнего углов области. ||
|| [`options`](#setBounds-param-options) | — | Тип: Object

Опции. ||
|| [`options.checkZoomRange`](#setBounds-param-options.checkZoomRange) | false | Тип: Boolean

Проверка возможности установить указанный коэффициент масштабирования. Если значение опции равно true, метод вызывается асинхронно. Производится обращение к серверу, который возвращает интервал допустимых для данного центра значений коэффициентов масштабирования. После этого выставляется указанный центр и корректный зум. ||
|| [`options.duration`](#setBounds-param-options.duration) | 0 | Тип: Number

Время анимации в миллисекундах. ||
|| [`options.preciseZoom`](#setBounds-param-options.preciseZoom) | false | Тип: Boolean

Возможность использования дробных коэффициентов масштабирования. ||
|| [`options.timingFunction`](#setBounds-param-options.timingFunction) | 'linear' | Тип: String

Тайминг-функция. Аналогично значению CSS свойства transition-timing-function. Полный список значений: [http://www.w3.org/TR/css3-transitions/#transition-timing-function_tag](http://www.w3.org/TR/css3-transitions/#transition-timing-function_tag) ||
|| [`options.useMapMargin`](#setBounds-param-options.useMapMargin) | false | Тип: Boolean

Нужно ли учитывать отступы, которые были рассчитаны в менеджере отступов [map.margin.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md). ||
|| [`options.zoomMargin`](#setBounds-param-options.zoomMargin) | 0 | Тип: Number\|Number[]

Отступы от границ видимой области карты. Если задано одно число - оно применяется ко всем сторонам. Если задано два - то это горизонтальные и вертикальные отступы соответственно. Если задан массив из 4х чисел, то это отступы top, right, bottom, left. При включенной опции "useMapMargin" значение "zoomMargin" складывается со значениями, которые были рассчитаны в менеджере отступов [map.margin.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md). ||
|#

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

**Пример:**

```javascript
// Устанавливает центр и коэффициент масштабирования карты.
// Если текущий zoomRange не совпадает с zoomRange для нового центра карты,
// могут быть отображены серые тайлы в случае, если область показа очень мала.
// Чтобы избежать этой проблемы, используйте опцию checkZoomRange.
map.setBounds([[60,-40], [20,60]], {
   checkZoomRange: true,
}).then(function () {
       // Действие было успешно завершено.
   }, function (err) {
      // Не удалось показать заданный регион.
      // ...
   }, this);
```

### setCenter {#setCenter}

```javascript
{vow.Promise} setCenter(center[, zoom[, options]])
```

Устанавливает центр и коэффициент масштабирования карты. Центр задается в географических координатах.

**Возвращает** объект-promise. В случае корректного выполнения действия будет возвращен resolve без значения. В случае ошибки будет возвращен reject с описанием ошибки.

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

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

Геокоординаты центра карты. ||
|| [`zoom`](#setCenter-param-zoom) | — | Тип: Number

Коэффициент масштабирования карты. ||
|| [`options`](#setCenter-param-options) | — | Тип: Object

Опции. ||
|| [`options.checkZoomRange`](#setCenter-param-options.checkZoomRange) | false | Тип: Boolean

Проверка возможности установить указанный коэффициент масштабирования. Если значение опции равно true, метод вызывается асинхронно. Производится обращение к серверу, который возвращает интервал допустимых для данного центра значений коэффициентов масштабирования. После этого выставляется указанный центр и корректный зум. ||
|| [`options.duration`](#setCenter-param-options.duration) | 0 | Тип: Number

Время анимации в миллисекундах. ||
|| [`options.timingFunction`](#setCenter-param-options.timingFunction) | 'linear' | Тип: String

Тайминг-функция. Аналогично значению CSS свойства transition-timing-function. Полный список значений: [http://www.w3.org/TR/css3-transitions/#transition-timing-function_tag](http://www.w3.org/TR/css3-transitions/#transition-timing-function_tag) ||
|| [`options.useMapMargin`](#setCenter-param-options.useMapMargin) | false | Тип: Boolean

Нужно ли учитывать отступы, которые были рассчитаны в менеджере отступов [map.margin.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md). ||
|#

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

**Пример:**

```javascript
myMap.setCenter([40, 50], 3, {
    checkZoomRange: true
});
```

### setGlobalPixelCenter {#setGlobalPixelCenter}

```javascript
{vow.Promise} setGlobalPixelCenter(globalPixelCenter[, zoom[, options]])
```

Устанавливает центр и коэффициент масштабирования карты. Центр задается в глобальных пиксельных координатах.

**Возвращает** объект-promise. В случае корректного выполнения действия будет возвращен resolve без значения. В случае ошибки будет возвращен reject с описанием ошибки.

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

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

Пиксельные координаты нового центра карты. ||
|| [`zoom`](#setGlobalPixelCenter-param-zoom) | — | Тип: Number

Коэффициент масштабирования карты. ||
|| [`options`](#setGlobalPixelCenter-param-options) | — | Тип: Object

Опции. ||
|| [`options.checkZoomRange`](#setGlobalPixelCenter-param-options.checkZoomRange) | false | Тип: Boolean

Проверка возможности установить указанный коэффициент масштабирования. Если значение опции равно true, метод вызывается асинхронно. Производится обращение к серверу, который возвращает интервал допустимых для данного центра значений коэффициентов масштабирования. После этого выставляется указанный центр и корректный зум. ||
|| [`options.duration`](#setGlobalPixelCenter-param-options.duration) | 0 | Тип: Number

Время анимации в миллисекундах. ||
|| [`options.timingFunction`](#setGlobalPixelCenter-param-options.timingFunction) | 'linear' | Тип: String

Тайминг-функция. Аналогично значению CSS свойства transition-timing-function. Полный список значений: [http://www.w3.org/TR/css3-transitions/#transition-timing-function_tag](http://www.w3.org/TR/css3-transitions/#transition-timing-function_tag) ||
|| [`options.useMapMargin`](#setGlobalPixelCenter-param-options.useMapMargin) | false | Тип: Boolean

Нужно ли учитывать отступы, которые были рассчитаны в менеджере отступов [map.margin.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md). ||
|#

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

**Пример:**

```javascript
// Сдвинем карту на 10 пикселей влево.
var position = map.getGlobalPixelCenter();
map.setGlobalPixelCenter([ position[0] - 10, position[1] ]);
```

### setType {#setType}

```javascript
{vow.Promise} setType(type[, options])
```

Устанавливает тип карты.

**Возвращает** объект-promise. В случае корректного выполнения действия будет возвращен resolve без значения. В случае ошибки будет возвращен reject с описанием ошибки.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`type`](#setType-param-type)[*](*star) | — | Тип: String\|[MapType](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapType.md)

Тип карты. Может быть ключом или или экземпляром класса [MapType](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapType.md). Список доступных ключей:
- 'yandex#map' - тип карты "схема";
- 'yandex#satellite' - тип карты "спутник";
- 'yandex#hybrid' - тип карты "гибрид". ||
|| [`options`](#setType-param-options) | — | Тип: Object

Опции карты. ||
|| [`options.checkZoomRange`](#setType-param-options.checkZoomRange) | false | Тип: Boolean

Проверка возможности установить указанный тип карты при данном уровне масштабирования. При значении true производится обращение к серверу, который возвращает интервал допустимых для данного типа карты значений коэффициентов масштабирования. После этого выставляется указанный центр и корректный зум. ||
|#

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

**Пример:**

```javascript
map.setType('yandex#hybrid', {
  checkZoomRange: true
}).then(function () {
  // Тип карты был установен с допустимым уровнем масштабирования.
}, this);
```

### setZoom {#setZoom}

```javascript
{vow.Promise} setZoom(zoom[, options])
```

Устанавливает коэффициент масштабирования карты.

**Возвращает** объект-promise. В случае корректного выполнения действия будет возвращен resolve без значения. В случае ошибки будет возвращен reject с описанием ошибки.

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

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

Коэффициент масштабирования карты. ||
|| [`options`](#setZoom-param-options) | — | Тип: Object

Опции. ||
|| [`options.checkZoomRange`](#setZoom-param-options.checkZoomRange) | false | Тип: Boolean

Проверка возможности установить указанный коэффициент масштабирования. ||
|| [`options.duration`](#setZoom-param-options.duration) | 0 | Тип: Number

Время анимации в миллисекундах. ||
|| [`options.useMapMargin`](#setZoom-param-options.useMapMargin) | false | Тип: Boolean

Нужно ли учитывать отступы, которые были рассчитаны в менеджере отступов [map.margin.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md). ||
|#

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

**Пример:**

```javascript
myMap.setZoom(4, {duration: 1000});
```

<!-- XLIFF_FARM_ZWE0OTM1_CACHING -->

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