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

# util.requireCenterAndZoom

Статическая функция.

Вычисляет оптимальный центр и уровень масштабирования карты для отображения переданной области на указанном типе карты. Уровень масштаба будет в рамках доступного диапозона масштабов.

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

```javascript
{ vow.Promise } util.requireCenterAndZoom(mapType, bounds, containerSize[, params])
```

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

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

Тип карты. Cтрока-ключ из [mapType.storage](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/mapType.storage.md), либо экземпляр класса [MapType](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapType.md). Или менеджер коэффициентов масштабирования карты конкретной карты. ||
|| [`bounds`](#param-bounds)[*](*star) | — | Тип: Number[][]

Область, заданная в географических координатах. Первая точка содержит минимальные значения широты и долготы, вторая точка - максимальные. ||
|| [`containerSize`](#param-containerSize)[*](*star) | — | Тип: Number[]

Размер контейнера карты. ||
|| [`params`](#param-params) | — | Тип: Object

Параметры. ||
|| [`params.inscribe`](#param-params.inscribe) | true | Тип: Boolean

true - вписывать область в карту, false — вписывать карту в область. ||
|| [`params.margin`](#param-params.margin) | 0 | Тип: Number\|Number[]

Отступы от границ видимой области карты. Если задано одно число - оно применяется ко всем сторонам. Если задано два - то это горизонтальные и вертикальные отступы соответственно. Если задан массив из 4х чисел, то это отступы top, right, bottom, left. ||
|| [`params.preciseZoom`](#param-params.preciseZoom) | false | Тип: Boolean

При значении false уровень масштабирования будет округлен в меньшую сторону. ||
|#

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

**Пример:**

```javascript
// Находим оптимальный центр и уровень масштабирования карты.
ymaps.util.requireCenterAndZoom(
    myMap.getType(),
    [[50.531219,31.278264], [50.966841,31.964909]],
    myMap.container.getSize()
).then(function (result) {
    // Устанавливаем карте оптимальный центр и зум.
    myMap.setCenter(result.center, result.zoom);
});
```

<!-- XLIFF_FARM_ZTg5ODBm_CACHING -->

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