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

Google: поиск по адресу


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

Одностраничный компонент осуществляет отображение карты с сервиса Google Maps и предоставляет возможность поиска по адресу. Поддержка детального поиска (по улице и дому) осуществляется в соответствии с возможностями сервиса 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) - позволяет перетаскивать карту указателем мыши.
Идентификатор карты MAP_ID Указывается идентификатор карты. Задается произвольный код из цифр и букв латинского алфавита, который можно использовать при создании собственных клиентских сценариев.


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

<?$APPLICATION->IncludeComponent("bitrix:map.google.search",".default",Array(
		"INIT_MAP_TYPE" => "HYBRID",
		"MAP_DATA" => "a:3:{s:10:
			\"google_lat\";d:55.7383;s:10:
			\"google_lon\";d:37.5946;s:12:
			\"google_scale\";i:13;}",
		"MAP_WIDTH" => "600",
		"MAP_HEIGHT" => "500",
		"CONTROLS" => array(
			2=>"SMALL_ZOOM_CONTROL",
			4=>"TYPECONTROL",
			6=>"SCALELINE",
		),
		"OPTIONS" => array(
			0=>"ENABLE_SCROLL_ZOOM",
			1=>"ENABLE_DBLCLICK_ZOOM",
			3=>"ENABLE_DRAGGING",
		),
		"MAP_ID" => ""
	)
);?>


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