Справочный центр Wialon
Wialon для разработчиков Руководство пользователя Документация API unit update_drive_rank_settings

update_drive_rank_settings

Чтобы обновить критерии качества вождения объекта, используйте метод unit/update_drive_rank_settings.

Конечная точка

Copied!
svc=unit/update_drive_rank_settings&params={
    "itemId": <long>,
    "driveRank": {
        "acceleration": [
            {
                "flags": <uint>,
                "min_value": <double>,
                "max_value": <double>,
                "min_speed": <uint>,
                "max_speed": <uint>,
                "min_duration": <uint>,
                "max_duration": <uint>,
                "validator_id": <long>,
                "name": <text>,
                "penalties": <uint>
            },
            ...
        ],
        "brake": [
            {
                "flags": <uint>,
                "min_value": <double>,
                "max_value": <double>,
                "min_speed": <uint>,
                "max_speed": <uint>,
                "min_duration": <uint>,
                "max_duration": <uint>,
                "validator_id": <long>,
                "name": <text>,
                "penalties": <uint>
            },
            ...
        ],
        "turn": [
            {
                "flags": <uint>,
                "min_value": <double>,
                "max_value": <double>,
                "min_speed": <uint>,
                "max_speed": <uint>,
                "min_duration": <uint>,
                "max_duration": <uint>,
                "validator_id": <long>,
                "name": <text>,
                "penalties": <uint>
            },
            ...
        ],
        "sensor": [
            {
                "flags": <uint>,
                "min_value": <double>,
                "max_value": <double>,
                "min_speed": <uint>,
                "max_speed": <uint>,
                "min_duration": <uint>,
                "max_duration": <uint>,
                "validator_id": <long>,
                "sensor_id": <long>,
                "name": <text>,
                "penalties": <uint>
            },
            ...
        ],
        "speeding": [
            {
                "flags": <uint>,
                "min_value": <double>,
                "max_value": <double>,
                "min_speed": <uint>,
                "max_speed": <uint>,
                "min_duration": <uint>,
                "max_duration": <uint>,
                "validator_id": <long>,
                "name": <text>,
                "penalties": <uint>
            },
            ...
        ],
        "harsh": [
            {
                "flags": <uint>,
                "min_value": <double>,
                "max_value": <double>,
                "min_speed": <uint>,
                "max_speed": <uint>,
                "min_duration": <uint>,
                "max_duration": <uint>,
                "validator_id": <long>,
                "name": <text>,
                "penalties": <uint>
            },
            ...
        ],
        "idling": [
            {
                "flags": <uint>,
                "min_value": <double>,
                "max_value": <double>,
                "min_speed": <uint>,
                "max_speed": <uint>,
                "min_duration": <uint>,
                "max_duration": <uint>,
                "validator_id": <long>,
                "name": <text>,
                "penalties": <uint>
            },
            ...
        ],
        "global": {
            "accel_mode": <uint>
        }
    }
}

Параметры

Запрос должен содержать следующие параметры:

Параметр Описание
itemId ID объекта.
driveRank Объект с критериями качества вождения (см. Критерии качества вождения). Объект заменяет все текущие настройки качества вождения объекта, поэтому критерии, которые вы не укажете, удаляются. Чтобы удалить все критерии, передайте пустой объект.

Критерии качества вождения

Каждый тип критерия — это массив критериев. Укажите только те типы, которые вам нужны.

Параметр Описание
acceleration Ускорение.
brake Торможение.
turn Поворот.
sensor Произвольный критерий на основе показаний датчика.
speeding Превышение скорости.
harsh Резкое вождение.
idling Холостой ход.
global Объект с общими настройками. Содержит параметр accel_mode, который задает метод расчета ускорения:
  • 0 — GPS и параметры качества вождения (по умолчанию);
  • 1 — GPS;
  • 2 — Параметры качества вождения.

Настройки критерия

Параметр Описание
flags Флаги:
  • 1 — усреднение штрафа по времени;
  • 2 — усреднение штрафа по пробегу;
  • 4 — использовать валидатор как множитель (опция Мультипликатор);
  • 8 — регистрировать нарушения по данным устройства (опция Нарушения по устройству). Используется только для критерия sensor с цифровым датчиком. Нарушение начинается, когда датчик включается, и заканчивается, когда он выключается.
min_value Минимальное значение критерия. Единица измерения зависит от критерия:
  • speeding — км/ч или мили в час, если у объекта американская или имперская система измерения;
  • acceleration, brake, turn, harsh — g;
  • idling — секунды;
  • sensor — значения выбранного датчика.
max_value Максимальное значение критерия (не включается). Единица измерения та же, что и для min_value.
min_speed Минимальная скорость в км/ч или в милях в час, если у объекта американская или имперская система измерения.
max_speed Максимальная скорость (не включается) в тех же единицах измерения, что и min_speed.
min_duration Минимальная длительность нарушения в секундах.
max_duration Максимальная длительность нарушения в секундах. Если нарушение длится дольше, оно учитывается как несколько нарушений: по одному на каждый интервал max_duration, включая последний, более короткий.
validator_id ID датчика-валидатора.
sensor_id ID датчика. Используется только для критерия sensor.
name Имя критерия.
penalties Штрафные баллы.

Ответ

При успешном выполнении запроса возвращается пустой объект:

Copied!
{}

Если запрос выполнить не удалось, возвращается код ошибки.

Коды ошибок

Код ошибки Описание
4 Неверные входные параметры, например параметр driveRank не указан или не является объектом.
6 Не удалось обновить критерии качества вождения.
7 Объект не существует, или у пользователя нет права доступа Редактирование настроек поездок, вождения и диагностики на него.

Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.