Wialon para desarrolladores Manual de usuario Documentación de API unit update_drive_rank_settings

update_drive_rank_settings

Para actualizar los criterios de conducción eficiente de una unidad, utilice el método unit/update_drive_rank_settings.

Endpoint

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>
        }
    }
}

Parámetros

La solicitud debe contener los siguientes parámetros:

Parámetro Descripción
itemId ID de la unidad.
driveRank Objeto con los criterios de conducción eficiente (ver Criterios de conducción eficiente). El objeto reemplaza toda la configuración actual de conducción eficiente de la unidad, por lo que se eliminan los criterios que no incluya. Para eliminar todos los criterios, envíe un objeto vacío.

Criterios de conducción eficiente

Cada tipo de criterio es un arreglo de criterios. Incluya solo los tipos que necesite.

Parámetro Descripción
acceleration Aceleración.
brake Frenado.
turn Giro.
sensor Criterio personalizado basado en los valores del sensor.
speeding Exceso de velocidad.
harsh Conducción imprudente.
idling Ralentí.
global Objeto con la configuración general. Contiene el parámetro accel_mode, que define el método de cálculo de la aceleración:
  • 0: GPS y parámetros de conducción eficiente (predeterminado);
  • 1: GPS;
  • 2: Parámetros de conducción eficiente.

Configuración del criterio

Parámetro Descripción
flags Flags:
  • 1: promediar las penalizaciones por tiempo;
  • 2: promediar las penalizaciones por kilometraje;
  • 4: usar el validador como multiplicador (la opción Multiplicador);
  • 8: registrar las infracciones desde el dispositivo (la opción Violaciones por dispositivo). Se utiliza solo para el criterio sensor con un sensor digital. La infracción empieza cuando el sensor se activa y termina cuando se desactiva.
min_value Valor mínimo del criterio. La unidad de medida depende del criterio:
  • speeding: km/h, o mph si la unidad utiliza el sistema de medida estadounidense o imperial;
  • acceleration, brake, turn, harsh: g;
  • idling: segundos;
  • sensor: los valores del sensor seleccionado.
max_value Valor máximo del criterio (no incluido). La unidad de medida es la misma que para min_value.
min_speed Velocidad mínima, en km/h, o en mph si la unidad utiliza el sistema de medida estadounidense o imperial.
max_speed Velocidad máxima (no incluida), en la misma unidad de medida que min_speed.
min_duration Duración mínima de la infracción, en segundos.
max_duration Duración máxima de la infracción, en segundos. Si una infracción dura más, se cuenta como varias infracciones: una por cada intervalo de max_duration, incluido el último, más corto.
validator_id ID del sensor validador.
sensor_id ID del sensor. Se utiliza solo para el criterio sensor.
name Nombre del criterio.
penalties Puntos de penalización.

Respuesta

Si la solicitud se completa con éxito, se devuelve un objeto vacío:

Copied!
{}

Si la solicitud falla, se devuelve un código de error.

Códigos de error

Código de error Descripción
4 Parámetros de entrada incorrectos, por ejemplo, falta el parámetro driveRank o no es un objeto.
6 No se pudieron actualizar los criterios de conducción eficiente.
7 La unidad no existe o el usuario no tiene el derecho de acceso Modificar ajustes de viajes, conducción y Diagnóstico a ella.

Si nota un error en el texto, por favor resáltelo y presione Ctrl+Intro.