Інструкція користувача

Ласкаво просимо до MapAlarm! Цей додаток допомагає вам ніколи не пропустити свою зупинку в транспорті або не забути зробити щось важливе після прибуття чи виїзду з певного місця. Додаток використовує геолокацію вашого пристрою та працює повністю автономно (усі ваші дані зберігаються надійно на самому телефоні).

У цьому посібнику простою мовою описано кожен екран, кнопка та функція додатка, щоб ви могли легко користуватися ним без зайвих технічних труднощів.

🗺️ Екран «Мапа» (Основний екран)

Цей екран відкривається при запуску та є головним місцем для роботи з картою та додавання нових будильників.

🔍 Основні елементи на карті:

Поле пошуку («Пошук місця або адреси…»): розташоване у верхній частині екрана. Введіть сюди назву міста, вулиці чи конкретного закладу, щоб швидко знайти це місце. Під полем пошуку також відображається список ваших останніх пошуків для швидкого доступу.
Кнопка геолокації (іконка мішені 🎯): розташована збоку. Натисніть її, щоб карта миттєво перемістилася до вашого поточного місцезнаходження.
Кнопка шарів карти (іконка шарів 🥞): дозволяє налаштувати вигляд карти. Тут можна вибрати:
- Стиль карти: Стандарт (звичайна схема), Рельєф (карта висот) або Гібрид (супутникова карта з підписами вулиць).
- Додаткові шари: увімкнути відображення Заторів на дорогах або ліній Громадського транспорту.

➕ Як створити новий будильник на карті

Знайдіть потрібне місце на карті або через пошук.
Зробіть довге натискання на потрібній точці карти або виберіть її з результатів пошуку. З’явиться маркер і кнопка «Встановити тут».
Натисніть її — знизу виїде панель додавання локації, яку можна розгорнути свайпом (проведенням пальцем) вгору.

📝 Кнопки та налаштування в панелі будильника:

Фото місця (квадратне зображення зліва): додаток намагається підібрати реальне фото цього місця з Google Maps. Натиснувши на нього, ви можете:
- Вибрати інше фото з Google Maps.
- Вибрати будь-яку власну картинку з Галереї вашого телефону.
Поле назви (зверху): тут ви можете ввести зрозумілу назву (наприклад, «Моя робота», «Метро Чернігівська» або «Дача»). Якщо поле порожнє, додаток назве точку просто «Локація».
Кнопка швидкого скасування (хрестик ❌): згортає панель без збереження змін.
Кнопка швидкого збереження (галочка ✔️): зберігає будильник із поточними параметрами.
Кнопка активності (іконка дзвоника 🔔): швидко вмикає або вимикає цей будильник. Якщо дзвоник світиться кольором — відстеження цієї точки працює.
Напрямок спрацьовування:
- Прибуття 📥 (зелений колір): сигнал пролунає, коли ви наближатиметеся до цього місця.
- Виїзд 📤 (помаранчевий колір): сигнал пролунає, коли ви віддалятиметеся від цього місця.
Показник радіуса: відображає відстань навколо точки, в межах якої спрацює сигнал (наприклад, 500 м).
Повзунок радіуса спрацьовування (слайдер): потягніть його ліворуч або праворуч, щоб змінити зону спрацьовування (від мінімальних 50 метрів до 5 кілометрів).
Кнопка «Вибране» (зірочка ⭐): натисніть, щоб додати локацію в список улюблених місць (вони позначатимуться золотою зіркою).
Поле нотатки («Нотатка»): тут можна записати коротке нагадування для себе, яке ви побачите під час сигналу (наприклад, «Забрати посилку» чи «Купити молоко»).
Розділ «Розклад» (⏰):
- Перемикач розкладу: дозволяє увімкнути роботу будильника тільки в певні дні та години.
- Кнопка «Додати розклад»: відкриває налаштування часу та днів тижня.
- Вибір днів тижня: натискайте на кружечки з днями (Пн, Вт, Ср, Чт, Пт, Сб, Нд). Вибрані дні підсвічуються кольором.
- Часовий діапазон (кнопки часу «З» та «До»): натисніть на них, щоб вибрати години та хвилини, в які будильник має бути активним. Наприклад, якщо ви їдете на роботу, можна налаштувати роботу будильника тільки в будні з 08:00 до 10:00. Кнопка з хрестиком поруч із часом «До» скидає обмеження до «безкінечності» (∞).
Кнопки в самому низу:
- Скасувати: закриває налаштування без збереження.
- Зберегти: зберігає всі налаштування та додає будильник до вашого списку.

📋 Екран «Мої локації» (Список будильників)

Цей екран показує всі збережені вами місця. Перемикатися на нього можна за допомогою меню знизу.

🎴 Що зображено на картці кожної локації:

Фонове зображення: встановлене вами фото або схематична мапа місця.
Назва та нотатка: відображаються великим шрифтом поверх зображення.
Радіус і напрямок: у лівому верхньому кутку вказано зону спрацьовування та стрілку (прибуття 📥 чи виїзд 📤).
Перемикач активності (зверху праворуч): дозволяє миттєво ввімкнути або вимкнути відстеження саме цього місця.
Інформація про розклад (іконка годинника 🕒): показує налаштовані дні та час роботи. Натискання на цю кнопку відкриває швидке налаштування розкладу в меню, що виїжджає знизу.
Кнопка швидкої навігації (іконка стрілки навігатора ↗️): відкриває це місце на картах вашого телефону (наприклад, Google Maps), щоб ви могли побудувати до нього маршрут.
Показник відстані та шкала прогресу (відображається тільки для активних будильників): показує, скільки кілометрів або метрів залишилося до точки в реальному часі, та заповнюється у відсотках у міру вашого наближення.

⚙️ Додаткові кнопки на екрані списку:

Кнопка швидких налаштувань (іконка шестірні ⚙️ зверху): відкриває загальні налаштування звуку, тем та сповіщень додатка.
Кнопка «Система та стабільність» (попереджувальна плашка зверху): з’являється, якщо у додатку налаштовані не всі дозволи для стабільної роботи. Натисніть її, щоб перевірити та виправити проблеми.
Кнопка «ДОДАТИ» (кругла кнопка зі шпилькою 📍 знизу): переносить вас на вкладку «Мапа», щоб ви могли обрати нове місце для будильника.

🛠️ Керування списком (Режим вибору):

Зробіть довге натискання на будь-яку картку в списку, щоб увімкнути режим редагування та впорядкування.

Зміна порядку (Drag & Drop): затисніть картку пальцем та перетягніть її вгору або вниз, щоб змінити черговість у списку.
Групове видалення: відмітьте галочками кілька потрібних карток. Зверху з’явиться панель із кількістю вибраних точок. Натисніть кнопку видалення (іконка кошика 🗑️), щоб стерти їх, або хрестик ❌ для виходу з цього режиму.
Додаткові дії на картці в режимі вибору:
- Поділитися (іконка 📤): надсилає текстове повідомлення з посиланням на локацію вашим друзям.
- Редагувати (іконка олівця ✏️): переносить вас до редагування цієї точки на карті.

⚙️ Загальні налаштування програми

Тут ви можете налаштувати поведінку додатку під свій смак. Щоб відкрити налаштування, натисніть іконку шестірні ⚙️ на екрані списку локацій.

🔊 Розділ «Звук та вібрація»:

Гучність MapAlarm (повзунок): встановлює гучність, з якою гратиме ваш будильник. Зверніть увагу: якщо звук вашого телефону повністю вимкнено в системі, додаток покаже попередження жовтого кольору.
Плавне наростання (перемикач): якщо увімкнено, гучність сигналу збільшуватиметься поступово, щоб не злякати вас під час сну. Нижче можна повзунком задати тривалість наростання (від 0 до 30 секунд).
Мелодія: дозволяє вибрати будь-який звук будильника із пам’яті телефону.
Вібрація (перемикач): вмикає або вимикає вібрування телефону під час сигналу.
Джерело звуку (куди направляти сигнал):
- Навушники — якщо підключена гарнітура, звук лунатиме виключно в навушниках (корисно в громадському транспорті).
- Навушники та динамік — звук буде грати і в навушниках, і через динамік телефону одночасно.
- Динамік через 30с — спочатку сигнал грає тільки в навушниках, але якщо ви не вимкнули його протягом 30 секунд, він почне грати на весь динамік (запобіжник на випадок, якщо ви міцно заснули).
- Тільки динамік — звук завжди йде примусово на динамік телефону, навіть якщо підключені навушники.
Кнопка «Тест» (Play ▶️): відтворює вибрану мелодію з налаштованою гучністю, щоб ви могли перевірити її роботу. Натисніть «Зупинити» (Stop ⏹️), щоб вимкнути тест.

🔔 Розділ «Сповіщення»:

Показувати сповіщення відстеження: якщо увімкнено, під час подорожі у шторці сповіщень вашого телефону відображатимуться інформаційні картки для кожної активної точки із зазначенням відстані до неї в метрах або кілометрах.
Системні налаштування сповіщень: відкриває стандартні налаштування Android для додатку MapAlarm, де можна детально налаштувати права на повідомлення.

🎨 Розділ «Інтерфейс та Радіус»:

Тема додатка: дозволяє вручну вибрати Світлу чи Темну тему оформлення додатка, або залишити автоматичний вибір (Як у системі).
Тема мапи: вибір колірної схеми карти — Системна, Світла, Темна чи Автоматична (міняється залежно від часу доби).

ℹ️ Розділ «Про додаток»:

Політика конфіденційності: відкриває документ про те, як додаток захищає ваші дані про місцезнаходження (нагадаємо: дані не передаються в інтернет, а обробляються лише на вашому пристрої).
В самому низу вказана поточна встановлена версія програми.

##🛡️ Екран «Система та стабільність»

Цей екран є надзвичайно важливим! Щоб Android не вимикав додаток під час подорожі для збереження батареї та вчасно будив вас із вимкненим екраном, додаток потребує певних дозволів.

Картки на цьому екрані світяться зеленим (якщо все налаштовано правильно) або червоним (якщо потрібно надати дозвіл). Натисніть на червону картку, щоб дізнатися подробиці та одразу перейти до налаштувань.

🔑 Важливі дозволи:

Геолокація: потрібна для розуміння того, де ви перебуваєте зараз.
Фонова геолокація: НАЙВАЖЛИВІШИЙ дозвіл! Дозволяє додатку знати ваші координати, коли екран телефону вимкнений або ви відкрили іншу програму. В налаштуваннях Android обов’язково виберіть пункт «Дозволяти завжди» (а не «Тільки під час використання»).
Сповіщення: потрібні для показу попереджень та запуску вікна тривоги поверх інших програм.
Точні будильники: дозволяє телефону запускати сигнал точнісінько в потрібну секунду без затримок від системи.
Показ на весь екран: дозволяє автоматично відкривати повноекранне вікно будильника, навіть якщо телефон заблоковано (екран вимкнено).
Керування енергією (Вимкнення оптимізації батареї): за замовчуванням Android намагається закривати програми, які довго працюють у фоні. Вимкнення оптимізації гарантує, що додаток не буде примусово зупинено системою посеред вашої поїздки.
Розпізнавання активності: цей датчик розуміє, коли ви їдете в транспорті, йдете пішки чи просто стоїте на місці. Коли ви не рухаєтеся, додаток автоматично знижує частоту запитів GPS, суттєво економлячи заряд вашої батареї (Еко-режим).
Примусовий звук (перемикач): якщо цей пункт увімкнено, MapAlarm зможе грати на повну гучність, навіть якщо ваш телефон перебуває у беззвучному режимі чи режимі «Не турбувати».

🚨 Екран тривоги (Спрацьовування будильника)

Коли ви доїжджаєте до зони радіуса вашої точки, на телефоні на повний екран запускається вікно тривоги, починає грати мелодія та працює вібрація.

📱 Що ви побачите на екрані тривоги:

Картинка місця: велике фото локації, яке ви налаштовували.
Назва та нотатка: великий напис із вашими нагадуваннями (наприклад, «Ви прибули: Метро Університет»).
Інструкція (якщо додано): корисне текстове нагадування.
Слайдер відключення (кнопка внизу): щоб вимкнути будильник, притисніть пальцем білий кружечок внизу екрана та проведіть його вправо (до зображення дзвоника).⚠️ Зверніть увагу: звичайні кнопки назад або згортання програми на цьому екрані заблоковані, щоб ви випадково не вимкнули будильник у кишені чи спросоння. Відключення працює виключно свайпом по слайдеру!