get_last

Para obtener el estado actual de un evento activo o el último estado conocido de un evento completado, utilice el método events/get_last.

A diferencia de events/get, este método no requiere que los eventos se carguen en la sesión y no devuelve el historial de eventos. A diferencia de events/check_updates, no requiere añadir el elemento a la sesión mediante events/update_items.

Para utilizar el método, necesita el derecho de acceso Ver objeto y sus propiedades básicas a la unidad o recurso especificado.

svc=events/get_last&params={
  "itemId": <long>,
  "type": <text>,
  "filter1": <long>,
  "filter2": <text>,
  "detalization": <uint>,
  "measure": <uint>,
  "lang": <text>
}

La solicitud debe contener el parámetro itemId. Todos los demás parámetros son opcionales.

Si la solicitud se completa correctamente, la respuesta contiene un objeto con clave por tipo de detector. De lo contrario, se devuelve un código de error.

La estructura de datos dentro de cada clave depende del detector y los flags solicitados.

Con el flag 0x1, los detectores trips y counters devuelven sus datos directamente, en la siguiente estructura. Otros detectores agrupan objetos de evento por un ID específico del detector, como se muestra en los ejemplos.

{
  "<detector_type>": {
    "from": {
      "t": <uint>,
      "y": <double>,
      "x": <double>
    },
    "to": {
      "t": <uint>,
      "y": <double>,
      "x": <double>
    },
    "m": <uint>,
    "f": <uint>
  }
}

Para una posición privada, los valores x e y se devuelven como 0.

Los otros flags devuelven los mismos datos que los flags correspondientes de events/check_updates: datos específicos del detector (0x2), parámetros del mensaje asociado con el evento (0x4), datos de detalle adicionales (0x8), datos detallados de mensaje (0x10) y valores formateados (0x20). Para el detector resource_drivers, los campos devueltos se describen en el ejemplo a continuación.

Los siguientes ejemplos muestran cómo obtener estados de eventos para diferentes casos de uso.

Para obtener el estado de todos los detectores disponibles para una unidad, especifique solo el ID de unidad:

svc=events/get_last&params={
  "itemId": <unit_id>
}

La respuesta es un objeto con clave por cada tipo de detector disponible:

{
  "<detector_type>": {
    "...": "..."
  }
}

Para obtener los estados de varios detectores a la vez, enumérelos en el parámetro type separados por comas. En la siguiente solicitud se solicitan los estados de los detectores trips y sensors, y los sensores se filtran por nombre con filter2:

svc=events/get_last&params={
  "itemId": <unit_id>,
  "type": "trips,sensors",
  "filter2": "Temperature 1,Temperature 2",
  "detalization": 39
}

La respuesta contiene un objeto para cada detector solicitado. El detector sensors agrupa sus datos por ID de sensor y el detector trips devuelve sus datos directamente:

{
  "trips": { "...": "..." },
  "sensors": {
    "<sensor_id>": { "...": "..." }
  }
}

Para obtener el estado del nivel de combustible para todos los sensores del nivel de combustible de una unidad, especifique el ID de unidad y el detector fuel_level. Use detalization 39 (0x27) para incluir datos básicos del evento, datos específicos del detector, parámetros de mensaje y valores formateados:

svc=events/get_last&params={
  "itemId": <unit_id>,
  "type": "fuel_level",
  "filter1": 0,
  "filter2": "",
  "detalization": 39
}

La respuesta se agrupa por ID de sensor. Con detalization 39 (0x27), puede contener los siguientes campos:

{
  "fuel_level": {
    "<sensor_id>": {
      "from": {
        "t": <uint>,
        "y": <double>,
        "x": <double>
      },
      "to": {
        "t": <uint>,
        "y": <double>,
        "x": <double>
      },
      "m": <uint>,
      "f": <uint>,
      "value": <double>,
      "raw_value": <double>,
      "filled": <double>,
      "timeDiff": <uint>,
      "latDiff": <double>,
      "lonDiff": <double>,
      "format": {
        "value": <text>,
        "raw_value": <text>,
        "filled": <text>,
        "theft": <text>,
        "custom_value": <text>
      }
    }
  }
}

Para obtener el estado actual del nivel de batería de un vehículo eléctrico (VE), especifique el ID de unidad y el detector ev. Use detalization 39 (0x27) para incluir datos básicos del evento, datos específicos del detector, parámetros del mensaje y valores formateados:

svc=events/get_last&params={
  "itemId": <unit_id>,
  "type": "ev",
  "filter1": 0,
  "filter2": "",
  "detalization": 39
}

La respuesta está agrupada por ID de sensor. Para el estado actual, el detector ev devuelve el nivel de batería, y la respuesta puede contener los siguientes campos:

{
  "ev": {
    "<sensor_id>": {
      "from": {
        "t": <uint>,
        "y": <double>,
        "x": <double>
      },
      "to": {
        "t": <uint>,
        "y": <double>,
        "x": <double>
      },
      "m": <uint>,
      "f": <uint>,
      "value": <double>,
      "raw_value": <double>,
      "format": {
        "value": <text>,
        "raw_value": <text>,
        "custom_value": <text>
      }
    }
  }
}

Los campos from, to, m y f se describen en la estructura común. El campo value contiene el nivel de batería calculado, y raw_value contiene el valor sin procesar del sensor.

Los campos value y raw_value dentro del objeto format devuelven el nivel de batería como un porcentaje de battery_capacity cuando la clave show_as_percentage está establecida en 1 en la configuración del sensor y battery_capacity es mayor que 0. De lo contrario, devuelven el nivel en kWh. Los campos value y raw_value fuera del objeto format siempre devuelven el nivel en kWh.

El detector ev es un detector de batería VE combinado. Devuelve eventos de nivel de batería y recarga en las respuestas de eventos históricos. En events/get_last, su respuesta del estado actual usa los campos de nivel de batería mostrados arriba. Para solicitar solo eventos de nivel de batería, use battery_level. Para obtener eventos históricos de carga, use charge con events/load y events/get.

Para obtener el estado actual de las asignaciones de conductores, especifique el ID de recurso y el detector resource_drivers. Establezca filter1 en un ID de conductor para obtener el estado de un conductor, o 0 para todos los conductores. El valor de detalization 7 (0x7) devuelve datos básicos del evento, datos específicos del detector y parámetros del mensaje asociado con el evento.

svc=events/get_last&params={
  "itemId": <resource_id>,
  "type": "resource_drivers",
  "filter1": 0,
  "filter2": "",
  "detalization": 7
}

La respuesta se agrupa por ID de conductor. Cada ID de conductor tiene un objeto que describe el estado actual de ese conductor.

{
  "resource_drivers": {
    "<driver_id>": {
      "from": {
        "t": <uint>,
        "y": <double>,
        "x": <double>
      },
      "to": {
        "t": <uint>,
        "y": <double>,
        "x": <double>
      },
      "m": <uint>,
      "f": <uint>,
      "state": <uint>,
      "aflags": <uint>,
      "unit_id": <long>,
      "propitem_cr_time": <uint>,
      "real_time_from": <uint>,
      "validate_sensor_id": <uint>,
      "switched_to": <long>
    }
  }
}

Los campos from, to, m y f se describen en la estructura común. El detector también devuelve los siguientes campos:

El campo aflags puede contener los siguientes flags. Los mismos flags se utilizan en los eventos completados devueltos por events/get, por lo que un estado actual generalmente contiene solo los flags que describen cómo comenzó la asignación.

Para state 0, el objeto to no muestra la hora y el lugar de la separación. Muestra el último mensaje procesado. La hora de separación es la hora de fin del evento completado en el historial de eventos, que puede obtener con events/get.

Para cambiar manualmente el estado de asignación, utilice resource/driver_actions_register. Para ver o eliminar acciones manuales registradas, utilice resource/driver_actions_list o resource/driver_actions_cleanup.