1C-Битрикс: Управление сайтом

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

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

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

Иконка компонента имеет вид: .

Пример вызова

 <?$APPLICATION->IncludeComponent("bitrix:map.google.view","",Array(
		"INIT_MAP_TYPE" => "HYBRID",
		"MAP_DATA" => "a:4:{s:10:
			\"google_lat\";d:54.7078924801;s:10:
			\"google_lon\";d:20.5828726435;s:12:
			\"google_scale\";i:16;s:10:
			\"PLACEMARKS\";a:1:{i:0;a:3:{s:4:
			\"TEXT\";s:99:
			\"ООО \"1С-Битрикс\", г. Калининград, Московский проспект, 261.\";s:3:
			\"LON\";d:20.58321596625391;s:3:
			\"LAT\";d:54.70787388449525;}}}",
		"MAP_WIDTH" => "600",
		"MAP_HEIGHT" => "500",
		"CONTROLS" => array(
			"SMALL_ZOOM_CONTROL",
			"TYPECONTROL",
			"SCALELINE"
		),
		"OPTIONS" => array(
			"ENABLE_SCROLL_ZOOM",
			"ENABLE_DBLCLICK_ZOOM",
			"ENABLE_DRAGGING",
			"ENABLE_KEYBOARD"
		),
		"MAP_ID" => "gm_1"
	)
);?> 

Описание параметров

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



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

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

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

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

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

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

Добавлять комментарии могут только зарегистрированные пользователи. Сообщения для просмотра появляются после модерации.
0
Maks Sidorenko
В случае необходимости ручного формирования данных для поля MAP_DATA это следует делать примерно так:
Код
"MAP_DATA" => serialize( 
   array( 
      'google_lat' => 54.70803636999584, 
      'google_lon' => 20.582714080810547, 
      'google_scale' => 16, 
      'PLACEMARKS' => array( 
         array( 
            'TEXT' => "ООО\"1С-Битрикс\", офис,  Московский проспект, 261.", 
            'LON' => 20.582714080810547, 
            'LAT' => 54.70803636999584 
         ), 
      ), 
   ) 
)
© «Битрикс», 2001-2014, «1C-Битрикс», 2014