====== Мапа обладнання та користувачів ======

В Ubilling починаючи з релізу 0.3.4 з'явилася можливість розміщувати на карті наявні світчі, точки доступу та інше активне мережеве обладнання, зареєстроване у відповідному довіднику. Сам модуль карт має мінімальні налаштування і керується за допомогою конфіга **ymaps.ini**. Для ввімкнення-вимкнення цього модуля існує опція SWYMAP_ENABLED конфігу **alter.ini**

<file ini ymaps.ini>
; Координати центру мапи у форматі "широта, довгота". У разі порожнього CENTER буде використано гео-таргетинг.
CENTER=""
; Масштаб мапи за замовчуванням
ZOOM=14
; Тип мапи за замовчуванням, можливо, roadmap, satellite, hybrid, terrain
TYPE="roadmap"
; Чи використовувати рендер плейсмарків на canvas (дуже швидко, але бажано відключати підписи на мітках)
CANVAS_RENDER=1
; Масштаб, за якого відображатиметься мапа після кліка по "знайти пристрій на мапи"
FINDING_ZOOM=17
; Підсвічувати область під час пошуку обладнання 
FINDING_CIRCLE=1
;Вмикає чи вимикає відображення метрик швидкодії, тощо.
METRICS_ENABLED=0
;Встановлює запам'ятовування останнього використаного шару мапи, в локальному сховищі браузера.
REMEMBER_LAYER=1

;Кастомний провайдер мап Leaflet.
; Приклади:
; Mapbox: https://api.tiles.mapbox.com/v4/{id}/{z}/{x}/{y}.png?access_token=pk.eyJ1IjoibWFwYm94IiwiYSI6ImNpejY4NXVycTA2emYycXBndHRqcmZ3N3gifQ.rJcFIG214AriISLbB6B5aw
; OSM: https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
; Visicom: https://tms{s}.visicom.ua/2.0.0/planet3/base/{z}/{x}/{y}.png?key=YOUR_API_KEY
; Google roadmaps: http://{s}.google.com/vt/lyrs=m&x={x}&y={y}&z={z}
; Google hybryd: http://{s}.google.com/vt/lyrs=s,h&x={x}&y={y}&z={z}
; Google satellite: http://{s}.google.com/vt/lyrs=s&x={x}&y={y}&z={z}
; Google terrain: http://{s}.google.com/vt/lyrs=p&x={x}&y={y}&z={z}
; KaminariTile cache server: https://your.tile.server.ua/kaminaritile/?t={s}_{z}_{x}_{y}
LEAFLET_TILE_LAYER="https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png"
</file>

Логіка відображення міток на мапі зав'язана на полі "Гео координати" для кожної одиниці активного мережевого обладнання. Для зручного розміщення об'єктів на мапі існує зручний редактор, що викликається лівим кліком миші в режимі "редагування". Виглядає це так:

{{:swmapswitchplace.png?600|}}

Відповідно активне обладнання і обладнання, що не відповідає, відображається по-різному, з відповідними повідомленнями, зважаючи на дані, отримані з кеша опитування світчів, оновлюваного за таймаутом SW_PINGTIMEOUT за допомогою виклику swping з Remote API.
Для періодичного опитування світчів можна додати наступний виклик [[remoteapi|API віддаленого виклику процедур]] в crontab, скажімо якось так:
<code>
*/20 * * * *    /bin/ubapi "swping"
</code>

"Машина часу" мертвого обладнання також заповнюється тільки при оновленнях стану його, використовуючи вищевказаний виклик Remote API.


====== Будинки ======

Також починаючи з релізу Ubilling 0.4.6 цей модуль уміє розставляти і показувати на мапі будинки, в яких мешкають ваші користувачі, а також проводити індикацію активності користувачів у цих будинках. Виглядає це наступним чином:

{{::usersmaphouses.png?600|}}

Опитування користувачів на живість відбувається за допомогою відповідного виклику [[remoteapi|API віддаленого виклику процедур]]

<code>
5 * * * *       /bin/ubapi "fullhostscan&param=traffdiff&nn=1"
</code>

а оновлення кеша мапи відбувається за допомогою періодичного виклику
<code>
*/10 * * * *    /bin/ubapi "buildsmap"  
</code>

====== Онлайн користувачів ======
content/dn має існувати, бути порожньою, нікуди не сімлінкнутою директорією і мати права 777. Також очевидно потрібна ввімкнена опція DN_FULLHOSTSCAN для її заповнення та DN_ONLINE_DETECT для відображення.

====== Кешування тайлів та швидкодія ======

Можете спробувати розгорнути собі кешуючий сервер тайлів OSM на базі [[https://github.com/nightflyza/kaminaritile|KaminariTile]]. 

Після чого, просто вкажіть його URL в відповідній опції 

<file ini ymaps.ini>
LEAFLET_TILE_LAYER="https://yourtileserver.ua/kaminaritile/?t={s}_{z}_{x}_{y}"
</file>

Це і швидкодію покращить, і шанси вашого бану знизить.