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

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
Наверх