Описание map.yandex.system
Одностраничный компонент осуществляет отображение карты с сервиса Яндекс.Карты. Компонент является стандартным и входит в дистрибутив модуля.
Компонент относится к модулю Управление структурой.
Параметры
| Поле |
Параметр |
Описание |
| Основные параметры |
|---|
| Ключ доступа |
KEY |
Указывается ключ доступа, который получается у компании Яндекс. Без ключа карта работать не будет. |
| Стартовый тип карты |
INIT_MAP_TYPE |
Указывается вид карты, который будет использоваться по умолчанию:
- схема (MAP) - схематичная карта с именами улиц и объектов;
- спутник (SATELLITE) - карта в виде фото со спутника;
- гибрид (HYBRID) - карта в виде фото со спутника с наложенной на нее схемой основных дорог и объектов.
|
| Ширина карты |
MAP_WIDTH |
Указывается ширина окна отображаемой карты в пикселях (px) или в процентах (%). Если параметр принмает значение AUTO, то ширина окна задается браузером, который будет растягивать его на все доступное место. |
| Высота карты |
MAP_HEIGHT |
Указывается высота окна отображаемой карты в пикселях (px) или в процентах (%). |
| Дополнительные настройки |
|---|
| Элементы управления |
CONTROLS |
Указываются необходимые элементы управления, которые будут отображены на карте:
- Панель инструментов (TOOLBAR) - кнопки Переместить карту, Увеличить и Измерить расстояние на карте;
- Ползунок масштаба (ZOOM) - ползунок масштаба для управления масштабированием карты;
- Кнопки масштаба (SMALLZOOM) - кнопки Увеличить масштаб и Уменьшить масштаб для управления масштабированием;
- Мини-карта (MINIMAP) - включает отображение схематичной карты с крупным масштабом в левом нижнем углу карты;
- Тип карты (TYPECONTROL) - кнопки Схема, Спутник или Гибрид для переключения стартового типа карты;
- Шкала масштаба (SCALELINE) - в правом нижнем углу будет отображена шкала масштаба, показывающая масштаб относительно 1 см карты.
|
| Настройки |
OPTIONS |
Задаются настройки для управление картой с помощью клавиатуры и мыши:
- изменение масштаба колесом мыши (ENABLE_SCROLL_ZOOM) - позволяет изменять масштаб вращением колеса мыши;
- изменение масштаба двойным щелчком мыши (ENABLE_DBLCLICK_ZOOM) - позволяет изменять масштаб карты двойным кликом мыши: левая кнопка - увеличение, правая кнопка - уменьшение;
- перетаскивание карты (ENABLE_DRAGGING) - позволяет перетаскивать карту указателем мыши;
- горячие клавиши (ENABLE_HOTKEYS) - позволяет управлять масштабом карты с помощью горячих клавиш.
|
| Идентификатор карты |
MAP_ID |
Указывается идентификатор карты. Задается произвольный код из цифр и букв латинского алфавита, который можно использовать при создании собственных клиентских сценариев. |
Пример вызова
<?$APPLICATION->IncludeComponent("bitrix:map.yandex.system", ".default", array(
"KEY" => "",
"INIT_MAP_TYPE" => "SATELLITE",
"MAP_WIDTH" => "800",
"MAP_HEIGHT" => "500",
"CONTROLS" => array(
0 => "TOOLBAR",
1 => "ZOOM",
2 => "MINIMAP",
3 => "TYPECONTROL",
4 => "SCALELINE",
),
"OPTIONS" => array(
0 => "ENABLE_SCROLL_ZOOM",
1 => "ENABLE_DBLCLICK_ZOOM",
2 => "ENABLE_DRAGGING",
3 => "ENABLE_HOTKEYS",
),
"MAP_ID" => "testmap"
)
);
?>
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.