**''Документация по модулю Maps и принадлежащим к нему страницам перенесена в Confluence''**\\
[[http://abills.net.ua:8090/display/AB/Maps]]
=====Maps=====
Гео визуализация бизнес процессов и ведения карты сети
====Возможности====
* Добавление изображения карт для определенных районов
* Добавление домов
* Добавление nas серверов
* Отображение информации по дому - количество клиентов, онлайн клиенты, № квартиры, депозит
* Отображение информации по nas серверу - іp, название, тип
* Отображение подключенных абонентов
* Отображение заявок на подключение и заявок абонентов
* Визуализация отчётов на карте
* [[abills:docs:manual:admin:maps:maps_auto_coords| Автоматическое заполнение координат]]
* [[abills:docs:manual:admin:maps:maps_location_info| Отображение информации от других модулей]]
* [[abills:docs:manual:admin:Maps:maps_route_types| Задание типов маршрутов]]
* [[abills:docs:manual:admin:maps:maps_route_groups| Групировка маршрутов]]
* [[abills:docs:manual:admin:maps:maps_route_ierarchy| Иерархия маршрутов]]
* [[abills:docs:manual:admin:maps:maps_custom_layers| Рисование произвольных обьектов на карте]]
* [[abills:docs:manual:admin:Maps:maps_builds_quick| Форма быстрого поиска пользователей дома ]]
== Google / Yandex maps ==
* Добавление домов на карту
* Добавление nas серверов на карту
* Добавление маршрутов на карту(Перенесено в Cablecat)
* Добавление WiFi зон на карту
* Отображение информации о клиентах по конкретному дому(онлайн, оффлайн, логин, депозит, квартира)
* Отображение депозита разными цветами. (отрицательный депозит отображается красным)
* Отображение информации об установленном оборудовании
* Отображение информации об маршрутах (тип кабеля, длина, описание, nas 1-2)
* Отображение информации об колодцах(название, описание).
* Создание ссылок на районы в google maps для последующего быстрого перемещения по них.
* [[abills:docs:modules:maps:public_comments|Отображение публичных коментариев для пользователей]]
* [[abills:docs:modules:maps:maps_builds_color|Отображение разных иконок маркеров в зависимости от типа]]
* [[abills:docs:modules:maps:districts_layer|Разрисовка районов цветными полигонами]]
====Установка====
Добавление дампа базы
# mysql -D abills < db/Maps.sql
**abills/libexec/config.pl**
@MODULES = (
'Maps'
);
=== Регистрация ключа Google API ===
**При загрузке Google Карт на этой странице возникла проблема. Подробности вы найдете в консоли JavaScript.**
- https://console.developers.google.com/
- Кнопка "Включить API" или слева "Библиотека".
- Google Maps Javascript API. Кнопка "Включить".
- Слева "Учётные данные"
- "Создать" > "Ключ API"
- Сохранить в ''libexec/config.pl'' как **$conf{MAPS_GOOGLE_API_KEY} = '%ВашКлюч%';**
Для серверных запросов нужен отдельный ключ (''Ключ сервисного аккаунта''), который нужно сохранять в **$conf{GOOGLE_API_KEY}**\\
Для работы модуля c растровыми картами требуется Perl модуль [[abills:docs:manual:soft:gd|GD]]
====Настройка====
[[abills:docs:modules:maps:address| Работа с журналом адресов ]]
=== Maps 1.0 (старый интерфейс) ===
[[abills:docs:modules:maps:old| Maps 1.0 (старый интерфейс) ]]
==== Maps 2.0 ====
==== Google/Yandex Maps ====
=== Добавление обьектов ===
{{:abills:docs:modules:maps:maps2:add.png?nolink |}}\\
Удобный способ регистрации координат и создания новых объектов.
При добавлении маркера "Дом" также есть возможность создания нового дома в журнале адресов.\\
По скольку, форма выбора адреса загружается динамически, вы можете, не закрывая карту, в другой вкладке добавлять районы и улицы.\\
По нажатию на кнопку, выберите тип нового объекта.
По клику на карте, выскочит форма с параметрами необходимыми для добавления объекта.\\
Вы можете перемещаться по карте с помощью жеста "drag" (зажав кнопку мышки).\\
В любой момент вы можете сбросить текущую операцию, нажав на кнопку сброса {{:abills:docs:modules:maps:maps2:drop_active.png?nolink}}
=== Удаление ===
{{:abills:docs:modules:maps:maps2:remove.png?nolink |}}\\
Для входа в режим удаления, нажмите на кнопку удаления маркера. \\
В режиме удаления, нажмите на иконку маркера, который хотите удалить. \\
Вы можете перемещаться по карте с помощью жеста "drag" (зажав кнопку мышки).\\
В любой момент вы можете сбросить текущую операцию, нажав на кнопку сброса {{:abills:docs:modules:maps:maps2:drop_active.png?nolink}}
=== Слои объектов ===
{{:abills:docs:modules:maps:maps2:layers.png?nolink |}}\\
С помощью кнопки управления слоями вы можете выбрать слои, которые нужно отобразить. \\
При первом вызове слоя, объекты скачиваются с билинга и кешируются. \\
Методы работы со слоями:
* Нажмите на нужный слой для того, чтобы отобразить/спрятать объекты слоя.
=== Поиск ===
{{:abills:docs:modules:maps:maps2:search.png?nolink |}}\\
Поиск реализован через Locations API.\\
Доступны два режима поиска:
* По запросу
* По типу
Поиск ведётся в радиусе 5 км от Начального центра карты, но если объектов немного, зона поиска автоматически расширяется \\
Поскольку для клиентов важнее всего 3 типа объектов (банкоматы, банки, терминалы), они могут указать интересующие типы в поиске "По типу" \\
=== Полигоны районов ===
{{:abills:docs:modules:maps:maps2:polygons.png?nolink |}}\\
Полигоны позволяют увидеть к какому району относятся маркеры.\\
Полигоны строятся по принципу минимальной выпуклой оболочки.\\
Чтобы включить/отключить отображение полигонов, нажмите на кнопку "Полигоны районов". \\
=== Кластеры ===
Кластеры позволяют групировать маркеры, если они находятся слишком близко друг к другу.
Кроме того, если нужно отобразить много маркеров, время на рендеринг карты уменьшается больше чем в 10 раз.
Каждый слой карты имеет свой кластеризатор.
{{:abills:docs:modules:maps:maps2:maps_clusters_preview.png?nolink&600}}\\
Методы работы с кластеризатором домов:
* Нажмите на иконку кластера, чтобы быстро приблизить область и отобразить маркеры внутри кластера.
Способ отображения контролируется кнопкой {{:abills:docs:modules:maps:maps2:markerclusterer.png?nolink}} \\
Есть 3 режима:
* Групировать
* Не групировать
* Не отображать
В зависимости от текущего режима кнопка изменяет свой цвет.
==== Настройка ====
**/usr/abills/libexec/config.pl**\\
^$conf{MAPS_MAP_TYPE} = 'google'; |Тип карты по умолчанию ('google', 'yandex') |
^$conf{MAP_VIEW} = ''; |Тип отображения карты (спутник, схема); |
^$conf{MAP_LINE_SIZE} = 5; |Толщина линий маршрута |
^$conf{MAP_LINE_OPACITY} = 0.5; |Прозрачность линий маршрутов |
^$conf{GOOGLE_API_KEY} = 'SecrtKeYGoogle'; |Ключ к API Google (для серверных запросов - Ключ типа "Сервер") |
^$conf{MAPS_GOOGLE_API_KEY} = 'SecrtKeYGoogle'; |Ключ к API Google (для браузерных запросов - Ключ типа "Браузер") |
^$conf{YANDEX_API_KEY} = 'SecrTwadajhdkfg'; |Ключ к API Yandex |
^$conf{MAPS_PAYSYS_NO_BUILDS} = 1; | Включить слой домов на карте, в кабинете пользователя |
^$conf{MAPS_NON_PRIVILEGED_EDIT} = '1' | Позволит администраторам без доступа к меню "Настройка" изменять обьекты на карте |
^$conf{MAPS_BUILD_COLOR_BY_ONLINE} = 1; | Цвет дома на карте зависит от онлайна в доме |