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 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>,
      "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.