Параметры Яндекс.Карт (params)

Если Вам понравился данный материал, поделитесь им с вашими друзьями в соц сетях

В предыдущем материале Инициализация Яндекс.Карт мы с Вами выполнили инициализацию карты. Сейчас мы рассмотрим что такое параметры карты, которые необходимо задать во время создания карты и возможно изменять после ее создания.

При инициализации карты, ей передается 3 параметра:

географические координаты центра карты: center
масштаб карты (коэффициент масштабирования): zoom
тип карты: type

создаем карту

<script type="text/javascript">
var myMap;
// при успешной загрузке API выполняется соответствующая функция
ymaps.ready(function(){
    // создание экземпляра карты и его привязка к контейнеру с id="map"
    myMap = new ymaps.Map("map", {
        // центр карты
        center: [55.75396, 37.620393],
        // коэффициент масштабирования
        zoom: 8,
        // тип карты, по умолчанию используется тип карты "схема"
        //type: "yandex#map",
    });
}); // end ymaps.ready
</script>

Таким образом передав в конструктор параметры мы научились создавать Яндекс.Карту. Но как было указано выше, значения параметров карты возможно получить и изменять после ее создания.

Рассмотрим каждый из этих параметров и методы для работы с ним подробнее.

Центр карты

Для указания местоположения объектов (в том числе и центра карты) на Яндекс.Картах применяются географические координаты. Географические координаты представляют собой географическую долготу и широту (longitude - долгота, latitude - широта).

Для получения центр карты используйте метод getCenter()

myMap.getCenter();
// ответ
[55.75396, 37.620393]

Для изменения центра карты используйте метод setCenter()

myMap.setCenter("географические координаты");
т.е.
myMap.setCenter([55.75396, 37.620393]);

Для плавного перемещения центра карты используйте метод panTo()

myMap.panTo([55.75396, 37.620393]);

Масштаб карты (коэффициент масштабирования)

Масштаб карты определяет текущее разрешение изображения карты. Коэффициент принимает значения от 1 (на карте отображены все континенты) до 17 (видны отдельные здания).

Для получения текущего масштаба карты используйте метод getZoom()

myMap.getZoom();
// ответ
8

Для изменения типа карты используйте метод setZoom()

myMap.setZoom("значение масштабирования от 1 до 17");
т.е.
myMap.setZoom(8);

Тип карты

API предоставляет три встроенных типа карт:

схема ("yandex#map")
спутник ("yandex#satellite")
гибрид ("yandex#hybrid")

Для получения текущего типа карты используйте метод getType()

myMap.getType();
// ответ
"yandex#map"

Для изменения типа карты используйте метод setType()

myMap.setType("тип карты");
т.е.
myMap.setType("yandex#satellite");

Как получить и изменить параметры карты после ее создания

Выше в материале было описаны примеры, и именно базовые методы для работы с каждый из параметров карты. Для опытных разработчиков не составит большого труда использовать данные методы. Для начинающих специалистов я бы хотел подробнее показать как работать с данными методы, так как понимание этих основ даст хороший толчок в дальнейшем изучении моих материалов по API Яндекс.Карт.

Для этого прошу Вас ознакомится с материалом Инициализация Яндекс.Карт, а дальше в материале будут приведены примеры вызовов базовых методов для работы с параметрами карты. Для этих примеров я буду использовать JavaScript консоль веб браузера.