SvitloPulse

Часті питання

Коротко й без маркетингу. Не знайшли відповіді — загляньте в «Як це працює» або «Джерела даних».

Про сервіс

Це офіційне джерело?

Ні. SvitloPulse — незалежний сервіс. Офіційну інформацію публікують оператори системи розподілу та Укренерго. Ми збираємо їхні графіки в одному місці й додаємо незалежні сигнали.

Що таке черга (ГПВ) і підчерга?

ГПВ — графік погодинних відключень. Споживачів поділено на 6 черг, кожну ще на 2 підчерги, разом 12 груп. Світло вимикають по черзі, тож у кожну годину без світла лише частина груп. У Києві ДТЕК використовує окрему схему до 60 груп.

Як дізнатися свою чергу?

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

Чи можна знайти чергу за адресою?

Частково. На карті, у блоці «Ваш дім», є пошук «Знайти за адресою»: область, місто, вулиця, будинок. Він працює лише для областей зі списку, який віддає сервер (зараз це Київ і Дніпро, дані Yasno). Адресу ми не зберігаємо, лишається тільки номер черги. Якщо пошук недоступний або вашої області немає, оберіть чергу вручну.

Чи потрібна реєстрація?

Ні. Карту, графіки та історію можна дивитися без входу. Для нагадувань потрібен лише Telegram або дозвіл на сповіщення в браузері.

Чи сервіс працює в моєму місті?

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

Точність і статуси

Наскільки точна карта?

Настільки, наскільки точний графік оператора, і лише на рівні черги та області. Ми не обіцяємо точності до будинку. Якщо графік і реальність розходяться, це може показати статус «Можливе відключення» або аварійний режим.

Що означає «Можливе відключення»?

Оператор позначив час як можливий, а не гарантований, або сигнали суперечать графіку і жодна сторона не переважає. Це не «світло є» і не «світла немає», а чесне «може бути».

Чому для моєї області «Даних немає»?

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

Чому «Очікуване повернення» не збіглося з реальністю?

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

Що означає «застаріло»?

Дані оператора старіші за 45 хвилин. Це попередження про те, що оператор давно нічого не публікував, а не помилка карти.

Чим ваша карта відрізняється від сайту оператора?

Оператор показує свій графік. Ми зводимо графіки багатьох операторів на одну карту, зберігаємо історію їх змін і додаємо незалежні сигнали, якщо вони є. Але першоджерело графіка завжди оператор.

Сповіщення і Telegram-бот

Чи є push-сповіщення?

Так, у браузері. У блоці «Ваш дім» увімкніть «Сповіщення в браузері», дозвольте їх у вікні браузера, і ми попередимо за 15, 30 чи 60 хвилин до відключення вашої черги. Це Web Push: працює в Chrome, Edge, Firefox і Safari. Окремого застосунку для цього не потрібно.

Чому на iPhone не можна ввімкнути сповіщення?

iOS дозволяє сповіщення з сайтів лише для сайтів, доданих на екран «Додому». У Safari натисніть «Поділитися», потім «На екран “Додому”», відкрийте SvitloPulse з іконки й увімкніть сповіщення там. До цього кнопка покаже підказку. Telegram працює без цього.

Як вимкнути сповіщення в браузері?

Вимкніть перемикач у блоці «Ваш дім»: підписка видаляється з нашого сервера й браузера. Можна також заборонити сповіщення для сайту в налаштуваннях браузера.

Як підписатися на нагадування?

Відкрийте бота, оберіть область, оператора і чергу. Швидший спосіб: натисніть «Підписатися» на сторінці черги, і бот створить підписку за одноразовим посиланням, дійсним 30 хвилин.

Які нагадування надсилає бот?

За обраний час до вимкнення (від 5 до 180 хвилин, до трьох нагадувань), коли світло вимкнули за графіком з очікуваним часом повернення, коли воно має повернутися, а також коли опубліковано графік на завтра чи діють аварійні відключення.

Чи можна вимкнути нічні повідомлення?

Так, командою /quiet 23-7 (години за Києвом). Вимкнути тихі години можна командою /quiet off.

Скільки підписок можна мати?

До 10. Зайві можна видалити командою /my.

Віджети і датчики

Чи є віджети?

Для сайтів, README і розумного дому є бейдж (SVG), картка для iframe і приклад для Home Assistant: усе на сторінці «Віджети і бейджі». Нативних віджетів для екрана iOS чи Android немає.

Чи можна підключити датчик світла вдома?

Так. Роутер, Raspberry Pi, ESP32 чи Home Assistant раз на хвилину відправляє запит на секретну адресу, а коли запити зникають, світла, ймовірно, немає. Інструкції та створення датчика на сторінці «Датчик світла». Один датчик публічно нічого не змінює: окремі датчики ми не показуємо, а сигнал враховується, коли його надсилають щонайменше п’ять датчиків однієї черги.

Приватність і дані

Що ви знаєте про мене?

Для нагадувань у Telegram — ідентифікатор чату та обрані черги. Для сповіщень у браузері — технічну адресу підписки вашого браузера й обрану чергу. Для датчика — токен і чергу. Для обговорень і звітів — анонімний cookie пристрою. Адресу, яку ви вводите для пошуку черги, ми не зберігаємо. Ми не просимо ім’я, телефон, адресу чи геолокацію.

Як видалити свої дані?

Команда /forget у боті видаляє ваші підписки та дані з Telegram. Сповіщення в браузері вимикаються перемикачем у блоці «Ваш дім». Датчик видаляється на сторінці «Датчик світла» за його токеном. Cookie пристрою можна видалити в налаштуваннях браузера.

Чому ви не показуєте підстанції та точні адреси?

Карта підстанцій і ліній була б картою цілей, а окремий сигнал — це чиясь домівка. Тому публічні дані агреговані до черги й області, а сигнали з’являються із затримкою щонайменше 30 хвилин і лише коли їх не менше п’яти.

Для розробників

Чи є API?

Так, відкрите JSON API без ключа: /api/v1. Є ліміти запитів на IP. Опис — на сторінці API.

Чи є ключі, вищі квоти й вебхуки?

Так, для тих, кому потрібне більше за безкоштовні ліміти: ключі, орієнтовні квоти й вебхуки про початок відключення, повернення світла та зміну графіка. Ключі видає оператор сервісу вручну, оплат і SLA немає, а для комерційного використання спершу треба узгодити ліцензування даних операторів. Деталі на сторінці «Для розробників».

Як повідомити про помилку в даних?

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

Докладніше: як це працює, джерела даних, приватність, API.