Template:Zh GoogleMap Description Map/ru

From Documentation
Jump to: navigation, search

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

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


GM-Map-List.png


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

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


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

GM-Map-Detail.png


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


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

GM-Map-Detail-MapDetails-1.png

GM-Map-Detail-MapDetails-2.png

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

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

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

GM-Map-Detail-MapDecoration-Header.png

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


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

GM-Map-Detail-MapDecoration-Footer.png

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


Стили

GM-Map-Detail-MapDecoration-Styles.png

Styles Стили для карты

См. о стилях Start Styling your Map

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

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

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

GM-Map-Detail-MapControls.png


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

GM-Map-Detail-MapControls-1.png

GM-Map-Detail-MapControls-2.png


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 Возможность возврата к первоначальному центру карты и/или масштабу


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

GM-Map-Detail-MapControls-3.png]

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


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

GM-Map-Detail-MapControls-4.png


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 Расположение элемента на карте

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

GM-Map-Detail-Placemarks.png

Placemark ordering Сортировка меток, это удобно при выводе их в списке меток
  • Placemark title
  • Category title and ordering
  • Category title (descending) and ordering
  • User ordering index
  • Placemark Group title and Placemark title
  • Placemark Group title (descending) and Placemark title
  • Placemark Group user ordering index and Placemark title
  • Placemark 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 Placemark Group Property Создавать кластер для каждой группы маркеров (также можно изменить иконку на кластере)
Необходимо помнить, что если используется данная функциональность (без использования управления метками через группу), то у группы должен быть указан признак активности в кластере (признак Active in Placemark 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


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

GM-Map-Detail-PlacemarkList.png

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 - выполнить клик на метке
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 Дополнительная опция поиска меток в списке с автодополнением

Группы меток

GM-Map-Detail-PlacemarkGroups-1.png

GM-Map-Detail-PlacemarkGroups-2.png

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
Display Show All and Hide All buttons Выводить кнопки показать/скрыть все группы в один клик
  • No
  • Text
  • Icon
  • Text and Icon
Placemark 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 Примечание под списком

Маршрут

GM-Map-Detail-Route-1.png

GM-Map-Detail-Route-2.png

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

  • с помощью поиска через геокодирование (слайдер 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

GM-Map-Detail-PlacesLibrary.png

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

GM-Map-Detail-PanoramioLibrary.png


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

GM-Map-Detail-AdvancedOptions-1.png

GM-Map-Detail-AdvancedOptions-2.png

GM-Map-Detail-AdvancedOptions-3.png

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 Вы можете использовать данную функциональность для переопределения стандартного текста для элементов управления и т.п. через специальный интерфейс в компоненте в административной панели.

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

GM-Map-Detail-Geolocation.png

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


Интеграция

GM-Map-Detail-Integration.png

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

GM-Map-Detail-Display.png

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

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

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

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

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