Приложение за средна скорост - Андроид

[ivo1bg]

Здравейте колеги. След известно време, не малко, успях да сътворя едно малко, но за мен много удобно приложение за Андроид, което автоматично измерва средната скорост в определените отсечки. По- долу Ви давам кратко ръководство и обяснения и разбира се, който иска е свободен да го ползва.
Speedometer v1.09

# Ръководство за ползване на Speedometer

## Какво е приложението?

**Speedometer** е Android приложение за измерване на скоростта при шофиране. Показва скоростта в кръгъл бутон, който стои върху другите приложения. Поддържа **моментна** и **средна** скорост, както и автоматично разпознаване на отсечки по маршрутите с ограничения.

---

## Стартиране

1. Отворете приложението.
2. Разрешете **показване върху други приложения** (overlay permission) — необходимо е за да може бутонът да се вижда.
3. Разрешете **достъп до локация** (GPS).
4. На Android 13+ — разрешете **известия** (за foreground услугата).
5. След разрешенията приложението се затваря и започва да работи в background. В notification bar ще видите „Speedometer работи“.

---

## Бутонът

### Показване

- **Зелен кръг** = режим **моментна скорост** — показва текущата скорост в km/h.
- **Син кръг** = режим **средна скорост** — показва средната скорост от влизането в отсечката.
- При надвишаване на ограничението в режим средна скорост текстът става **червен**.


### Управление

- **Докосване** (tap) — превключва между моментна и средна скорост.
- **Дълго натискане** (около 0,8 сек) — отваря менюто.
- **Плъзгане** (drag) — премества бутона по екрана.

---

## Меню


Отваря се с **дълго натискане** върху кръга.

### Опции в менюто

| Бутон | Описание |
|-------|----------|
| **Размер на бутона** | Плъзгач за промяна на размера на бутона (60–120 dp). |
| **Затвори МЕНЮ** | Затваря менюто. бутонът остава активен. |
| **Преглед на отсечките** | Отваря карта с всички отсечки. |
| **Обнови отсечките** | Зарежда отсечките от Google Drive и обновява маршрутите чрез OSRM. |
| **Докладване на нови отсечки** | Изпраща предложение за нова отсечка (старт, край, макс. скорост) към разработчика. |
| **Език** | Избор между български и английски. |
| **Дарение** | Информация за подкрепа на проекта и линк към PayPal. |
| **Изход от приложението** | Спира overlay услугата и затваря приложението. |

---

## Отсечки

### Какво са отсечките?
Отсечките са участъци от път със зададено ограничение на скоростта. Когато влезете в отсечка, приложението автоматично преминава в режим **средна скорост** и следи дали не надвишавате ограничението.

### Автоматично поведение

- **Влизане в отсечка** — показва съобщение „Влизате в: [име] и превключва на средна скорост.
- **Излизане от отсечка** — показва „Излизате от: [име] и връща моментна скорост.
- **Приближаване до края** — кръгът започва да мига като напомняне.
- **При превишаване на ограничението текстът става червен. След ъпдейта, вече има и звуков сигнал на всяка 1 минута.

### Откъде идват отсечките?

- Данните се синхронизират с **Google Drive** (Обнови отсечките).
- Маршрутите се изчисляват чрез **OSRM** (Open Source Routing Machine) — нужен е интернет при първо зареждане.

### Преглед на картата

„Преглед на отсечките“ показва карта с всички отсечки:
- **Син** — маршрутът е зареден.
- **Сив** — маршрутът все още се зарежда.

---

## Докладване на нови отсечки

Ако забележите участък от път с ограничение, който липсва в приложението, можете да го докладвате:

1. Меню → **Докладване на нови отсечки**.
2. Попълнете:
- **Старт** — координати (`42.69, 23.32`) или име на място.
- **Край** — координати или име на място.
- **Координати (опция)** — допълнителни точки във формат `лат,лонг;лат,лонг;…` (по избор).
- **Макс. скорост (km/h)** — ограничението в km/h (напр. 50, 90, 140).
3. Натиснете **Изпрати**.

Данните се изпращат анонимно към разработчика и помагат за разширяване на базата отсечки. Нужен е интернет при изпращане.

---

## Обновяване на отсечките

1. Отворете менюто (дълго натискане).
2. Натиснете **Обнови отсечките**.
3. Изчакайте съобщението „Обновени X отсечки“.
4. Има нужда от интернет — данните се взимат от Google Drive и OSRM.

---

## Език

В менюто изберете **Език** и след това **Български** или **English**. Промяната влиза в сила след презареждане на приложението.

---

## Известия

В notification bar винаги има известие „Speedometer работи“. Докосването му може да отвори менюто (в зависимост от устройството).

---

## Разрешения

| Разрешение | Защо е нужно |
|------------|--------------|
| Показване върху други приложения | Бутонът се вижда и е над всички отворени приложения. Под него може да има отворена навигация или плейър, няма значение, Вие ще имате информацията, която Ви е нужна. |
| Локация (GPS) | Измерване на скоростта. |
| Интернет | Синхронизация с Drive и OSRM маршрути. | Нужен е само при инсталирането за да зареди данните за отсечките и при обновяването им.
| Известия (Android 13+) | Foreground услугата да работи. |

---

## Често срещани въпроси

**Как да спра приложението?**
Меню → Изход от приложението.

**Защо кръгът не се вижда?**
Проверете дали е разрешено „Показване върху други приложения“ в настройките на Android.

**Как да добавя свои отсечки?**
Отсечките се конфигурират чрез синхронизация с Google Drive (Обнови отсечките). Можете и да използвате **Докладване на нови отсечки** — предложенията се изпращат към разработчика.

**Работи ли без интернет?**
Да. Скоростта се измерва с GPS. Маршрутите се използват от кеш, ако вече са заредени.

Ако забележите грешки или странно поведение на приложението, моля пишете ми.
За сега приложението съм го тествал само на телефони Samsung. Надявам се да тръгне и на други марки, въпреки, че с Motorola има макло усложнение заради изискванията им за сигурност.
Лек и безавариен път!

UPDATE - v1.09
**Добавено звуково предупреждение при превишаване на разрешената средна скорост в дадената отсечка.
- Предупреждението се чува на всяка минута.
- Добавен бутон за Вкл/Изкл. на звуковото предупреждение.

**Добавена е възможност за избор на МПС.
- Различните МПС-та имат различна разрешена средна скорост. В менюто има възможност за избор на Кола - А,А2,В; Малки автобуси и леки камиони - BE,C1,C1E,D,D1,D1E,DE; Тежки камиони и големи автобуси- C и CE.

Speedometer v1.09

[streetz Профил]

От 83 км до 172 км на АМ Тракия като една отсечка ли го отчита, или поотделно за всяка от шестте показва средна скорост?

[Lenco Профил]

Отделни отсечки са, мери се на 6 части, така мери толтракера, поне докато мереше, че нещо се бъгна.

[ivo1bg]

От 83 км до 172 км на АМ Тракия като една отсечка ли го отчита, или поотделно за всяка от шестте показва средна скорост?

Там отчита 6 отсечки. Ще изписва на екрана в коя се влиза и от коя се излиза. Отчитането на средната скорост е за всяка отсечка поотделно.

[Kroki]

пускай и за iOS

[ivo1bg]

С удоволствие, но нямам никаква представа от таз ОС. Не че от Андроид имам де, ама е мааалко по-добра. Инак ИИ ми е първи помощник

[BorislavB Профил]

Аз питах в СПАМ ТЕМАТА, ама никой нищо не каза, та да питам тук. Има ли изобщо някой глобен за средна скорост или е някакъв мит, поне аз не съм чувал за някой глобен досега, като изключвам тия дето ги дават по новините, защото там може да кажат,че си карал и с 400 по магистралата...

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

[ivo1bg]

Това, че за сега не знаем за хора изгорели, не означава, че в един момент няма да почнат да валят фишовете. И за този момент ние трябва да сме готови .

[Don_Diego Профил]

Аз питах в СПАМ ТЕМАТА, ама никой нищо не каза, та да питам тук. Има ли изобщо някой глобен за средна скорост или е някакъв мит, поне аз не съм чувал за някой глобен досега, като изключвам тия дето ги дават по новините, защото там може да кажат,че си карал и с 400 по магистралата...

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

Има!

Снощи се видях с приятел и се оплака, че са му докарали един кашон с честитки .
Няколко негови търговци дето пътуват доста са били с по 10+ честитки за средна скорост на ден като карат по Тракия...Всички честитки били за 10+км/ч превишение на средната скорост

[c04 Профил]

Много добре изглежда, ще се тества!