Описание map.yandex.search
Одностраничный компонент осуществляет отображение карты с сервиса Яндекс.Карты и предоставляет возможность поиска по адресу. Поддержка детального поиска (по улице и дому) осуществляется в соответствии с возможностями сервиса Яндекс.Карты. Компонент является стандартным и входит в дистрибутив модуля.
В визуальном редакторе компонент расположен по пути: Контент > Яндекс.Карты > Яндекс.Карты: поиск по адресу.
Компонент относится к модулю Управление структурой.
Параметры
| Поле |
Параметр |
Описание |
| Основные параметры |
|---|
| Стартовый тип карты |
INIT_MAP_TYPE |
Указывается вид карты, который будет использоваться по умолчанию:
- схема (MAP) - схематичная карта с именами улиц и объектов;
- спутник (SATELLITE) - карта в виде фото со спутника;
- гибрид (HYBRID) - карта в виде фото со спутника с наложенной на нее схемой основных дорог и объектов.
- народная карта (PUBLIC) - карта, составляемая пользователями Яндекса.
- народный гибрид (PUBLIC_HYBRID) - карта в виде фото со спутника с наложенной на нее народной картой.
|
| Ширина карты |
MAP_WIDTH |
Указывается ширина окна отображаемой карты в пикселях (px) или в процентах (%). Если параметр принмает значение AUTO, то ширина окна задается браузером, который будет растягивать его на все доступное место. |
| Высота карты |
MAP_HEIGHT |
Указывается высота окна отображаемой карты в пикселях (px) или в процентах (%). |
| Начальная позиция карты |
MAP_DATA |
По нажатию кнопки Изменить откроется окно Настройки карты, предназначенное для редактирования настроек карты:
Для поиска необходимого объекта/местоположения нужно использовать строку Найти на карте.
Для смены стартовой позиции необходимо снять опцию зафиксировать, с помощью штатных инструментов масштабирования задать новое стартовое положение. После этого нужно вновь отметить опцию зафиксировать.
Для сохранения внесенных изменений нужно воспользоватся кнопкой Сохранить.
|
| Дополнительные настройки |
|---|
| Элементы управления |
CONTROLS |
Указываются необходимые элементы управления, которые будут отображены на карте:
- Панель инструментов (TOOLBAR) - кнопки Переместить карту, Увеличить и Измерить расстояние на карте;
- Ползунок масштаба (ZOOM) - ползунок масштаба для управления масштабированием карты;
- Кнопки масштаба (SMALLZOOM) - кнопки Увеличить масштаб и Уменьшить масштаб для управления масштабированием;
- Мини-карта (MINIMAP) - включает отображение схематичной карты с крупным масштабом в левом нижнем углу карты;
- Тип карты (TYPECONTROL) - кнопки Схема, Спутник или Гибрид для переключения стартового типа карты;
- Шкала масштаба (SCALELINE) - в правом нижнем углу будет отображена шкала масштаба, показывающая масштаб относительно 1 см карты.
- Поиск по карте (SEARCH) - поле и кнопка для поиска по карте.
|
| Настройки |
OPTIONS |
Задаются настройки для управление картой с помощью клавиатуры и мыши:
- изменение масштаба колесом мыши (ENABLE_SCROLL_ZOOM) - позволяет изменять масштаб вращением колеса мыши;
- изменение масштаба двойным щелчком мыши (ENABLE_DBLCLICK_ZOOM) - позволяет изменять масштаб карты двойным кликом мыши: левая кнопка - увеличение, правая кнопка - уменьшение;
- изменение масштаба правой кнопкой мыши (ENABLE_RIGHT_MAGNIFIER) - позволяет с помощью щелчка правой кнопки мыши выделить и увеличить нужную область карты;
- перетаскивание карты (ENABLE_DRAGGING) - позволяет перетаскивать карту указателем мыши;
|
| Идентификатор карты |
MAP_ID |
Указывается идентификатор карты. Задается произвольный код из цифр и букв латинского алфавита, который можно использовать при создании собственных клиентских сценариев. |
Пример вызова
<?$APPLICATION->IncludeComponent("bitrix:map.yandex.search",".default",array(
"INIT_MAP_TYPE" => "MAP",
"MAP_WIDTH" => "auto",
"MAP_HEIGHT" => "500",
"MAP_DATA" => "a:3:{s:10:
\"yandex_lat\";d:54.704461192577305;s:10:
\"yandex_lon\";d:20.51420630589147;s:12:
\"yandex_scale\";i:13;}",
"CONTROLS" => array(
"TOOLBAR",
"ZOOM",
"MINIMAP",
"TYPECONTROL",
"SCALELINE"
),
"OPTIONS" => array(
"ENABLE_DBLCLICK_ZOOM",
"ENABLE_DRAGGING"
),
"MAP_ID" => "searchmap"
)
);
?>