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

# Map

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

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

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

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

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

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

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

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

Параметры карты. ||
|| `state.behaviors` | — | Тип: String[]

Включенные поведения карты. По умолчанию включаются: перетаскивание карты, масштабирование карты мультисенсорным касанием и двойным кликом на устройствах с сенсорным экраном; перетаскивание карты мышью, масштабирование двойным щелчком и выделением области правой кнопкой мыши на остальных устройствах. Можно указывать любые ключи, которые поддерживаются [map.behavior.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.behavior.Manager.md). ||
|| `state.bounds` | — | Тип: Number[][]

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

Геокоординаты центра карты. Должны быть заданы совместно со state.zoom. ||
|| `state.type` | 'yandex#map' | Тип: String\|[MapType](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/MapType.md)

Тип карты. Может быть ключом или экземпляром класса [MapType](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/MapType.md). Список доступных ключей:

• 'yandex#map' - тип карты "схема";

• 'yandex#satellite' - тип карты "спутник";

• 'yandex#hybrid' - тип карты "гибрид". ||
|| `state.zoom` | — | Тип: Number

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

Опции карты. Через опции карты можно задавать настройки как самой карты, так и добавленных на неё объектов:
• опции [поведений карты](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.behavior.Manager.md#constructor-summary);

• опции [балуна карты](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Balloon.md#constructor-summary) с префиксом `balloon`;

• опции [хинта карты](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Hint.md#constructor-summary) с префиксом `hint`;

• опции [гео-объектов](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md#constructor-summary) с префиксом `geoObject`;

• опции [слоев](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Layer.md) с префиксом `layer`;

• опции [слоев хотспотов](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/hotspot.Layer.md) с префиксом `hotspotLayer`;

Опции, которые трактует непосредственно сама карта, перечислены ниже. ||
|| `options.adjustZoomOnTypeChange` | false | Тип: Number

Выбранного типа карты с текущим кооэффициентом масштабирования тайлов может не оказаться. При значении true кооэффициент масштабирования будет изменен на ближаший допустимый. ||
|| `options.autoFitToViewport` | 'ifNull'  | Тип: String

Автоматическое слежение за контейнером карты. По умолчанию карта перестроится автоматически в случае, когда она инициализируется из скрытого контейнера, либо мы программно поменяли его размеры, иначе необходимо вызвать map.container.fitToViewport. Доступны следующие значения: 
• none — не следить за изменением отображения контейнера при инициализации из скрытого контейнера или при программном изменении его размеров;

• ifNull — как только контейнер получит CSS значение «display», отличное от «none», автоматически запустится map.container.fitToViewport, чтобы подстроить карту под него. После слежение будет остановлено;

• always — постоянно следить за изменением состояния отображения контейнера карты. ||
|| `options.avoidFractionalZoom` | true | Тип: Boolean

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

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

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

Минимальный коэффициент масштабирования карты. ||
|| `options.projection` | ymaps.projection.wgs84Mercator | Тип: [IProjection](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IProjection.md)

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

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

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

true - включить автоматическое переключение на Народную Карту там, где схема недостаточно подробна, false - выключить. Эта опция работает только при значениях параметра lang=ru-RU и lang=uk-UA. ||
|#

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

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

**1.**

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

**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 : 10
    });
});
```

## Поля {#fields}

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

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

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

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

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

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

• action - выполняемое в данный момент действие;

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

• action - выполняемое в данный момент действие;

• tick - описание шага действия в виде объекта с полями globalPixelCenter, zoom, duration и timingFunction. ||
|| [balloonclose](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md#balloonclose) | Закрыт балун ||
|| [balloonopen](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md#balloonopen) | Открыт балун на карте. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

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

• oldCenter - предыдущий центр карты в геокоординатах;

• newCenter - новый центр карты в геокоординатах;

• oldZoom - предыдущий уровень машсштабирования;

• newZoom - новый уровень масштабирования;

• oldGlobalPixelCenter - предыдущий центр карты в глобальных пикселах;

• newGlobalPixelCenter - новый центр карты в глобальных пикселах;

• oldBounds - предыдущая область показа;

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

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

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

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

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

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

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

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

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

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

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

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

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#multitouchstart). ||
|| [optionschange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md#optionschange) | Изменились опции карты. ||
|| [sizechange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md#sizechange) | Изменился размер карты. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• oldSize - предыдущий размер карты;

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

• oldType - предыдущий тип карты;

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

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

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

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

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

### 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

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

Балун карты.

**Пример:**

```javascript
myMap.balloon.open(myMap.getCenter(), {
    content: 'Hello Yandex!'
}, {
    closeButton: true
});
```

### behaviors

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

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

**Пример:**

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

### container

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

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

**Пример:**

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

### controls

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

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

**Пример:**

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

### 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

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

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

**Пример:**

```javascript
// Добавим информацию об авторе
map.copyrights.add('&copy; Vassily Poupkine');
```

### cursors

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

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

### events

```javascript
{event.PriorityManager} events
```

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

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

**1.**

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

**2.**

```javascript
// Запретим пользователю уводить карту за пределы заданной области
// и подыматься выше определённого уровня масштабирования.

// Геокоординаты области, которой мы хотим ограничить просмотр карты
var bounds = [[45, 20], [65, 60]];
// Запретим пользователю подыматься на уровни масштабирования меньше 5
map.options.set('minZoom', 5);
// Будем слушать изменение области показа карты и плавно возвращать
// пользователя обратно в пределы заданной области.
map.events.add('boundschange', function (e) {
    // Новая область показа карты
    var newBounds = e.get('newBounds'),
    // Считаем, насколько нужно сместить центр карты, чтобы
    // вернуть пользователя обратно в заданные границы
        offset = [
            bounds[0][0] > newBounds[0][0] ?
                bounds[0][0] - newBounds[0][0] :
                (bounds[1][0] < newBounds[1][0] ? bounds[1][0] - newBounds[1][0] : 0),
            bounds[0][1] > newBounds[0][1] ?
                bounds[0][1] - newBounds[0][1] :
                (bounds[1][1] < newBounds[1][1] ? bounds[1][1] - newBounds[1][1] : 0)
        ];
     // Если пользователь вышел за границы, возвращаем его обратно
     if (offset[0] || offset[1]) {
         map.setCenter([
             map.getCenter()[0] + offset[0],
             map.getCenter()[1] + offset[1]
         ]);
     }
});
```

### geoObjects

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

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

### hint

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

Хинт карты.

**Пример:**

```javascript
myMap.hint.show(myMap.getCenter(), {
    hintContent: 'Hello Yandex!'
}, {
    hintHasHideButton: true
});
```

### layers

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

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

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

**Пример:**

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

### options

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

Опции карты.

**Пример:**

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

### 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

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

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

**Пример:**

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

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

### actionbegin

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

• action - запущенное действие.
 
### actionbreak

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

• action - действие.

### actionend

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

• action - остановленное действие.

### actiontick

Начало исполнения нового шага плавного движения (например, сдвиг карты пользователем или шаг анимации плавного масштабирования). Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.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

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

• action - выполняемое в данный момент действие;

• tick - описание шага действия в виде объекта с полями globalPixelCenter, zoom, duration и timingFunction.

### balloonclose

Закрыт балун

### balloonopen

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

• balloon - экземпляр балуна.

### boundschange

Событие изменения области просмотра карты (в результате изменения центра или уровня масштабирования). Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.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

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

### hinthide

Скрыт хинт.

### hintshow

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

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

### sizechange

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

• oldSize - предыдущий размер карты;

• newSize - новый размер карты.

### typechange

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

• oldType - предыдущий тип карты;

• newType - новый тип карты.

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

### destroy

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

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

### getBounds

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

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

### getCenter

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

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

### getGlobalPixelCenter

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

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

**Пример:**

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

### getType

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

**Returns** текущий тип карты.

### getZoom

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

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

### panTo

```javascript
{Map} panTo(center, options)
```

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

**Returns** ссылку на карту.

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

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

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

Опции. ||
|| `options.callback` | — | Тип: Function

Функция, которая вызывается по окончании выполнения действия. В функцию передается параметр err. В случае корректного выполнения действия err=null, в остальных случаях параметр является признаком ошибки. ||
|| `options.checkZoomRange` | false | Тип: Boolean

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

Время задержки выполнения очередного перемещения в милисекундах. ||
|| `options.duration` | 500 | Тип: Number

Время анимации в миллисекундах. ||
|| `options.flying` | true | Тип: Boolean

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

Тайминг-функция. Может задаваться как с помощью отдельных коэффициентов: 'cubic-bezier(0,1,1,0)', так и строкой: 'linear', 'ease', 'ease-in', 'ease-out', 'ease-in-out'. ||
|#

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

**Пример:**

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

### setBounds

```javascript
{Map} setBounds(bounds[, options])
```

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

**Returns** ссылку на себя.

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

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

Границы области показа. ||
|| `options` | — | Тип: Object

Опции. ||
|| `options.callback` | false | Тип: Boolean

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

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

Время анимации в миллисекундах. ||
|| `options.preciseZoom` | false | Тип: Boolean

Возможность использования дробных коэффициентов масштабирования. ||
|| `options.timingFunction` | — | Тип: Function

Тайминг-функция. ||
|| `options.zoomMargin` | 0 | Тип: Number\|Number[]

Отступы от границ видимой области карты. Если задано одно число - оно применяется ко всем сторонам. Если задано два - то это горизонтальные и вертикальные отступы соответственно. Если задан массив из 4х чисел, то это отступы top, right, bottom, left. ||
|#

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

**Пример:**

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

### setCenter

```javascript
{Map} setCenter(center[, zoom[, options]])
```

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

**Returns** ссылку на себя.

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

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

Геокоординаты центра карты. ||
|| `zoom` | — | Тип: Number

Коэффициент масштабирования карты. ||
|| `options` | — | Тип: Object

Опции карты. ||
|| `options.callback` | — | Тип: Function

Функция, которая вызывается по окончании выполнения действия. В функцию передается параметр err. В случае корректного выполнения действия err=null, в остальных случаях параметр является признаком ошибки. ||
|| `options.checkZoomRange` | false | Тип: Boolean

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

Время анимации в миллисекундах. ||
|| `options.timingFunction` | — | Тип: Function

Тайминг-функция. ||
|#

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

**Пример:**

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

### setGlobalPixelCenter

```javascript
{Map} setGlobalPixelCenter(globalPixelCenter[, zoom[, options]])
```

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

**Returns** ссылку на карту.

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

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

Пиксельные координаты нового центра карты. ||
|| `zoom` | — | Тип: Number

Коэффициент масштабирования карты. ||
|| `options` | — | Тип: Object

Опции. ||
|| `options.callback` | — | Тип: Function

Функция, которая вызывается по окончании выполнения действия. В функцию передается параметр err. В случае корректного выполнения действия err=null, в остальных случаях параметр является признаком ошибки. ||
|| `options.checkZoomRange` | false | Тип: Boolean

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

Время анимации в миллисекундах. ||
|| `options.timingFunction` | — | Тип: Function

Тайминг-функция. ||
|#

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

**Пример:**

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

### setType

```javascript
{Map} setType(type)
```

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

**Returns** ссылку на себя.

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

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

Тип карты. Может быть ключом или или экземпляром класса [MapType](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/MapType.md). Список доступных ключей:

• 'yandex#map' - тип карты "схема";

• 'yandex#satellite' - тип карты "спутник";

• 'yandex#hybrid' - тип карты "гибрид". ||
|#

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

**Пример:**

```javascript
myMap.setType('yandex#hybrid');
```

### setZoom

```javascript
{Map} setZoom(zoom[, options])
```

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

**Returns** ссылку на себя.

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

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

Коэффициент масштабирования карты. ||
|| `options` | — | Тип: Object

Опции. ||
|| `options.callback` | — | Тип: Function

Функция, которая вызывается по окончании выполнения действия. В функцию передается параметр err. В случае корректного выполнения действия err=null, в остальных случаях параметр является признаком ошибки. ||
|| `options.checkZoomRange` | false | Тип: Boolean

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

Время анимации в миллисекундах. ||
|#


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

**Пример:**

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

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

