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

Яндекс: поиск по адресу


Описание 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"
	)
);
?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024