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