update_units

Para agregar, eliminar o limpiar unidades monitoreadas en la sesión, utilice el método events/update_units.

Para monitorear recursos además de unidades, utilice events/update_items. Para nuevas integraciones, utilice events/update_items.

El formato de la solicitud depende del modo de operación.

Para agregar unidades específicas a la sesión, utilice la siguiente solicitud:

svc=events/update_units&params={
  "mode": "add",
  "units": [
    {
      "id": <long>,
      "detect": {
        "<detector_name>": <long>
      }
    },
    ...
  ],
  "evt_flags": <uint>   /* opcional */
}

Para eliminar unidades específicas de la sesión, utilice la siguiente solicitud:

svc=events/update_units&params={
  "mode": "remove",
  "units": [
    <long>
  ]
}

Para eliminar todas las unidades de la sesión, utilice la siguiente solicitud:

svc=events/update_units&params={
  "mode": "clear"
}

Los siguientes detectores de eventos se pueden configurar en el objeto detect. Para cada detector, especifique un valor de filtro que seleccione los eventos a monitorear: un ID o tipo específico, o 0 para monitorear todos los eventos de este detector.

"detect":{"<detector_name>":<filter_value>}

La tabla enumera los detectores disponibles para unidades. Para monitorear asignaciones de conductores registradas en un recurso, utilice el detector resource_drivers con events/update_items y especifique un ID de recurso.

Los detectores battery_level, charge y ev utilizan las siguientes configuraciones del sensor del nivel de batería: Calcular datos según el sensor, Tipo de filtración, Volumen mínimo de carga (kWh), Detectar recargas solo cuando el vehículo está parado y Tiempo de espera para separar recargas consecutivas. Si Calcular datos según el sensor está deshabilitada, no se registran eventos para el sensor.

Los detectores registran el nivel de batería y las recargas, pero no las descargas de batería. No se tienen en cuenta el modelo matemático de consumo, los sensores del motor ni los sensores del coeficiente de temperatura.

El detector eco_driving no está disponible en Wialon Local.

Para agregar todos los detectores de eventos disponibles, utilice:

"detect":{"*":0}

En el modo add, solo se agregan las unidades a las que el usuario actual tiene acceso de visualización. Si una unidad listada ya está siendo monitoreada, su configuración de detectores se reemplaza. Los valores de filtro de detectores individuales no válidos se ignoran.

El valor de evt_flags se almacena en la sesión y controla cómo se entregan las actualizaciones de eventos. Su valor por defecto es 0.

Combine los flags de detalle a continuación con 0x200. Si no se especifican flags de detalle, se utiliza el valor 0x7 (0x1 | 0x2 | 0x4).

Por ejemplo, evt_flags = 0x207 habilita el modo units_update (0x200) con datos básicos del evento, datos específicos del detector y parámetros de mensaje visibles (0x1 | 0x2 | 0x4 = 0x7).

Los siguientes ejemplos muestran cómo establecer el objeto detect al agregar unidades a la sesión.

Para monitorear eventos de todos los sensores de ignición y todos los demás sensores de la unidad con ID 1001, utilice una de las siguientes solicitudes:

svc=events/update_units&params={
  "mode": "add",
  "units": [
    {
      "id": 1001,
      "detect": {
        "ignition": 0,
        "sensors": 0
      }
    }
  ]
}

svc=events/update_units&params={
  "mode": "add",
  "units": [
    {
      "id": 1001,
      "detect": {
        "ignition,sensors": 0
      }
    }
  ]
}

Para monitorear eventos del sensor del nivel de combustible con ID 2 y otro sensor con ID 6, utilice la siguiente solicitud:

svc=events/update_units&params={
  "mode": "add",
  "units": [
    {
      "id": 1001,
      "detect": {
        "lls": 2,
        "sensors": 6
      }
    }
  ]
}

Si la solicitud se completa correctamente, se devuelve la siguiente respuesta:

{
  "units": <uint>   /* total number of units monitored in the session */
}

De lo contrario, se devuelve un código de error.