Встроенные элементы управления

Для взаимодействия с картой API предоставляет ряд встроенных элементов управления, некоторые из этих элементов включены по умолчанию.

К встроенным элементам управления относятся:

• Перемещение
• Масштабирование двойным щелчком мыши
• Масштабирование колесиком мыши
• Лупа
• Горячие клавиши
• Линейка

Встроенные элементы присутствуют на карте всегда, их можно включить/выключить, используя специальные методы (см. ниже).

Перемещение

Инструмент для перетаскивания карты мышью (по умолчанию включен). С его помощью можно перетаскивать карту, удерживая нажатой левую кнопку мыши.

Чтобы выключить перетаскивание мышью вызовите метод объекта карты disableDragging(), а для того, чтобы включить - метод enableDragging().

Масштабирование двойным щелчком мыши

Возможность изменения масштаба карты по двойному щелчку мыши (по умолчанию включена).

По двойному щелчку левой кнопкой мыши масштаб увеличивается на единицу, а по двойному щелчку правой кнопкой - уменьшается на единицу.

Чтобы включить масштабирование по двойному щелчку вызовите метод enableDblClickZoom(), а чтобы отключить - метод disableDblClickZoom().

Масштабирование колесиком мыши

Возможность изменения масштаба карты с помощью колесика мыши (по умолчанию выключена).

Следует применять ScrollZoom с осторожностью, так как колесико мыши часто используется для прокрутки страниц в браузере. Если при прокрутке страницы колесиком мыши курсор случайно попадет на карту, то карта может начать неожиданно (для пользователя) масштабироваться.

Чтобы включить масштабирование колесиком мыши вызовите метод enableScrollZoom(), а чтобы отключить - метод disableScrollZoom().

Лупа

Инструмент для увеличения масштаба выделенного участка карты (по умолчанию выключен). Позволяет приблизить участок карты, выделенный кнопкой мыши.

Чтобы активировать инструмент для левой кнопки мыши, вызовите метод enableMagnifier(), а чтобы отключить - метод disableMagnifier().

Чтобы активировать инструмент для правой кнопки мыши, вызовите метод enableRightButtonMagnifier(), а чтобы отключить - метод disableRightButtonMagnifier().

Чтобы снять выделение с участка карты пользователю требуется нажать клавишу "Esc".

Горячие клавиши

Механизм горячих клавиш (по умолчанию выключен).

На карте поддерживаются следующие горячие клавиши:

• клавиши "+" и "-" - увеличение и уменьшение масштаба, соответственно;
• клавиши направления ("стрелки") - перемещение карты.

Чтобы включить горячие клавиши вызовите метод enableHotKeys(), чтобы выключить - метод disableHotKeys().

Линейка

Инструмент для измерения расстояний на карте (по умолчанию выключен).

Позволяет с помощью мыши проложить на карте маршрут и узнать его протяженность. Маршрут указывается специальными круглыми метками, последовательно соединенными красной линией.

При наведении курсора на метку отображается всплывающая подсказка, указывающая расстояние между меткой и начальной точкой маршрута.

Расстояние расчитывается с помощью метода distance() и приводится к удобочитаемому виду с помощью метода YMaps.humanDistance().

Метки можно перетаскивать, при этом расстояние от начальной точки автоматически пересчитывается.

При двойном щелчке на метке или на всплывающей подсказке метки, метка удаляется без предупреждения.

Последняя метка маршрута имеет две особенности:

• всплывающая подсказка со значением расстояния отображается всегда;
• имеется кнопка для удаления всех меток (при удалении выводится предупреждение, если количество меток больше двух).

Чтобы включить "линейку" вызовите метод enableRuler(), а чтобы выключить - метод disableRuler().

Чтобы получить строку данных о точках маршрута, вызовите метод getRulerState(). Чтобы восстановить маршрут из строки данных, вызовите метод setRulerState().