Документация для разработчиков

Яндекс: настраиваемая карта

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

В визуальном редакторе компонент расположен по пути: Контент > Яндекс.Карты > Яндекс.Карты: настраиваемая карта.

Компонент относится к модулю Управление структурой.

Примечание. Компонент работает на API 2.0 Яндекса, использование протокола https необязательно.

Пример вызова компонента map.yandex.view

Секции настроек компонента:

  • Основные параметры
  • Дополнительные настройки
  • Описание параметров

    Поле Параметр Описание
    Основные параметры
    Стартовый тип карты INIT_MAP_TYPE Указывается вид карты, который будет использоваться по умолчанию:
    • схема (MAP) - схематичная карта с именами улиц и объектов;
    • спутник (SATELLITE) - карта в виде фото со спутника;
    • гибрид (HYBRID) - карта в виде фото со спутника с наложенной на нее схемой основных дорог и объектов.
    • народная карта (PUBLIC) - карта, составляемая пользователями Яндекса.
    • народный гибрид (PUBLIC_HYBRID) - карта в виде фото со спутника с наложенной на нее народной картой.
    Данные выводимые на карте MAP_DATA По нажатию кнопки Изменить откроется окно Настройки карты, предназначенное для редактирования настроек карты:

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

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

    Для создания линии на карте необходимо воспользоваться ссылкой "Добавить линию". Двойным кликом на начальной точке линии начните процесс создания маршрута. Одиночными кликами проложите маршрут по карте. Завершите создание линии двойным кликом на последней точке. Появится диалог настроек линии. Введите название линии, выберите цвет, толщину линии и процент прозрачности. Закройте диалог и завершите создание линии с помощью ссылки Закончить добавление линий. Созданная линия появится в списке линий.
    Для редактирования параметров (саму линию отредактировать нельзя) нажмите на названии линии, появится диалог для редактирования параметров.
    Для удаления линии нужно навести указатель мыши на удаляемую запись и нажать на крестик, появившийся рядом с ней.

    Для сохранения внесенных изменений нужно воспользоваться кнопкой Сохранить.
    Ширина карты MAP_WIDTH Указывается ширина окна отображаемой карты в пикселях (px) или в процентах (%). Если параметр принимает значение AUTO, то ширина окна задается браузером, который будет растягивать его на все доступное место.
    Высота карты MAP_HEIGHT Указывается высота окна отображаемой карты в пикселях (px) или в процентах (%).
    Дополнительные настройки
    Элементы управления CONTROLS Указываются необходимые элементы управления, которые будут отображены на карте:
    • Панель инструментов (TOOLBAR) - кнопки Переместить карту, Увеличить и Измерить расстояние на карте;
    • Ползунок масштаба (ZOOM) - ползунок масштаба для управления масштабированием карты;
    • Кнопки масштаба (SMALLZOOM) - кнопки Увеличить масштаб и Уменьшить масштаб для управления масштабированием;
    • Мини-карта (MINIMAP) - включает отображение схематичной карты с крупным масштабом в левом нижнем углу карты;
    • Тип карты (TYPECONTROL) - кнопки Схема, Спутник или Гибрид для переключения стартового типа карты;
    • Шкала масштаба (SCALELINE) - в правом нижнем углу будет отображена шкала масштаба, показывающая масштаб относительно 1 см карты.
    • Поиск по карте (SEARCH) - поле и кнопка для поиска по карте.
    Настройки OPTIONS Задаются настройки для управление картой с помощью клавиатуры и мыши:
    • изменение масштаба колесом мыши (ENABLE_SCROLL_ZOOM) - позволяет изменять масштаб вращением колеса мыши;
    • изменение масштаба двойным щелчком мыши (ENABLE_DBLCLICK_ZOOM) - позволяет изменять масштаб карты двойным кликом мыши: левая кнопка - увеличение, правая кнопка - уменьшение;
    • изменение масштаба правой кнопкой мыши (ENABLE_RIGHT_MAGNIFIER) - позволяет с помощью щелчка правой кнопки мыши выделить и увеличить нужную область карты;
    • перетаскивание карты (ENABLE_DRAGGING) - позволяет перетаскивать карту указателем мыши;
    Идентификатор карты MAP_ID Указывается идентификатор карты. Задается произвольный код из цифр и букв латинского алфавита, который можно использовать при создании собственных клиентских сценариев.


    Пользовательские комментарии

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

    Для этого нужно всего лишь авторизоваться на сайте

    Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

    Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
    1
    Роберт Басыров
    Если нужно вывести список нескольких точек и отметить их все на одной карте, то параметр MAP_DATA лучше задать не явно, как в примере, а массивом:
    Код
    "MAP_DATA" => "a:4:{s:10:\"yandex_lat\";d:55.7813623073;s:10:\"yandex_lon\";d:37.7053618883;s:12:\"yandex_scale\";i:13;s:10:\"PLACEMARKS\";a:1{i:0;a:3:{s:4:\"TEXT\";s:19:\"Наша компания здесь\";s:3:\"LON\";d:37.71669246850075;s:3:\"LAT\";d:55.780299175292015;}}}",\"POLYLINES\";a:1:{i:0;a:3:{s:6:\"POINTS\";a:5:{i:0;a:2:{s:3:\"LAT\";d:55.7754792781;s:3: 

    Особенность. При задании точек массивом они не будут отображаться в визуальном редакторе.
    © «Битрикс», 2001-2019, «1С-Битрикс», 2019
    Наверх