util.requireCenterAndZoom

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

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

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

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

Параметры:

Параметр Значение по умолчанию Описание
mapType *

Тип: String|MapType|map.ZoomRange

Тип карты. Cтрока-ключ из mapType.storage, либо экземпляр класса MapType. Или менеджер коэффициентов масштабирования карты конкретной карты.

bounds *

Тип: Number[][]

Область, заданная в географических координатах. Первая точка содержит минимальные значения широты и долготы, вторая точка - максимальные.

containerSize *

Тип: Number[]

Размер контейнера карты.

params

Тип: Object

Параметры.

params.inscribe true

Тип: Boolean

true - вписывать область в карту, false — вписывать карту в область.

params.margin 0

Тип: Number|Number[]

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

params.preciseZoom false

Тип: Boolean

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

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

Пример:

// Находим оптимальный центр и уровень масштабирования карты.
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);
    });