Как събираме, проверяваме и показваме данните

1. Източници

БГТОЛ – интензивност на трафика

Използват се агрегирани данни от стационарните контролни точки. За всяка точка се обработват идентификатор, име, координати, посока, брой преминавания за последните 15 минути и брой преминавания за последния час. Синхронизацията е настроена през 15 минути.

БГТОЛ – пътна метеорология

Метеорологичният поток се пази отделно от трафика. Обработват се идентификатор и координати на станцията, температура на въздуха, температура на пътната настилка, относителна влажност и атмосферно налягане. Липсваща стойност се записва като липсваща, а не като нула.

МВР – пътнотранспортни произшествия

Наборът се открива през публичния REST API на production портала data.egov.bg. Конекторът търси публикувания набор за актуални ПТП от 1 януари 2024 г. до момента, избира последния достъпен ресурс и получава данните чрез машинен API или директния ресурсен адрес. Не се използва testdata.egov.bg.

2. Проверка преди запис

Всеки конектор има собствен валидатор. Трафик ресурс не се приема само защото съдържа координати – задължително трябва да има разпознаваеми трафик стойности. Метеорологичен ресурс трябва да съдържа поне един от измерваните показатели. ПТП ресурсът трябва да съдържа списък с реални записи.

Координатите извън приблизителните граници на България се отхвърлят. Помощни картографски обекти, празни записи и HTML страници не се записват като данни.

3. Нормализиране

Различните имена на полета се преобразуват към единен вътрешен модел. Например count15min и count1Hour се пазят като стойности за 15 и 60 минути, а air и surface – като температура на въздуха и настилката. Оригиналният формат не определя начина на показване.

Датите се преобразуват към часовата зона Europe/Sofia. Когато източникът публикува UTC време, то се конвертира преди показване.

4. Дублиране и история

Трафик и метеорологично измерване са уникални по станция и момент на измерване. Повторното получаване на същия запис не създава нов ред. ПТП са уникални по идентификатор на източника; когато такъв липсва, се формира стабилен технически ключ от дата, място и координати.

Историческите измервания не се заменят с последната стойност. Така могат да се правят сравнения по час, ден, седмица, сезон и година.

5. Нула и липсващи данни

Нула означава, че източникът е подал стойност 0. Няма данни означава, че няма валидно измерване. Тези две състояния се показват различно. Точка без измерване не се обозначава автоматично като „нормално натоварване“.

6. Нива на натоварване

В първия етап нивата служат за визуална ориентация. Когато има надежден капацитет или достатъчна история за конкретната точка, оценката се прави спрямо нейното обичайно натоварване. Докато такава база липсва, се използват временни общи прагове и това се отбелязва.

Сборът на стойностите от различни точки не е брой уникални автомобили. Едно превозно средство може да премине през повече от една контролна точка.

7. Пътни условия

Температурата на настилката е по-подходяща за оценка на възможно заледяване от общата прогноза за близък град. BGTraffic.eu ще маркира условия за повишено внимание при ниска температура на настилката и висока влажност, но няма да твърди, че има заледяване без пряко измерване или официално съобщение.

8. ПТП и рискови участъци

Картата на ПТП показва публикуваните от МВР записи с налични координати. Бъдещият индекс за риск няма да се базира само на абсолютния брой произшествия. Ще се отчита и приблизителният обем на трафика, тежестта на ПТП, часът, пътните условия и дължината на разглеждания период.

9. Смарт анализи и AI функции

Смарт функциите ще използват натрупаната история за откриване на отклонения, краткосрочна прогноза, препоръчителен прозорец за тръгване и приоритизиране на известия. Всеки резултат ще бъде обозначен като измерване, изчисление или прогноза.

Текстовите обобщения ще се формират от структурирани стойности и няма да добавят непотвърдени събития. Когато данните са недостатъчни, системата ще показва, че не може да направи надеждна оценка.

10. Ограничения

• Контролните точки не покриват всяка отсечка и не дават непрекъснато време за пътуване.
• Отделни станции или ресурси могат временно да спрат да се обновяват.
• Координати и описания в първичните данни могат да бъдат непълни или неточни.
• BGTraffic.eu не е официален източник за затваряне на пътища или действия при извънредна ситуация.

11. Прозрачност и корекции

В администрацията се пазят последен успешен импорт, HTTP статус, размер на отговора, брой обработени записи и конкретната грешка при неуспех. При установен проблем грешните записи се изчистват по източник, без да се засягат останалите данни.