Zh OpenStreetMap Description/ru

Установка

Компонент устанавливается на Joomla! 3.x стандартным способом установки через Extension Manager.

Компонент поддерживает функцию автообновления

Параметры

Настройку производить не надо, т.к. компонент работает на Google Maps JavaScript API V3.

Существует ряд параметров, которые можно настроить на уровне компонента.

Переходим на страницу компонента

Выбираем (меню):

• Components
• Zh GoogleMap

Нажимаем кнопку "Options"

При создании новых картографических объектов при открытии карты автоматически вычисляется местоположение, если вычислить не удается, то выводится центр Дворцовой площади Санкт-Петербурга (если не установлено место по умолчанию).

Место по умолчанию

Вы можете установить широту и долготу для места по умолчанию на Странице параметров

После чего, когда Вы создаете новую карту, метку, путь через административную панель, местоположение метки на карте будет установлено по умолчанию.

Ключ для Google Earth API

Если Вы хотите использовать функциональность Google Earth, то необходимо получить ключ для Google Earth API и ввести его в параметры.

Не смотря на то, что использовать Earth API можно без ключа, на текущий момент вы должны его указывать, т.к. я пока не смог добиться работы Maps и Earth API вместе и без ключа. Когда я смогу - я исправлю код и вы будете иметь возможность использовать Earth API без ключа API

Ключ для Google Maps API

Если вы хотите использовать ключ Google Maps API для мониторинга или оплаты пользования сверх установленных лимитов, вы можете получить ключ для Google Maps API и ввести его на Странице параметров (аналогично ключу Google Earth API)

Режим совместимости

В некоторых случаях, когда для карты разрешено Управление метками через список групп, Вы можете получить сообщение об ошибке
link.hasClass is not a function

Это может быть связано с конфликтом JQuery и mootools в некоторых шаблонах, или бибилиотека mootools отключена в joomla
В этом случае Вы можете установить режим совместимости, при котором вызовы методов hasClass и toggleClass изменяются на вызовы JavaScript функций, реализующих похожую логику.

Режим совместимости для файлов ресурсов

В некоторых случаях вы ограничиваете доступ к папке administrator. В этой папке для компонента по умолчанию есть папка assets, которая содержит иконки, css-файлы для компонента и плагина.

Если вы блокируете доступ к ней, то при попытке пользователей увидеть карту будет выведено окно логина.

И вот для этого случая в компоненте предусмотрена опция Compatible Mode for Resource Files.

Просто установите значение в ДА, и все ссылки в документе, который содержит карту (вызванную как через компонент, так и через плагин), будут на папку site assets. Не перемещайте файлы и папки, просто используйте их.

И вы должны скопировать иконки из administrator папки (/administrator/components/com_zhgooglemap/assets/icons) в site папку (/components/com_zhgooglemap/assets/icons), т.к. изначально она пустая (потому что если site папка будет содержать иконки, то размер расширения увеличится в два раза)

Если вы хотите использовать свои иконки для меток, вам следует их скопировать в обе папки. В папке administrator иконки будут использоваться в backend (административная панель), для отображения - из папки site.

Протокол

Вы можете установить протокол для загрузки карты

Тип инициализации карты

В некоторых случаях ваш шаблон или другие расширения могут использовать onload функцию. И в таком случае карта не будет инициализирована (выведена), поэтому надо использовать тип domready.

Версия Google Maps API

По умолчанию (пустое значение) используется последняя экспериментальная версия API карт.

Вы можете загрузить определенную версию API. Узнайте больше версиях Google Maps API

Тип карты в редакторе

Вы можете управлять какие типы карт будут доступны когда вы создаете объекты на карте (карту, метки...) и в подробностях отображается карта.

Список категорий

Вы можете определить тип списка категорий, которые будет доступен в подробностях Simple (плоский) или Default (иерархический)

HTML тег для заголовка всплывающего информационного окна

МОжно определить h2 (h3...) тег для всплывающего инфомрационного окна, например, для метки.

powered by

Вы можете определить место вывода моего логотипа, или скрыть его

Создание карты

Переходим на закладку "Maps".

Вводим необходимое количество карт с нужной нам конфигурацией.

Координаты удобно выбирать путем перетаскивания метки (значения автоматически подставляются в поля формы) или кликая мышкой на необходимом месте.

Свойства карты

Title	Наименование карты
Description	Примечание
Latitude	Широта центра карты
Longitude	Долгота центра карты

Подробности карты

Show Title as Placemark	Выводить наименование карты как метку No - Не выводить метку Drop - Метка с анимацией (Падающая) Bounce - Метка с анимацией (Прыгающая) Simple - Метка без анимации
Open InfoWin	Сразу открыть всплывающее окно
Disable AutoPan	Отключить автоматическое изменение центра карты при выводе информационного окна
Width	Ширина карты, если ввести 0, то карта откроется на всю доступную ширину области (100%)
Height	Высота карты если ввести 0, то карта откроется на всю доступную высоту области (100%). Если вы определите Zh Template Map FullScreen для вашей страницы с картой,то карта откроется в полноэкранном режиме. Или вы можете использовтаь данное свойство в других целях
Map Bounds	Границы карты, обеспечивают ограничение навигации только в пределах заданной области Значения вводятся по следующему формату Latitude1,Longitude1;Latitude2,Longitude2 т.е. пара координат разделена точкой с запятой, сами же координаты разделены запятой Первая координата - левый нижний угол, вторая - правый верхний
Zoom	Начальный Масштаб карты
Min Zoom	Минимальный масштаб карты
Max Zoom	Максимальный масштаб карты
Draggable	Разрешает/запрещает перемещение карты
Map Type	Начальный Тип карты Roadmap Satellite Hybrid Terrain OpenStreetMap NZTopomaps First Custom Map Type
Google Earth	Разрешить переход на Google Планета Земля No Yes Yes (Notify)
OpenStreetMap Layer	Разрешить отображать слой 'OpenStreetMap' и возможность перехода на него с помощью переключения типа карт
NZTopomaps Layer	Разрешить отображать слой 'NZTopomaps' и возможность перехода на него с помощью переключения типа карт
Allow Custom Map Types	Разрешить использование пользовательских типов карт и возможность переключения типа карт
Custom Map Types List	Список идентификаторов пользовательских типов карт, разделитель; Например: 1;2;5 Если вы установите Map Type в First Custom Map Type, то первый идентификатор будет типом карты по умолчанию
Weather Layer	Слой погоды, для вывода на карте
KML Layer	URL адрес слоя KML, для вывода на карте
Language	Язык, на котором отображаются наименования объектов на карте Например: ru-RU
Show placemark creation information	Выводить информацию о создании метки. Вы можете вывести информацию о пользователе и дате создания метки No Username Date of creation Date of creation and Username Username (after toolbar) Date of creation (after toolbar) Date of creation and Username (after toolbar)
Category	Категория, к которой относится карта

Использование Google Планета Земля

Переходим к опциям компонента.

Вводим полученный ключ Google Earth API.

На закладке "Map" для необходимой карты выбираем использование Google Earth

• "Yes" - карта отображается, но если на компьютере не установлен плагин Google Earth Plugin, то функциональность не доступна
• "Yes (Notify)" - карта отображается, но если на компьютере не установлен плагин Google Earth Plugin, то функциональность не доступна и выводится сообщение об отсутствии плагина

Использование KML файлов

Если имеется KML-файл, вы можете расположить его в доступной папке на сайте и указать адрес в поле KML Layer.

Если же вы хотите использовать более одного файла, вы можете воспользоваться "featute", а именно поле путь (path) на закладке пути(Paths) необязательное.

• переходим на закладку Paths
• создаем путь
• указываем поле KML Layer

И после этого новый файл будет выведен

Верхний колонтитул карты

Header HTML-text	HTML текст над картой
Show Header Separator	Отображать верхний разделитель

Нижний колонтитул карты

Show Footer Separator	Отображать нижний разделитель
Footer HTML-text	HTML текст под картой

Стили

Styles

Стили для карты См. о стилях Start Styling your Map Конструктор стилей Google Maps API Styled Map Wizard Просто нажмите кнопку Finish, скопируйте код между [ и ] включая их, и поместите в это поле

Элементы управления картой

Существует 3 секции в данном разделе

Первая секция

Map Type Control	Элемент управления переключением типа карты
Pan Control	Элемент управления перемещением
Zoom Control	Вывод элемента управления масштабом
Scale Control	Вывод шкалы масштабирования
Overview Map Control	Вывод обзорной карты Yes No Yes (Open) - открыть обзорную карту
Double Click Zoom	Возможность масштабирования по двойному щелчку мыши
Scroll Wheel Zoom	Возможность масштабирования колёсиком мыши
Rotate Control	Вывод элемента управления поворотом
Street View Control	Вывод элемента управления обзором улиц
Traffic Layer	Вывод слоя 'Пробки'
Bicycle Layer	Вывод слоя 'Велосипед'
Home Button	Возможность возврата к первоначальному центру карты и/или масштабу

Вторая секция

]

Find Control (geocoding)	Вывод элемента управления поиск через геокодирование
Find Control width	Ширина поля ввода адреса для поиска
Draw route from search point to place	Разрешить построение маршрута от найденного адреса до места
Изменить масштаб для результата	Вы можете изменить масштаб при получении результата поиска
Search region	Region Localization: если Вы хотите изменить местоположение для его использования геокодером и указать конкретный регион. The value is Unicode region subtag identifiers. Most Unicode region identifiers are identical to ISO 3166-1 codes, with some notable exceptions. E.g., US, ES. But as for example for Great Britain is GB, not UK

Третья секция

Map Type Control	Расположение элемента на карте
Pan Control	Расположение элемента на карте
Zoom Control	Расположение элемента на карте
Scale Control	Расположение элемента на карте
Street View Control	Расположение элемента на карте
Find Control (geocoding)	Расположение элемента на карте
Geolocation Control	Расположение элемента на карте
Placemark List Button	Расположение элемента на карте
Traffic Layer Button	Расположение элемента на карте
Transit Layer Button	Расположение элемента на карте
Bicycle Layer Button	Расположение элемента на карте
Home Button	Расположение элемента на карте

Свойства карты для меток

Placemark ordering	Сортировка меток, это удобно при выводе их в списке меток Placemark title Category title and ordering Category title (descending) and ordering User ordering index Group title and Placemark title Group title (descending) and Placemark title Group user ordering index and Placemark title Group user ordering index (descending) and Placemark title Date of creation Date of creation (descending)
Show placemarks in cluster	Создавать кластер для маркеров
Marker Cluster Zoom Level	Масштаб, с которого начинается кластеризация (метки начинают группироваться)
Group Placemarks in Cluster by Group Property	Создавать кластер для каждой группы маркеров (также можно изменить иконку на кластере) Необходимо помнить, что если используется данная функциональность (без использования управления метками через группу), то у группы должен быть указан признак активности в кластере (признак Active in Group List)
Place overlapping placemarks on a spiral	Включить опцию вывода перекрывающихся меток на спирали
Show placemark hover text	Включить опцию вывода всплывающего окна (InfoWin/InfoBubble) при наведении на метку No Open InfoWin Open InfoBubble
InfoBubble Style	Если вы используете Open InfoBubble для опции Show placemark hover text вы можете определить стиль для InfoBubble

Свойства карты для Списка Меток

Width	Ширина списка меток в px Если установить в 0 то вы получите 100% ширины. Это удобно, если список расположен под картой, и при этом карта занимакет 100% ширины контейнера
Height	Высота списка меток в px
Position	Местоположение, допустимые значения No - список не выводится ... - слой над картой Left и Right - табличный вид List-Map и Map-List - div-вид External - вы можете расположить тег ul с id=GMapsMarkerUL в любое место для указания места вывода списка меток в указанное место Например, <ul id="GMapsMarkerUL" style="list-style-type: none;"></ul>
Style	Стиль, допустимые значения Simple - предопределен в CSS-файле Advanced - предопределен в CSS-файле External - вы можете определить его в вашем шаблоне
Background Color	Цвет фона Например: #EAEAEA Что касается градиента в моем примере, я нашел его на сайтах. Когда вы указываете цвет фона #E6E6E6, в стили я добавляю следующий фрагмент background: #E6E6E6 Я взял вот этот пример background: #fefcea; /* For old browsers */ background: -moz-linear-gradient(top, #fefcea, #f1da36); /* Firefox 3.6+ */ /* Chrome 1-9, Safari 4-5 */ background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#fefcea), color-stop(100%,#f1da36)); /* Chrome 10+, Safari 5.1+ */ background: -webkit-linear-gradient(top, #fefcea, #f1da36); background: -o-linear-gradient(top, #fefcea, #f1da36); /* Opera 11.10+ */ background: -ms-linear-gradient(top, #fefcea, #f1da36); /* IE10 */ background: linear-gradient(top, #fefcea, #f1da36); /* CSS3 */ padding: 10px; border: 1px solid #333; Я не знаю, правильный ли он, и на все ли случаи жизни он подойдет. Но, для примера, почему бы и нет. Я изменил начальный и конечный цвета на свои. И первый background: мы не должны вводить, так как я его сам создаю. После всех переделок мой код получился следующий #E6E6E6; /* For old browsers */ background: -moz-linear-gradient(top, #E6E6E6, #AAAAAA); /* Firefox 3.6+ */ /* Chrome 1-9, Safari 4-5 */ background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#E6E6E6), color-stop(100%,#AAAAAA)); /* Chrome 10+, Safari 5.1+ */ background: -webkit-linear-gradient(top, #E6E6E6, #AAAAAA); background: -o-linear-gradient(top, #E6E6E6, #AAAAAA); /* Opera 11.10+ */ background: -ms-linear-gradient(top, #E6E6E6, #AAAAAA); /* IE10 */ background: linear-gradient(top, #E6E6E6, #AAAAAA); /* CSS3 */ padding: 10px; border: 1px solid #333; Я заметил, что в IE9 градиента нет. Но это не стояло задачей в моем компоненте сделать это через CSS. В любом случае вы можете сделать это через изображение и класс.
Action by Click	Действие при клике на ссылке Center - центрировать карту на метке Click - выполнить клик на метке Center, Animate - центрировать карту на метке и анимировать иконку метки Click, Animate - выполнить клик на метке и анимировать иконку метки Center, Animate and Click - центрировать карту на метке, анимировать иконку метки и выполнить клик на метке
Placemark List Content	Текст. который содержится в списке меток Title - наименование метки Title and Description - наименование метки и примечание Title and Addition HTML text - наименование метки и дополнительный HTML текст Icon and Title - иконка метки и наименование Icon, Title and Description Icon, Title and Addition HTML text - иконка метки, наименование и дополнительный HTML текст Icon, Title and Description (table) - табличный вид Icon, Title and Addition HTML text (table) - табличный вид Title and Image - наименование метки и изображение (миниатюра) Title, Image and Description Title, Image and Addition HTML text Image and Title Image, Title and Description Image, Title and Addition HTML text Image, Title and Description (table) - табличный вид Image, Title and Addition HTML text (table) - табличный вид Table: Title - наименование метки и табличный вид Table: Title and Description - наименование метки и примечание и табличный вид Table: Title and Addition HTML text - наименование метки и дополниткльный HTML текст и табличный вид
Appearance	Внешний вид списка меток Open List - Список меток сразу открыт Icon Button - дополнительная кнопка (иконка) на карте Text Button - дополнительная кнопка (текст) на карте Icon Button and Open List - дополнительная кнопка (иконка) на карте и список меток сразу открыт Text Button and Open List - дополнительная кнопка (текст) на карте и список меток сразу открыт
Search placemark field	Дополнительная опция поиска меток в списке с автодополнением

Группы

Placemark Group Control	Расположение и тип списка групп, который будет отображен для управления маркерами No - управление через список групп отключено Left - Список групп слева (табличный стиль) Right - Список групп справа (табличный стиль) Top - Список групп наверху (табличный стиль) Bottom - Список групп внизу (табличный стиль) Group-Map - Список групп наверху (div стиль) Map-Group - Список групп внизу (div стиль)
Placemark Group Type	Поведение списка групп Toggle Group Only One Active Group
Manage Placemarks	Опция разрешает управлять метками через список
Synchronize with placemark list	Выводить/скрывать метки в списке меток в зависимости от статуса группы
Manage Paths	Опция разрешает управлять путями через список групп
Group ordering	Сортировка групп в списке Group title Category Title and ordering User ordering index
Placemark Group Column Width	Ширина колонки списка групп при расположении слева или справа от карты
Show Placemark Group	Вывести текст, иконку группы в списке групп Text Icon Text and Icon
Search group field	Вывести поле поиска групп в списке групп
Display Show All and Hide All buttons	Выводить кнопки показать/скрыть все группы в один клик No Text Icon Text and Icon
Group CSS	Тип оформления группы Существует два предопределенных стиля в /administrator/components/com_zhgooglemap/assets/css/markergroups.css и один (external) – для возможности установки стилей вами в вашем шаблоне. Идентификаторы (ID) для тэгов зависят от значения поля Placemark Group CSS. Подробнее смотрите Группировка маркеров
Group List Title	Заголовок списка групп
Top Description	Примечание над списком
Show Top-Separator	Выводить разделитель над списком
Show Bottom-Separator	Выводить разделитель под списком
Bottom Description	Примечание под списком

Маршрут

Эта опция необходима если Вы используете поиск для нахождения определенного места

• с помощью поиска через геокодирование (слайдер Map Find Control (geocoding))
• с помощью поля автозаполнения (слайдер Places Library)

Draggable	Возможность изменения построенного маршрута
Show Route Panel	Возможность вывода подробностей маршрута
Address	Если вы не хотите использовать координаты центра карты как место назначения при построении маршрута (например, Google не совсем правильно переводит координаты в текстовый адрес), вы можете ввести в это поле текстовое значение адреса и он будет использован при построении маршрута Используйте значение из поля автозаполнения (скопируйте его) для более верного задания адреса для google router
Travel Mode: Driving	Возможность вывода данного типа передвижения
Travel Mode: Walking	Возможность вывода данного типа передвижения
Travel Mode: Bicycling	Возможность вывода данного типа передвижения	Unit System	Измерение расстояний
Avoid Highways	Избегать автомагистрали
Avoid Tolls	Избегать платных дорог

Использование Places Library

Enable using Places	Возможность использования Places Library
Places Types	Типы мест, указываются в одинарных кавычках, разделенных запятой например: 'restaurant', 'store' Google Places API: Поддерживаемые типы мест
Radius	Радиус от центра карты (в метрах). Если Вы не хотите видеть метки, созданные Places API, а хотите только пользоваться полем автозаполнения, укажите радиус равным 0 Places API выводит только до 20 мест!
Show Autocomplete field	Возможность использования поля автозаполнения
Places Types for Autocomplete field	Типы мест для поля автозаполнения, аналогично типам мест, указываются в одинарных кавычках, разделенных запятой значение может быть либо 'establishment' либо 'geocode', соответствующие фирмам или адресам соответственно. Если не указано ни одного, то используются оба.
Show direction	Вывести маршрут(с помощью Directions API) от места, которое вы нашли с помощью поля автозаполнения (где стоит метка) и меткой на карте (которая установлена на карте, центр карты)
Search country	Country Localization: если Вы хотите ограничить поле автодополнения только значениями какой-либо одной страны. The value is ISO 3166-1 Alpha-2 country code. E.g., US, BR, AU.

Использование Panoramio Library

Дополнительные параметры

Loading map objects dynamically	Опция позволяет динамически загружать метки с помощью AJAX No JQuery Mootools
Load type	Тип загрузки меток, т.е. загружать их всех или по каким-то критериям All All (two steps: use map bounds, all the rest) Use map bounds
Buffer size for placemarks	Вы можете загружать метки частями
Loading content data dynamically	Опция позволяет динамически загружать содержимое метки с помощью AJAX No JQuery Mootools Т.е. ваша страница содержит код создания меток, но содержимое всплывающих окон загружается динамически. Если метки загружаются с помощью AJAX, то и их содержимое загружается также динамически.
MarkerManager	Возможность использования Marker Manager Marker Manager выводит метки при определенном масштабе.
Elevation	Возможность использования Elevation API Выводить уровень местности в точке клика мышкой.
Street View	Возможность отображения панорам улиц(Street View) No Top - панорама располагается над картой Bottom - панорама располагается под картой
Street View Style	Стиль панорамы улиц Default - по умолчанию
Placemark Filter	Ограничение вывода меток на основании правил.
Allow to user enter placemarks	Разрешение создания меток зарегистрированными пользователями.
Insert Allowed	Пользователю разрешено создание меток
Update Allowed	Пользователю разрешено изменение меток
Delete Allowed	Пользователю разрешено удаление меток
New Placemark State	Статус для новой пользовательской метки.
New Contact State	Статус для нового пользовательского контакта (если включена интеграция с контактами).
Show Icon Type Selector for New Placemark	Возможность выбора иконки при создании пользовательских меток.
CSS Class	Наименование класса для div секции карты
Additional CSS styles for loading	Список файлов стилей CSS для загрузки при отображении карты, разделенных либо точкой с запятой, либо с новой строки
Additional JavaScript files for loading	Список JavaScript файлов для загрузки при отображении карты, разделенных либо точкой с запятой, либо с новой строки
Placemark Rating	Разрешает использовать систему рейтинга для меток. No JQuery Mootools
Map text override	Вы можете использовать данную функциональность для переопределения стандартного текста для элементов управления и т.п. через специальный интерфейс в компоненте в административной панели.

Автоматическое позиционирование

Auto Positioning	Автоматическое позиционирование при отображении карты
Geolocation Control	Отображение кнопки геопозиционирования
Geolocation Button Style	Стиль кнопки геопозиционирования Icon Text Icon and Text

Интеграция

Use contacts	Возможность использование контактов Вы можете разрешить использование информации из контактов, ассоциировать контакт с меткой и вывести контактную информацию во всплывающем окне.
Contact Details	Вы можете определить какие атрибуты контакта выводить. Разделителем является ; Допустимые значения name position address city suburb state province country postcode zipcode phone mobile fax email website Вы можете указывать их в том порядке, который вам нужен при выводе. Примечание: postcode и zipcode – это одно и то же поле но с разным наименованием. Посмотрите на поля контакта, и Вы увидите пары полей: City or Suburb, State or Province, Postal / ZIP Code Например: position;name;mobile выведет должность, наименование контакта и мобильный телефон
Use users	Возможность использование информации из профиля пользователя Вы можете разрешить использование информации из профиля пользователя, ассоциировать пользователя с меткой и вывести информацию во всплывающем окне.

Display

Использование Marker Manager

При использовании Marker Manager существуют ограничения:

• вы не можете использовать кластеризацию - потому что кластер группирует метки, и сам контролирует их вывод
• вы не можете использовать управление метками через список групп

Для использования Marker Manager:

• установите группу на метках
• установите Min Zoom for Marker Manager и Max Zoom for Marker Manager для каждой группы
• разрешите использование данной функциональности

Создание меток

Переходим на закладку "Placemarks".

Вводим необходимое количество меток с привязкой к конкретной карте.

Координаты удобно выбирать путем перетаскивания метки (значения автоматически подставляются в поля формы) или кликая мышкой на необходимом месте.

Также вы можете использовать поле автозаполнения над картой.

Или введите текстовый адрес в поле автозаполнения и нажмите кнопку поиска для поиска места через геокодирование.

Свойства метки

Title	Наименование метки
Description	Примечание
Tags	Теги
Latitude	Широта
Longitude	Долгота
Address	Адрес в текстовом виде. У вас есть возможность загрузить данные в это поле если у вас нет данных lat/lng. В этом случае адрес будет автоматически геокодирован и метка выведена. И в backend метка также будет отображена. Но если вы измените положение метки (измените позицию на карте путем перетаскивания или клика мышкой в другом месте), новая позиция будет сохранена в lat/lng формате. Вывод меток через lat/lng более быстрый, т.к. не требуется геокодирования.
Map Title	Наименование карты, на которой выводится метка

Подробности метки

Published	Признак публикации, т.е. активности записи
Group	Группа
Protected from user correction	Запретить редактирование метки, если вы активировали возможность ввода меток пользователями сайта
Include in Placemark List	Включить метку в список меток
Category	Категория, к которой относится метка
User ordering index	Индекс при ручной сортировки меток в списке меток
Rating	Рейтинг метки, может быть установлен только через систему рейтинга
Show GPS information	Отображать GPS информацию (координаты) в информационном окне
Addition HTML text	HTML текст, который будет включен в метку Будьте внимательны, если вы вводите email адрес, то другой плагин Joomla! его изменит, и в результате возникнет ошибка и карта не будет выведена. В этом случае вы можете скопировать код, который создался в результате работы плагина и вставить его в HTML текст, и в этом случае плагин его не поменяет.
Placemark full description	описание метки (HTML текст) в представлении подробностей метки (одиночное представление метки на странице)
Hover HTML text	Текст для всплывающего информационного окна при наведении на метку (если данная опция включена)

Внешний вид метки

Icon Type	Иконка
Icon X-offset	Смещение иконки
Icon Y-offset	Смещение иконки
Marker	Тип метки No - Метка не выводится Drop - Метка с анимацией (Падающая) Bounce - Метка с анимацией (Прыгающая) Simple - Метка без анимации Infographics Icon: Drop - Метка с анимацией (Падающая) с динамической иконкой Infographics Icon: Bounce - Метка с анимацией (Прыгающая) с динамической иконкой Infographics Icon: Simple - Метка без анимации с динамической иконкой Marker with label: Drop - Метка с анимацией (Падающая) и подписью Marker with label: Bounce - Метка с анимацией (Прыгающая) и подписью Marker with label: Simple - Метка без анимации и с подписью
Open InfoWin	Сразу выполнить действие, указанное в Action by Click и Zoom by Click
InfoWin Content	Содержимое всплывающего окна Title and Description Title Description Title and Article (by iframe) Article (by iframe) None
Action by Click	Действие при клике на метке Open InfoWin Open Link - открывает линк, определенный в поле URL Site Open Link in new page Open InfoBubble Open Street View - открыть просмотр панорам улиц для метки (если опция разрешена в свойствах карты) None
Zoom by Click	Масштаб при клике на метке Вы можете изменить масштаб при клике на метке Do not change - масштаб не изменяется
Street View in InfoWin	Возможность вывода кнопки показа Strret View во всплывающем окне
View Area Width for Street View	Ширина области показа Street View во всплывающем окне
View Area Height for Street View	Высота области показа Street View во всплывающем окне
Street View Style	Дополнительные свойства Street View. Их можно создать на отдельной закладке компонента
URL Site	URL адрес сайта
Site Name	Наименование сайта, которое будет отображаться вместо URL адреса
URL Image	URL адрес изображения для отображения в метке
URL Image Thumbnail	URL адрес изображения для отображения в списке меток
Start Publishing	Дата начала публикации метки
Finish Publishing	Дата окончания публикации метки
Date of creation	Дата создания метки
Access	ACL уровень доступа к метки
Infographics Type	Тип динамической иконки Например: chst=d_fnote&chld=thought|1|0088FF|h|Why+am+I+here? Дополнительно смотрите об Infographics (Dynamic Icons)
Infographics Icon width	Ширина динамической иконки
Infographics Icon height	Высота динамической иконки

Метка с подписью

Label Class	CSS Class подписи
Label in background	Подпись на фоне
Label X-offset	Смещение подписи
Label Y-offset	Смещение подписи
Label content	HTML содержимое подписи

Закладки InfoBubble

О всплывающем информационном окне InfoBubble вы можете прочитать здесь InfoBubble example

Данная библиотека только используется в компоненте. Если она работает не так, как вы ожидаете (есть ошибки) - проверьте на странице примера, и если не работает, то вам следует обращаться на форум google maps или данной библиотеки.

Style	Стиль для InfoBubble
Add InfoWin content	Добавить InfoWin content (содержимое информационного окна) к InfoBubble No as first tab - добавить содержимое перед всеми закладками as last tab - добавить содержимое после всех закладок replace content - добавить содержимое после вместо закладок, без закладок

Title	Наименование закладки
Image	Вы можете использовать изображение для построения галереи изображений в представлении вывода одной метки
HTML Text	Текст на закладке

Интеграция

User	Пользователь, ассоциированный с меткой
Show user prompts	Тип представления пользовательской информации No Text Icon No prompts
Contact	Контакт, ассоциированный с меткой
Show contact prompts	Тип представления контактной информации No Text Icon No prompts
Contact Button in InfoWin toolbar	Вывести кнопку контакта в тулбаре информационного окна
Alternative Contact URL	Вы можете указать другую URL-ссылку на контакт (вместо стандартного вызова joomla)
Placemark details Button in InfoWin toolbar	Вывести кнопку метки в тулбаре информационного окна
Alternative Details URL	Вы можете указать другую URL-ссылку на подробностей метки (вместо стандартного вызова страницы представления одной метки)
Placemark Details for standard call	Вы можете переопределить атрибуты для вывода в подробном представлении По умолчанию подробности метки открываются без загрузки библиотеки bootstrap и ее стилей, без эскиза изображения и галереи, также без дополнительных описательных полей "Additional HTML text" и "Placemark full description". Вы можете изменить поведение по умолчанию путем передачи параметров, разделенных запятой (,) load bootstrap load bootstrap styles thumbnail image gallery addition html text full description Например, если вы введете image gallery,addition html text,full description в поле, то подробное описание метки будет также включать два дополнительных описания (краткое "Addition HTML text" и полное "Placemark full description"), а также галерею изображений.
Article	Статья, ассоциированная с меткой
Article Button in InfoWin toolbar	Вывести кнопку статьи в тулбаре информационного окна
Alternative Article URL	Вы можете указать другую URL-ссылку на статью (вместо стандартного вызова joomla)
iframe tag Article CSS	Вы можете определить стиль CSS для iframe тега (когда используете статью как содержимое всплывающего окна)

Дополнительные поля для пользовательской кастомизации

Если Вам дополнительно нужны поля, которые хотите заполнять через интерфейс, а затем их использовать в своих скриптах, то в разделе дополнительных полей для пользовательской кастомизации Вы можете определить в какое поле будет записываться нужная вам информация.

Для удобства Вы также можете изменить подпись этих полей в файле

/administrator/language/en-GB/en-GB.com_zhgooglemap.ini

lines

COM_ZHGOOGLEMAP_MAPMARKER_DETAIL_ATTRIBUTE1_LABEL 

COM_ZHGOOGLEMAP_MAPMARKER_DETAIL_ATTRIBUTE2_LABEL 

… 

COM_ZHGOOGLEMAP_MAPMARKER_DETAIL_ATTRIBUTE9_LABEL

Например, вы можете ввести некоторую информацию в эти поля.

В таблице наименование этих столбцов

attribute1

attribute2
...

attribute9

Вы можете использовать эти поля, например, для интеграции с другими системами, и т.д.

Display

Кастомизация меток

Скопируйте свои изображения меток (в формате PNG) в каталог

/administrator/components/com_zhgooglemap/assets/icons/

Компонент автоматически подхватит изображения при выборе типа метки.

Единственное требование – чтобы расширение файла было .png т.е. в нижнем регистре, т.к. наименования изображений хранятся в БД без расширения, и оно дописывается при выводе.

И не забудьте о Режиме совместимости для файлов ресурсов

Группировка меток

Метка может входить в одну из групп, для этого на метке указываете принадлежность к группе.

Если на карте установлен признак использования группировки меток (значение поля Placemark Control отлично от No), то начинает работать дополнительная функциональность: появляется список активных групп (местоположение определяется этим же полем, причем первые четыре (left, top, right, bottom) соответствуют табличной форме представления, а два последний (Group-Map, Map-Group) – строится на div, и у Вас есть возможность делать с ними что угодно.

На карте также есть выпадающий список Placemark Group CSS – который реализует следующую функциональность:

• первые два стиля – предопределенные, и находятся в файле в папке
• третий – Вы его можете переопределить в своем css-файле шаблона
• при этом в этих трех случаях просто имеем три разных названия объектов, соответственно, можно изменять стили как вздумается.

Наименования следующие

для div-тега идентификатор принимает значения

• GMapsMenu-advanced
• GMapsMenu-simple
• GMapsMenu-external

для ul-тега

• zhgm-menu-advanced
• zhgm-menu-simple
• zhgm-menu-external

Соответственно, стили прописываем для них.

Поле Show Placemark Group Icon на закладке "Maps" используется для отображения иконки группы в списке групп.

Создание групп

Переходим на закладку "Placemark Groups".

Вводим необходимое количество групп.

Свойства группы

Title	Наименование группы
Description	Примечание
Published	Признак публикации, т.е. активности записи
Icon Type	Иконка группы (можно использовать свои, т.к. механизм тот же)
Icon X-offset	Смещение иконки
Icon Y-offset	Смещение иконки
Override Placemark Icon	Изменить иконку метки на иконку группы
Override Cluster Icon	Изменить иконку на кластере, если создается кластер для каждой группы
Active in Placemark Group List	Установка группы в активное состояние (выводятся маркеры) когда выводится страница. Параметр имеет двойное назначение: вывод маркеров при создании кластеров для каждой группы, либо вывод маркеров при управлении через группу и установка данной группы активной в списке
Min Zoom for Marker Manager	Масштаб, начиная с которого метки будут выводиться Marker Manager
Max Zoom for Marker Manager	Масштаб, после которого метки перестанут выводиться Marker Manager
Category	Категория, к которой относится группа
User ordering index	Данное поле можно использовать для ручной сортировки групп в списке групп

Display

Создание маршрутов

Под маршрутом понимается автоматическая прокладка маршрута между ключевыми точками (данная функциональность присутствует в API как Directions API).

Переходим на закладку "Routes".

Вводим необходимое количество маршрутов с привязкой к конкретной карте.

Поле Route - маршрут, вводится каждая точка маршрута в двойных кавычках ("), разделителем между точками является точка с запятой (;)

Свойства маршрута

Title	Наименование маршрута
Description	Примечание
Addition HTML text	Дополнительный текст в формате HTML
Published	Признак публикации, т.е. активности записи
Travel Mode	Способ передвижения
Unit System	Измерение расстояний
Route	Маршрут - значения промежуточных точек - текстовое значение адреса в двойных кавычках ("), разделение между точками - точка с запятой (;) например: "Арбатская";"Кропоткинская"; "Москва, проспект Мира 20";"Москва, Петровка 10"
Route by Placemarks	Маршрут, заданный идентификаторами меток, разделенными точкой с запятой (;) например: 1;2;4;6 Вы должны использовать метки, заданные широтой и долготой, а не текстовым значением адреса (использование геокодирования при выводе такой метки)
Provide Route Alternatives	Предоставление альтернативных маршрутов.
Avoid Highways	Избегать автомагистрали
Avoid Tolls	Избегать платных дорог
Optimize Waypoints	Оптимизировать путевые точки.
Show Type	Поведение границ карты при выводе маршрута Zoom - Производится масштабирование для отображения всего маршрута Unchange - Границы не изменяются
Draggable	Разрешить изменение пользователем маршрута
Weight	Толщина линии маршрута
Color	Цвел линии маршрута
Opacity	Прозрачность линии маршрута
Show Panel	Выводить подробности маршрута (дистанции и т.п.)
Show total distance	Выводить общую протяженность маршрута
Show description	Выводить описание и дополнительный HTML текст под картой
Suppress Markers	Подавляет вывод меток, которые создаются для начальной точки машрута, конечной и промежуточных
Map Title	Наименование карты, на которой выводится маршрут
Category	Категория, к которой относится маршрут

Display

Прокладывание пути

Под путем понимается произвольная ломаная линия.

Переходим на закладку "Paths".

Вводим необходимое количество путей с привязкой к конкретной карте.

Координаты удобно выбирать путем перетаскивания метки (значения подставляются в справочное поле формы Current coordinates, оттуда можно скопировать и добавить через разделитель в поле Path) или кликая мышкой на необходимом месте.

Поле Path - набор координат точек, координаты отделены между собой запятой (,), сами точки – через точку с запятой(;)

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

Свойства пути

Title	Наименование пути
Description	Примечание
Path	Путь например: 59.92335689062723,30.385787878185525;59.92374467628344,30.387547407299284
Object Type	Линия или область
Map Title	Наименование карты, на которой выводится путь
Category	Категория, к которой относится путь
Current coordinates	Текущие координаты метки

Подробности пути

Addition HTML text	HTML текст, который будет включен во всплывающее окно Будьте внимательны, если вы вводите email адрес, то другой плагин Joomla! его изменит, и в результате возникнет ошибка и карта не будет выведена. В этом случае вы можете скопировать код, который создался в результате работы плагина и вставить его в HTML текст, и в этом случае плагин его не поменяет.
Published	Признак публикации, т.е. активности записи
Geodesic line	Создается геодезическая линия (дуга)
Weight	Толщина линии
Color	Цвет линии например: #FF0000
Opacity	Прозрачность, дробное число от 0 до 1
Fill Color	Цвет заполнения области (прямоугольника, круга) например: #FF0000
Fill Opacity	Прозрачность области, дробное число от 0 до 1
Radius	Радиус окружности в метрах
Group	Группа, которая может быть использована при управлении метками(путями) через список групп
Category	Категория, к которой относится путь

Дополнительные параметры

InfoWin Content	Содержимое всплывающего информационного окна No Title Description Title and Description
KML Layer Show Type	Поведение границ карты для отображения слоя Zoom - изменить масштаб для полного отображения слоя Unchange - не изменять границы карты
Action by Click	Действие при клике на слое No Open InfoWin

KML Слой

KML Layer	URL адрес слоя KML, для вывода на карте
KML Layer Show Type	Поведение границ карты при выводе KML слоя Zoom - Производится масштабирование для отображения всего слоя Unchange - Границы не изменяются
Suppress InfoWin	Подавлять открытие всплывающего окна при клике на слое

Диаграммы высот

Elevation	Включает опцию рисования диаграммы высот
Diagram Width	Ширина диаграммы
Diagram Height	Высота диаграммы
Samples count	Количество значений на диаграмме
Samples count (KML)	Количество значений из KML файла (при выводе диаграммы на основании файла)
Icon Type	Вид иконки для отображения на карте текущей позиции на диаграмме
Baseline	Значение основной линии
Baseline Color	Цвет основной линии
Gridline Color	Цвет вспомогательных линий
Gridline Count	Количество вспомогательных линий
Minor Gridline Color	Цвет малых вспомогательных линий
Minor Gridline Count	Количество малых вспомогательных линий
Min Value	Минимальное значение
Max Value	Максимальное значение
Background Border Color	Цвет границы
Background Border Width	Ширина границы
Background Fill Color	Цвет заполнения фона

Display

Создание пути с помощью средства рисования

Добавлена новая возможность - инструмент рисования

На карте теперь есть дополнительные элементы управления

Вы просто рисуете ломаную линию путём кликания мышью в необходимых точках. Двойной клик останавливает рисование.

Как только вы закончили рисовать, поле Path содержит все необходимые координаты для построения пути.

Если вам надо получить координаты точки на карте, просто кликнете на ней не в режиме рисования, и поле Current coordinates будет содержать их

Google's Drawing Library не поддерживает создание ломаной линии на основании предопределенных точек, поэтому компонент не выводит инструмент рисования в случае сохранения пути, в этом случае выводится путь как редактируемая ломаная линия для более удобного использования. Вы можете изменять ее, или напрямую редактировать координаты. Чтобы удалить такую линию - очистите поле координат и сохраните изменения, в данном случае опять выведется инструмент рисования.

Создание типов карт

Создание стиля для всплывающего информационного окна

См. также

Плагин для компонента

Модуль для компонента

Language:	English  • русский