Перейти к основному содержимому

Получение данных статистики

Метод выводит данные статистики по выбранному детектору.

Пример запроса:

<url_smartroad>/api/<version>/stat?login=<login>&password=<password>&sensor_id=<sensor_id>

Схема данных ответа

При поступлении корректного запроса Система формирует ответное сообщение в формате JSON.

Пример ответа:

{
"time_zone": "Europe/Moscow",
"message_id": "7bb6e560-fbf2-0cf7-3979-198f50651e3c",
"message_data": [
{
"data": [
{
"lanes": [
{
"lane": 0,
"volume": 1,
"class_0": 0,
"class_1": 1,
"class_2": 0,
"class_3": 0,
"class_4": 0,
"class_5": 0,
"gap_avg": 0,
"gap_sum": 0,
"speed_avg": 3.9600000381469727,
"headway_avg": 0,
"headway_sum": 0,
"speed85_avg": 3.96,
"occupancy_per": "0000-00-00 00:00:04",
"occupancy_prc": 14.848484992980957,
"occupancy_sum": 4.4545455
},
{
"lane": 1,
"volume": 0,
"class_0": 0,
"class_1": 0,
"class_2": 0,
"class_3": 0,
"class_4": 0,
"class_5": 0,
"gap_avg": 0,
"gap_sum": 0,
"speed_avg": 0,
"headway_avg": 0,
"headway_sum": 0,
"speed85_avg": 0,
"occupancy_per": "0000-00-00 00:00:00",
"occupancy_prc": 0,
"occupancy_sum": 0
}
],
"range_end": "2025-03-06T13:00:30+03:00",
"range_start": "2025-03-06T13:00:00+03:00",
"range_value": 1,
"range_status": {
"status": "ok",
"status_duration": "0000-00-00 00:00:00",
"status_code_list": [
1
],
"sensor_work_ratio": 100
}
}
],
"name": "Олимпийский Т-35",
"connected": true,
"direction": 1,
"sensor_id": "67052a06-1075-4576-a328-598e2ef550d5",
"lane_direction": [
0,
1
]
}
],
"protocol_version": "1.0"
}

Схема данных Json ответа запроса stat

Параметр ответаТип данных ответаОписание параметра
time_zoneстрокаЧасовой пояс, указанный в профиле пользователя
message_idстрока (формат: uuid)Уникальный идентификатор сообщения
message_dataмассивТело сообщения
protocol_versionстрокаВерсия API
dataмассивСписок данных статистики по полосам за выбранный промежуток времени
nameстрокаНазвание детектора
connectedстрокаСтатус подключения детектора
directionстрокаНаправление детектора
sensor_idстрокаУникальный идентификатор детектора
lane_directionмассив целых чиселСписок направления полос движения
lanesмассивСписок данных статистики по каждой полосе
laneцелое числоНомер полосы
volumeцелое числоФизическое количество транспортных средств за период измерения
class_Nцелое числоКоличество зафиксированных ТС определенного класса в зависимости от длины ТС.
gap_avgчислоСредний интервал движения за период, с.
gap_sumчислоИтоговый интервал движения за период, с.
speed_avgчислоСредняя скорость потока (км/ч)
headway_avgчислоСредний интервал движения, с.
headway_sumчислоИтоговый интервал движения, с.
speed85_avgчислоСкорость 85%-ной обеспеченности потока
occupancy_perстрока (формат: date-time)Загруженность полосы движения в заданный период, общее время
occupancy_prcчислоЗагруженность полосы движения в заданный период, процент
occupancy_sumчислоЗагруженность полосы движения в заданный период, с
range_endстрока (формат: date-time)Конец временного интервала
range_startстрока (формат: date-time)Начало временного интервала
range_valueстрокаНомер периода во временном интервале

Описание параметров ответа stat

Параметр ответаРасчет параметров/значение по умолчанию
class_NЧисло классов и параметры длин ТС для каждого класса задаются в настройках Системы
gap_avg, gap_sumЗамер производится между передним бампером первого ТС и задним бампером второго ТС
headway_avg, headway_sumЗамер производится между задним бампером первого ТС и задним бампером второго ТС