Zh GoogleMap Plugin/ru: Difference between revisions

From Documentation
Jump to navigation Jump to search
mNo edit summary
 
(18 intermediate revisions by the same user not shown)
Line 38: Line 38:
** TERRAIN
** TERRAIN
** OSM
** OSM
** NZTOPOMAPS
** NZTOPOMAP
** OPENTOPOMAP
** '''do not change''' - не изменять тип карты
** '''do not change''' - не изменять тип карты
* Width - новая ширина карты
* Width - новая ширина карты
Line 66: Line 67:
** TERRAIN
** TERRAIN
** OSM
** OSM
** NZTOPOMAPS
** NZTOPOMAP
** OPENTOPOMAP
** '''do not change''' - не изменять тип карты
** '''do not change''' - не изменять тип карты
* Width - новая ширина карты
* Width - новая ширина карты
Line 117: Line 119:
* Center по умолчанию устанавливается в  '''map'''
* Center по умолчанию устанавливается в  '''map'''
* Zoom устанавливается в  '''15'''
* Zoom устанавливается в  '''15'''
=== Вывод на карте определенного маршрута ===
Также у Вас есть возможность вызвать карту только с одним определенным маршрутом. Для этого необходимо вставить следующий вызов
<pre>
{zhgooglemap-route:NNN;Center;Zoom;MapType;Width;Height}
</pre>
где
* NNN - (обязательный) идентификатор маршрута
* Center - центр карты(map) (пока не используется) является новым центром карты, допустимые значения:
** '''map'''
** '''do not change''' - не изменять центр карты
* Zoom - новый масштаб карты, допустимые значения
** значение от '''0''' до '''18''' для переопределения масштаба
** '''do not change''' - не изменять масштаб карты
* MapType - новый тип карты
** ROADMAP
** SATELLITE
** HYBRID
** TERRAIN
** OSM
** NZTOPOMAP
** OPENTOPOMAP
** '''do not change''' - не изменять тип карты
* Width - новая ширина карты
** значение ширины в пикселях
** '''do not change''' - не изменять ширину карты
* Height - новая высота карты
** значение высоты в пикселях
** '''do not change''' - не изменять высоту карты
=== Вывод на карте определенного пути ===
Также у Вас есть возможность вызвать карту только с одним определенным путем. Для этого необходимо вставить следующий вызов
<pre>
{zhgooglemap-path:NNN;Center;Zoom;MapType;Width;Height}
</pre>
где
* NNN - (обязательный) идентификатор пути
* Center - центр карты(map) (пока не используется) является новым центром карты, допустимые значения:
** '''map'''
** '''do not change''' - не изменять центр карты
* Zoom - новый масштаб карты, допустимые значения
** значение от '''0''' до '''18''' для переопределения масштаба
** '''do not change''' - не изменять масштаб карты
* MapType - новый тип карты
** ROADMAP
** SATELLITE
** HYBRID
** TERRAIN
** OSM
** NZTOPOMAP
** OPENTOPOMAP
** '''do not change''' - не изменять тип карты
* Width - новая ширина карты
** значение ширины в пикселях
** '''do not change''' - не изменять ширину карты
* Height - новая высота карты
** значение высоты в пикселях
** '''do not change''' - не изменять высоту карты


=== Вывод на карте списка меток ===
=== Вывод на карте списка меток ===
Вы имеете возможность вызвать карту с маркерами из разных карт (указав их списком). Для этого необходимо вставить следующий вызов  
Вы имеете возможность вызвать карту с маркерами из разных карт (указав их списком). Для этого необходимо вставить следующий вызов  
<pre>
<pre>
{zhgooglemap-markerlist:PlacemarkList;MMM;Zoom;MapType;Width;Height}
{zhgooglemap-markerlist:PlacemarkList;MMM;Zoom;MapType;Width;Height;Center;Action}
</pre>
</pre>
где
где
Line 135: Line 200:
** TERRAIN
** TERRAIN
** OSM
** OSM
** NZTOPOMAPS
** NZTOPOMAP
** OPENTOPOMAP
** '''do not change''' - не изменять тип карты
** '''do not change''' - не изменять тип карты
* Width - новая ширина карты
* Width - новая ширина карты
Line 143: Line 209:
** значение высоты в пикселях
** значение высоты в пикселях
** '''do not change''' - не изменять высоту карты
** '''do not change''' - не изменять высоту карты
* Center - новый центр карты
** идентификатор метки, чьи координаты будут считаться центром карты. Метка должна быть задана широтой и долготой
** '''do not change''' - не изменять центр карты
* Action - выполнить событие при загрузке карты, можно указывать через запятую
** '''do not change''' - ничего не выполнять
** '''click''' - выполнить событие нажатия на метке центрирования карты.
** '''bounce''' - изменить анимацию метки центрирования карты.


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


Пример 1:
Пример 1:
Line 156: Line 230:
Вы имеете возможность вызвать карту с маркерами из разных карт (указав группу маркеров). Для этого необходимо вставить следующий вызов  
Вы имеете возможность вызвать карту с маркерами из разных карт (указав группу маркеров). Для этого необходимо вставить следующий вызов  
<pre>
<pre>
{zhgooglemap-group:NNN;MMM;Zoom;MapType;Width;Height;Center;Action}
{zhgooglemap-group:GroupList;MMM;Zoom;MapType;Width;Height;Center;Action;ObjectTypeList}
</pre>
</pre>
где
где
* NNN - (обязательный) идентификатор группы маркеров
* GroupList - (обязательный) список идентификаторов групп, разделенных через запятую
* MMM - (обязательный) идентификатор карты
* MMM - (обязательный) идентификатор карты
* Zoom - новый масштаб карты, допустимые значения
* Zoom - новый масштаб карты, допустимые значения
Line 170: Line 244:
** TERRAIN
** TERRAIN
** OSM
** OSM
** NZTOPOMAPS
** NZTOPOMAP
** OPENTOPOMAP
** '''do not change''' - не изменять тип карты
** '''do not change''' - не изменять тип карты
* Width - новая ширина карты
* Width - новая ширина карты
Line 185: Line 260:
** '''click''' - выполнить событие нажатия на метке центрирования карты.  
** '''click''' - выполнить событие нажатия на метке центрирования карты.  
** '''bounce''' - изменить анимацию метки центрирования карты.  
** '''bounce''' - изменить анимацию метки центрирования карты.  
* ObjectTypeList - типы объектов карты, которые относятся к данным группам и будут отображаться. Можно вводить через запятую
** '''placemark''' - обрабатываются метки. Это значение по умолчанию
** '''path''' - обрабатываются пути
** '''all''' - обрабатываются все объекты


В этом случае Вы должны указать ID метки для центрирования карты
 
Например, указав значение для ObjectTypeList как '''path''' Вы получите пути, относящиеся к данным группам.
Значение '''all''' аналогично '''placemark,path'''
 
В случае выполнения события Вы должны указать ID метки для центрирования карты


=== Вывод на карте определенной категории меток ===
=== Вывод на карте определенной категории меток ===
У вас есть возможность вызвать карту с маркерами из разных карт (указав категорию маркеров). Для этого необходимо вставить следующий вызов  
У вас есть возможность вызвать карту с маркерами из разных карт (указав категорию маркеров). Для этого необходимо вставить следующий вызов  
<pre>
<pre>
{zhgooglemap-category:NNN;MMM;Zoom;MapType;Width;Height;Center;Action}
{zhgooglemap-category:CategoryList;MMM;Zoom;MapType;Width;Height;Center;Action;ObjectTypeList}
</pre>
</pre>
где
где
* NNN - (обязательный) идентификатор категории маркеров
* CategoryList - (обязательный) список идентификаторов категорий маркеров, разделенных через запятую
* MMM - (обязательный) идентификатор карты
* MMM - (обязательный) идентификатор карты
* Zoom - новый масштаб карты, допустимые значения
* Zoom - новый масштаб карты, допустимые значения
Line 205: Line 288:
** TERRAIN
** TERRAIN
** OSM
** OSM
** NZTOPOMAPS
** NZTOPOMAP
** OPENTOPOMAP
** '''do not change''' - не изменять тип карты
** '''do not change''' - не изменять тип карты
* Width - новая ширина карты
* Width - новая ширина карты
Line 219: Line 303:
** '''do not change''' - ничего не выполнять
** '''do not change''' - ничего не выполнять
** '''click''' - выполнить событие нажатия на метке центрирования
** '''click''' - выполнить событие нажатия на метке центрирования
* ObjectTypeList - типы объектов карты, которые относятся к данным категориям и будут отображаться. Можно вводить через запятую
** '''placemark''' - обрабатываются метки. Это значение по умолчанию
** '''path''' - обрабатываются пути
** '''route''' - обрабатываются маршруты
** '''all''' - обрабатываются все объекты
Например, указав значение для ObjectTypeList как '''path''' Вы получите пути, относящиеся к данным категориям.
Значение '''all''' аналогично '''placemark,path,route'''
В случае выполнения события Вы должны указать ID метки для центрирования карты


=== Вывод карты в Lightbox ===
=== Вывод карты в Lightbox ===
Line 235: Line 331:
administrator/components/com_zhgooglemap/assets/lightbox/
administrator/components/com_zhgooglemap/assets/lightbox/
</pre>
</pre>
или
<pre>
components/com_zhgooglemap/assets/lightbox/
</pre>
в зависимости от установленного свойства компонента "Compatible Mode for Resource Files"
* PlacemarkList - список идентификаторов меток, разделенных запятой  
* PlacemarkList - список идентификаторов меток, разделенных запятой  


Line 266: Line 367:
Или в этом случае использовать модуль
Или в этом случае использовать модуль
</p>
</p>
<p class="zh-text-alert">
<p class="zh-text-alert">
Т.к. это плагин для компонента, то компонент должен быть установлен
Т.к. это плагин для компонента, то компонент должен быть установлен
</p>
<p class="zh-text-alert">
Существуют ограничения – нельзя использовать в наименовании символы
<br />
< > / \
<br />
</p>
</p>


Line 273: Line 382:
{{Icon_see_also}}[[Zh_GoogleMap_Description/ru|Подробное описание компонента]]
{{Icon_see_also}}[[Zh_GoogleMap_Description/ru|Подробное описание компонента]]


{{Icon_see_also}}[[Zh_GoogleMap_Module/ru|Модуль для компонента]]





Latest revision as of 13:28, 11 December 2020

Назначение

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

Более того, поскольку это плагин для содержимого (content), то Вы можете вставить код вызова в Custom HTML модуль и вывести карту как модуль. Рекомендуется ставить ширину=0 (что соответствует width: 100%), для того, чтобы карта автоматически заполняла ширину модуля и при изменении размеров (например, переменный размер шаблона), не происходило "вылезание" карты за размеры.


Установка

Установите плагин через Extension Manager.

Сделайте его активным.

Т.к. это плагин для компонента, то компонент должен быть установлен

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

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

Вывод карты

Для вывода карты в любом месте статьи вставьте следующий фрагмент

{zhgooglemap:MMM;Zoom;MapType;Width;Height}

где

  • MMM - (обязательный) идентификатор карты. Он выведен в списке карт.
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты

Вывод на карте определенной метки

Также у Вас есть возможность вызвать карту только с одним определенным маркером. Для этого необходимо вставить следующий вызов

{zhgooglemap-marker:NNN;Center;Zoom;MapType;Width;Height;Action}

где

  • NNN - (обязательный) идентификатор маркера
  • Center - центр карты(map) или метка(placemark) является новым центром карты, допустимые значения:
    • map
    • placemark
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты
  • Action - выполнить событие при загрузке карты, можно указывать через запятую
    • do not change - ничего не выполнять
    • click - выполнить событие нажатия на метки.
    • bounce - изменить анимацию метки.


Для случая выполнения события Вы должны установить Center=placemark


Пример 1:
{zhgooglemap-marker:5;placemark;10}


Пример 2:
{zhgooglemap-marker:1;map;do not change}


Пример 3:
{zhgooglemap-marker:4}
В этом случае

  • Center по умолчанию устанавливается в map
  • Zoom по умолчанию устанавливается в do not change



Пример 4:
{zhgooglemap-marker:1;;15}
В этом случае

  • Center по умолчанию устанавливается в map
  • Zoom устанавливается в 15


Вывод на карте определенного маршрута

Также у Вас есть возможность вызвать карту только с одним определенным маршрутом. Для этого необходимо вставить следующий вызов

{zhgooglemap-route:NNN;Center;Zoom;MapType;Width;Height}

где

  • NNN - (обязательный) идентификатор маршрута
  • Center - центр карты(map) (пока не используется) является новым центром карты, допустимые значения:
    • map
    • do not change - не изменять центр карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты



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

Также у Вас есть возможность вызвать карту только с одним определенным путем. Для этого необходимо вставить следующий вызов

{zhgooglemap-path:NNN;Center;Zoom;MapType;Width;Height}

где

  • NNN - (обязательный) идентификатор пути
  • Center - центр карты(map) (пока не используется) является новым центром карты, допустимые значения:
    • map
    • do not change - не изменять центр карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты

Вывод на карте списка меток

Вы имеете возможность вызвать карту с маркерами из разных карт (указав их списком). Для этого необходимо вставить следующий вызов

{zhgooglemap-markerlist:PlacemarkList;MMM;Zoom;MapType;Width;Height;Center;Action}

где

  • PlacemarkList - (обязательный) список идентификаторов меток, разделенных запятой
  • MMM - (обязательный) идентификатор карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты
  • Center - новый центр карты
    • идентификатор метки, чьи координаты будут считаться центром карты. Метка должна быть задана широтой и долготой
    • do not change - не изменять центр карты
  • Action - выполнить событие при загрузке карты, можно указывать через запятую
    • do not change - ничего не выполнять
    • click - выполнить событие нажатия на метке центрирования карты.
    • bounce - изменить анимацию метки центрирования карты.

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

Пример 1:

{zhgooglemap-markerlist:1,2,5;10}
В этом случае Вы увидите метки с ID=1, с ID=2 и с ID=5 на карте с ID=10

Вывод на карте меток определенной группы

Вы имеете возможность вызвать карту с маркерами из разных карт (указав группу маркеров). Для этого необходимо вставить следующий вызов

{zhgooglemap-group:GroupList;MMM;Zoom;MapType;Width;Height;Center;Action;ObjectTypeList}

где

  • GroupList - (обязательный) список идентификаторов групп, разделенных через запятую
  • MMM - (обязательный) идентификатор карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты
  • Center - новый центр карты
    • идентификатор метки, чьи координаты будут считаться центром карты. Метка должна быть задана широтой и долготой
    • do not change - не изменять центр карты
  • Action - выполнить событие при загрузке карты, можно указывать через запятую
    • do not change - ничего не выполнять
    • click - выполнить событие нажатия на метке центрирования карты.
    • bounce - изменить анимацию метки центрирования карты.
  • ObjectTypeList - типы объектов карты, которые относятся к данным группам и будут отображаться. Можно вводить через запятую
    • placemark - обрабатываются метки. Это значение по умолчанию
    • path - обрабатываются пути
    • all - обрабатываются все объекты


Например, указав значение для ObjectTypeList как path Вы получите пути, относящиеся к данным группам. Значение all аналогично placemark,path

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

Вывод на карте определенной категории меток

У вас есть возможность вызвать карту с маркерами из разных карт (указав категорию маркеров). Для этого необходимо вставить следующий вызов

{zhgooglemap-category:CategoryList;MMM;Zoom;MapType;Width;Height;Center;Action;ObjectTypeList}

где

  • CategoryList - (обязательный) список идентификаторов категорий маркеров, разделенных через запятую
  • MMM - (обязательный) идентификатор карты
  • Zoom - новый масштаб карты, допустимые значения
    • значение от 0 до 18 для переопределения масштаба
    • do not change - не изменять масштаб карты
  • MapType - новый тип карты
    • ROADMAP
    • SATELLITE
    • HYBRID
    • TERRAIN
    • OSM
    • NZTOPOMAP
    • OPENTOPOMAP
    • do not change - не изменять тип карты
  • Width - новая ширина карты
    • значение ширины в пикселях
    • do not change - не изменять ширину карты
  • Height - новая высота карты
    • значение высоты в пикселях
    • do not change - не изменять высоту карты
  • Center - новый центр карты
    • идентификатор метки, чьи координаты будут считаться центром карты. Метка должна быть задана широтой и долготой
    • do not change - не изменять центр карты
  • Action - выполнить событие при загрузке карты
    • do not change - ничего не выполнять
    • click - выполнить событие нажатия на метке центрирования
  • ObjectTypeList - типы объектов карты, которые относятся к данным категориям и будут отображаться. Можно вводить через запятую
    • placemark - обрабатываются метки. Это значение по умолчанию
    • path - обрабатываются пути
    • route - обрабатываются маршруты
    • all - обрабатываются все объекты


Например, указав значение для ObjectTypeList как path Вы получите пути, относящиеся к данным категориям.

Значение all аналогично placemark,path,route

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

Вывод карты в Lightbox

Сделана возможность вызова карты в отдельном окне, для этого необходимо указать следующий код

{zhgooglemap-lightbox:MMM;Title;Width;Height;Image;PlacemarkList}

где

  • MMM – (обязательный) идентификатор карты
  • Title – текст линка
  • Width – ширина lightbox-окна
  • Height – высотаof lightbox-окна.
  • Image - изображение, которое может быть выведено

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

administrator/components/com_zhgooglemap/assets/lightbox/

или

components/com_zhgooglemap/assets/lightbox/

в зависимости от установленного свойства компонента "Compatible Mode for Resource Files"

  • PlacemarkList - список идентификаторов меток, разделенных запятой


Существуют ограничения – нельзя использовать в наименовании символы
< > / \


Карта выводится как компонент (т.е. все функции именно компонента, не плагина). Т.е. плагин осуществляет вызов компонента. Есть особенность – при этом стили шаблона не подгружаются.


Пример 1:

{zhgooglemap-lightbox:2;;800;500;ZhukLogo.png}

  • В этом случае текст линка не выводится, а выводится только изображение.

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

Ограничения

Плагин не работает в контактах, так как у контактов тип отличен от "content"
Но у Вас есть возможность создать статью, отформатировав ее как контакт, даже красивее, и включить в нее карту
Или в этом случае использовать модуль

Т.к. это плагин для компонента, то компонент должен быть установлен

Существуют ограничения – нельзя использовать в наименовании символы
< > / \

См. также

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

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


Language: English  • русский