util.requireCenterAndZoom
Статическая функция.
Вычисляет оптимальный центр и уровень масштабирования карты для отображения переданной области на указанном типе карты. Уровень масштаба будет в рамках доступного диапозона масштабов.
Возвращает Promise объект, который будет подтвержден объектом с полями center и zoom или будет отклонен с ошибкой.
{ vow.Promise } util.requireCenterAndZoom(mapType, bounds, containerSize[, params])
Параметры:
Параметр |
Значение по умолчанию |
Описание |
— |
Тип: String|MapType|map.ZoomRange Тип карты. Cтрока-ключ из mapType.storage, либо экземпляр класса MapType. Или менеджер коэффициентов масштабирования карты конкретной карты. |
|
— |
Тип: Number[][] Область, заданная в географических координатах. Первая точка содержит минимальные значения широты и долготы, вторая точка - максимальные. |
|
— |
Тип: Number[] Размер контейнера карты. |
|
— |
Тип: Object Параметры. |
|
true |
Тип: Boolean true - вписывать область в карту, false — вписывать карту в область. |
|
0 |
Тип: Number|Number[] Отступы от границ видимой области карты. Если задано одно число - оно применяется ко всем сторонам. Если задано два - то это горизонтальные и вертикальные отступы соответственно. Если задан массив из 4х чисел, то это отступы top, right, bottom, left. |
|
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);
});
Обязательный параметр.