Документация по модулю Maps и принадлежащим к нему страницам перенесена в Confluence
http://abills.net.ua:8090/display/AB/Maps

Maps

Гео визуализация бизнес процессов и ведения карты сети

Возможности

Google / Yandex maps

Установка

Добавление дампа базы

# mysql -D abills < db/Maps.sql

abills/libexec/config.pl

@MODULES = (
          'Maps'
          );

Регистрация ключа Google API

При загрузке Google Карт на этой странице возникла проблема. Подробности вы найдете в консоли JavaScript.

  1. Кнопка «Включить API» или слева «Библиотека».
  2. Google Maps Javascript API. Кнопка «Включить».
  3. Слева «Учётные данные»
  4. «Создать» > «Ключ API»
  5. Сохранить в libexec/config.pl как $conf{MAPS_GOOGLE_API_KEY} = '%ВашКлюч%';

Для серверных запросов нужен отдельный ключ (Ключ сервисного аккаунта), который нужно сохранять в $conf{GOOGLE_API_KEY}

Для работы модуля c растровыми картами требуется Perl модуль GD

Настройка

Maps 1.0 (старый интерфейс)

Maps 2.0

Google/Yandex Maps

Добавление обьектов


Удобный способ регистрации координат и создания новых объектов.

При добавлении маркера «Дом» также есть возможность создания нового дома в журнале адресов.
По скольку, форма выбора адреса загружается динамически, вы можете, не закрывая карту, в другой вкладке добавлять районы и улицы.

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

Вы можете перемещаться по карте с помощью жеста «drag» (зажав кнопку мышки).
В любой момент вы можете сбросить текущую операцию, нажав на кнопку сброса

Удаление


Для входа в режим удаления, нажмите на кнопку удаления маркера.

В режиме удаления, нажмите на иконку маркера, который хотите удалить.

Вы можете перемещаться по карте с помощью жеста «drag» (зажав кнопку мышки).
В любой момент вы можете сбросить текущую операцию, нажав на кнопку сброса

Слои объектов


С помощью кнопки управления слоями вы можете выбрать слои, которые нужно отобразить.
При первом вызове слоя, объекты скачиваются с билинга и кешируются.

Методы работы со слоями: * Нажмите на нужный слой для того, чтобы отобразить/спрятать объекты слоя.

Поиск


Поиск реализован через Locations API.
Доступны два режима поиска:

  • По запросу
  • По типу

Поиск ведётся в радиусе 5 км от Начального центра карты, но если объектов немного, зона поиска автоматически расширяется
Поскольку для клиентов важнее всего 3 типа объектов (банкоматы, банки, терминалы), они могут указать интересующие типы в поиске «По типу»

Полигоны районов


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

Полигоны строятся по принципу минимальной выпуклой оболочки.

Чтобы включить/отключить отображение полигонов, нажмите на кнопку «Полигоны районов».

Кластеры

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


Методы работы с кластеризатором домов:

  • Нажмите на иконку кластера, чтобы быстро приблизить область и отобразить маркеры внутри кластера.

Способ отображения контролируется кнопкой
Есть 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; Цвет дома на карте зависит от онлайна в доме