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

# map.ZoomRange

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

Менеджер коэффициентов масштабирования карты. У каждой карты уже есть свой менеджер коэффициентов масштабирования, доступный как map.zoomRange. Не инстанцируйте экземпляры этого класса без необходимости.

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

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

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

```javascript
map.ZoomRange(map, constraints)
```

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

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

Карта. ||
|| [`constraints`](#param-constraints)[*](*star) | — | Тип: Number[]

Массив, содержащий минимальный и максимальный зум карты. ||
|#

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

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

#|
|| **Имя** | **Тип** | **Описание** ||
|| [events](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventManager.md) | Менеджер событий.

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

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

#|
|| **Имя** | **Описание** ||
|| [change](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.ZoomRange.md#event-change) | Произошло изменение диапазона масштабов карты. ||
|#


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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.ZoomRange.md#get)(\[[coords](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.ZoomRange.md#get-param-coords)]) | [vow.Promise](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Определяет доступный в указанной точке диапазон уровней масштабирования. ||
|| [getCurrent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.ZoomRange.md#getCurrent)() | Number[] | Возвращает текущее (последнее полученное) значение минимального и максимального уровня масштабирования карты. ||
|#

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

### change {#change}

Произошло изменение диапазона масштабов карты.

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

### get {#get}

```javascript
{vow.Promise} get([coords])
```

Определяет доступный в указанной точке диапазон уровней масштабирования.

**Возвращает** Promise объект, который будет подтверждён массом из двух чисел — максимальный и минимальный уровень масштабирования в данной точке.

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

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

Координаты точки. Если не указана, берётся текущий центр карты. ||
|#


**Пример:**

```javascript
// Найдем координаты офиса компании Яндекс и покажем его на карте
// на максимально возможном уровне масштабирования.
ymaps.geocode('Москва, улица Льва Толстого, 16').then(function (res) {
    var coords = res.geoObjects.get(0).geometry.getCoordinates();
    map.zoomRange.get(coords).then(function (range) {
        map.setCenter(coords, range[1]);
    });
});
```

### getCurrent {#getCurrent}

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

**Возвращает** текущее (последнее полученное) значение минимального и максимального уровня масштабирования карты.

<!-- XLIFF_FARM_MDgzY2Nm_CACHING -->

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