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);
});