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