API карт включает в себя несколько встроенных наборов элементов управления (для маленьких, средних и больших карт) и предоставляет возможность расположить элементы управления произвольным образом, а также реализовать собственный элемент управления.
Элементы управления автоматически адаптируются под размер карты и параметры устройства.
Набор элементов управления, которые добавляются на карту при ее создании, указывается в конструкторе карты. По умолчанию будет подключен набор default
, состоящий из элементов управления:
Элементы управления программно связаны с объектом карты и хранятся в виде коллекции, ссылка на которую содержится в поле controls.
<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",
// подключаем элементы управления: "по умолчанию"
controls: ["default"]
// или так - подключаем элементы управления: "по умолчанию" и редактор маршрутов routeEditor
controls: ["default", "routeEditor"]
// или так - подключаем элементы управления: zoomControl, zoomControl, fullscreenControl
controls: ["zoomControl", "zoomControl", "fullscreenControl"]
// или так - отключаем все элементы управления
controls: []
});
// ...
// код работы с элементами управления Яндекс.Карты
// ...
}); // end ymaps.ready
</script>
controls: ["smallMapDefaultSet"]
.controls: ["default"]
.controls: ["largeMapDefaultSet"]
.geolocationControl Геолокации
searchControl
- Поисковая строкаrouteEditor
- Редактора маршрутаzoomControl
- Ползунок масштабаfullscreenControl
- Полноэкранный режимtrafficControl
- ПробкиtypeSelector
- Тип картыrulerControl
- Измерение расстоянийРассмотрим методы для изменения элементов управления карты.
рассмотрим методы для работа с элементами управления на примере zoomControl
// ...
// код работы с элементами управления Яндекс.Карты
// ...
// включаем элемент управления zoomControl
myMap.controls.add("элемент управления");
т.е.
myMap.controls.add("zoomControl");
// отключение элемент управления карты
myMap.controls.remove("zoomControl");