Модуль «Качество вождения» предназначен для фиксации нарушений в процессе эксплуатации транспортного средства. Пользователь может самостоятельно задать критерии оценки стиля вождения и определить штрафные баллы за их нарушения.
После настройки и применения шаблона критериев к объекту становится доступен подробный анализ действий водителя: система показывает, какие именно нарушения были зафиксированы.
Поиск данных можно выполнять как по конкретному водителю, так и по объекту.
Получение происходит по адресу:
https://sputnic.tech/mobile_api/getViolationsDriver/{id}
Где id - идентификатор водителя
Тело запроса должно содержать временной интервал поиска нарушений и должно выглядеть следующим образом:
{
"ds" : временная метка,
"de" : временная метка
}ds - дата начала
de - дата конца
Формат даты:
"ГГГГ-ММ-ДДTЧЧ:ММ" - "2025-01-01T00:00"
Формат ответа
{
"type": "driver",
"id": 59,
"violations": [
{
"id_dev": 310,
"id_driver": 59,
"id_criteria": 5,
"name": "Превышение скорости",
"datetime": "2025-01-21 11:21:21+04",
"geo_point": [
53.574636,
49.320808
],
"reserve": {
"0": 0,
...
},
"speed": 10,
"direction": 67,
"fine": 100,
"averaged_fine": "100"
}
],
"dashboards": {
"dashboadDev": {
"310": 1,
"count": 1
},
"dashboardViolation": {
"count": 1,
"Превышение скорости": 1
},
"score": 6.142306043720532,
"distance": 24.97,
"duration": 2850,
"name_driver": "Владимир"
}
}
| Поле | Описание |
type |
тип поиска нарушений |
id |
ид водителя, по которому был выполнен поиск нарушений |
violations |
массив с найденными нарушениями |
dashboards |
массив, содержащий информацию для отрисовки дашбордов и отрисовки оценок качества вождения водителей |
Нарушения - violations
| Поле | Описание |
id_dev |
id объекта, на котором было выявлено нарушения |
id_driver |
id водителя, который управлял объектом |
id_criteria |
id критерия вождения, по которому было совершено нарушение |
name |
названия критерия |
datetime |
время зафиксированного нарушения |
geo_point |
местоположение объекта в момент нарушения |
reserve |
массив с показателями датчиков объекта на момент нарушения |
speed |
скорость объекта на момент нарушения |
direction |
направление объекта на момент нарушения |
fine |
кол-во штрафных очков за совершение нарушение |
averaged_fine |
усредненное кол-во штрафных очков за совершение нарушение |
Дашборды - dashboards
| Поле | Описание |
dashboadDev |
Массив содержащий информацию о количестве нарушений на разных объектах id объекта : количество наршуений + count : число (общее количество нарушений на всех объектах) |
dashboardViolation |
Массив содержащий информацию о нарушениях, найденных за период поиска “Название нарушения” : количество нарушений + count : число (общее количество нарушений) |
score |
Оценка качества вождения по 10-ти балльной системе |
distance |
Пройденное количество км за период поска нарушений |
duration |
Время на маршруте (в минутах) |
name_driver |
Имя водителя |
Получение происходит по адресу:
https://sputnic.tech/mobile_api/getViolationsDevice/{id}
Где id - идентификатор объекта
Тело запроса должно содержать временной интервал поиска нарушений и должно выглядеть следующим образом:
{
"ds" : временная метка,
"de" : временная метка
}ds - дата начала
de - дата конца
Формат даты:
"ГГГГ-ММ-ДДTЧЧ:ММ" - "2025-01-01T00:00"
Формат ответа
{
"type": "device",
"id": 310,
"violations": [
{
"id_dev": 310,
"id_driver": 59,
"id_criteria": 5,
"name": "Превышение скорости",
"datetime": "2025-01-21 11:21:21+04",
"geo_point": [
53.574636,
49.320808
],
"reserve": {
"0": 0,
...
},
"speed": 10,
"direction": 67,
"fine": 100,
"averaged_fine": "100"
}
],
"dashboards": {
"dashboadDriver": {
"59": 1,
"count": 1,
"unknown": 0
},
"dashboardViolation": {
"count": 1,
"Превышение скорости": 1
},
"score": 6.142306043720532,
"distance": 24.97,
"duration": 2874.97,
"name_dev": "ЛАРГУС тольятти.",
"icon": "ZQ-1 (31).png"
}
}
| Поле | Описание |
type |
тип поиска нарушений |
id |
ид объекта, по которому был выполнен поиск нарушений |
violations |
массив с найденными нарушениями |
dashboards |
массив, содержащий информацию для отрисовки дашбордов и отрисовки оценок качества вождения водителей |
Нарушения - violations
| Поле | Описание |
id_dev |
id объекта, на котором было выявлено нарушения |
id_driver |
id водителя, который управлял объектом |
id_criteria |
id критерия вождения, по которому было совершено нарушение |
name |
названия критерия |
datetime |
время зафиксированного нарушения |
geo_point |
местоположение объекта в момент нарушения |
reserve |
массив с показателями датчиков объекта на момент нарушения |
speed |
скорость объекта на момент нарушения |
direction |
направление объекта на момент нарушения |
fine |
кол-во штрафных очков за совершение нарушение |
averaged_fine |
усредненное кол-во штрафных очков за совершение нарушение |
Дашборды - dashboards
| Поле | Описание |
dashboadDriver |
Массив содержащий информацию о количестве нарушений на разных объектах id водителя : количество нарушений + unknown : количество нарушений совершенных неустановленным водителем + count : число (общее количество нарушений на всех объектах) |
dashboardViolation |
Массив содержащий информацию о нарушениях, найденных за период поиска “Название нарушения” : количество нарушений + count : число (общее количество нарушений) |
score |
Оценка качества вождения по 10-ти балльной системе |
distance |
Пройденное количество км за период поска нарушений |
duration |
Время на маршруте (в минутах) |
name_dev |
Имя объекта |
icon |
Название иконки объекта |