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

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


Описание map.google.view

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

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

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



Параметры

Поле Параметр Описание
Основные параметры
Ключ JavaScript API API_KEY Ключ можно получить по ссылке https://developers.google.com/maps/documentation/javascript/get-api-key.
Стартовый тип карты 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 Указывается идентификатор карты. Задается произвольный код из цифр и букв латинского алфавита, который можно использовать при создании собственных клиентских сценариев.


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

 <?$APPLICATION->IncludeComponent("bitrix:map.google.view","",Array(
		"API_KEY" => "",
		"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"
	)
);?> 


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
5
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-2024, «1С-Битрикс», 2024
Наверх