get

Después de cargar los eventos en la sesión, puede visualizarlos ejecutando el método events/get.

Copied!
svc=events/get&params={
  "selector": {
    "type": <text>,
    "expr": <text>,  
    "timeFrom": <uint>,  
    "timeTo": <uint>,
    "detalization": <uint>   
  },
  ...
}

Parámetros

Parámetro Descripción
type Grupo de sensores: lls, trips, ignition, sensors, counters. Para especificar todos los grupos, utilice el asterisco (*).
expr Expresión de grupo de intervalos. Se utiliza en lugar del parámetro type para obtener intervalos de eventos personalizados. Consulte más abajo.
timeFrom Inicio del intervalo, tiempo UNIX.
timeTo Fin del intervalo, tiempo UNIX.
detalization Marcas de salida (consulte más abajo).
indexFrom Índice del primer evento solicitado.
indexTo Índice del último evento solicitado.
filter1 ID del sensor.

Marcas

Marca Descripción
0x1 JSON básico: inicio y fin del evento.
0x2 Datos de un detector específico.
0x4 Parámetros de usuario (que el usuario especificó para este evento).
0x8 Datos de recorrido en el parámetro trips.
0x10 JSON completo. Cada detector lo interpreta de su propia manera.
0x20 Valor formateado.
0x40 Agrupación de las intersecciones de intervalos con los parámetros tf y tt.
0x80 Resumen.

Intervalos de eventos personalizados

Para obtener intervalos de eventos personalizados, especifique una expresión en el parámetro "expr":<text> en lugar de utilizar el parámetro "type":<text>. Puede utilizar los siguientes formatos de expresión:

Operador Descripción Ejemplo
{} Se utiliza para seleccionar intervalos con el valor especificado del parámetro detalization. Consulte el ejemplo para seleccionar intervalos de viajes en los que el valor de velocidad supera 100. trips{s>100}
- Se utiliza para especificar un intervalo personalizado en formato inicio-fin, tiempo UNIX. 1451953325-1451953525
| Se utiliza como separador al especificar múltiples intervalos personalizados. (1615849200-1615935599|1615935601-1616022000)
[] ID del sensor. Si no se especifica ningún ID, se utiliza el primer sensor. sensors[3]

Respuesta

Si la solicitud se completa correctamente, recibirá la respuesta correspondiente al grupo de sensores especificado en el parámetro type. De lo contrario, se devuelve un código de error.

Marca 0x1

Devuelve JSON básico (el mismo para todos los grupos de sensores).

Copied!
"<type_name>": {
  "<sensor_id>": {
    "from": {
      "t": <uint>,  // Tiempo (tiempo UNIX)
      "y": <double>,// Latitud
      "x": <double> // Longitud
    },
    "to": {
      "t": <uint>,  // Tiempo (tiempo UNIX)
      "y": <double>,// Latitud
      "x": <double> // Longitud
    },
    "m": <uint>,    // Hora del último mensaje
    "f": <uint>     // Marca de servicio
  }
}

Marca 0x2

Devuelve datos de un detector específico.

Copied!
"ignition": {
  "<sensor_id>": {
    "state": <uint>,    // Estado: 0 — apagado, 1 — encendido
    "type": 1,          // Tipo de sensor: sensor conmutador
    "hours": <uint>,    // Horas de motor para todo el historial (en segundos)
    "switches": <uint>, // Número de conmutaciones para todo el historial
    "value": <bool>     // Valor actual
  }
}

A continuación se muestran los tipos de sensores posibles para sensors.

Copied!
"sensors": {
  "<sensor_id1>": {
    "state": <uint>,        // Estado: 0 — apagado, 1 — encendido
    "type": 1,              // Tipo de sensor: sensor conmutador
    "hours": <uint>,        // Horas de motor para todo el historial (en segundos)
    "switches": <uint>,     // Número de conmutaciones para todo el historial
    "value": <bool>         // Valor actual
  },
  "<sensor_id2>": {
    "type": 2,              // Tipo de sensor: sensor instantáneo
    "counter": <uint>,      // Número de mensajes secuenciales en el evento
    "summary": <uint>,      // Suma de valores en el evento
    "total_counter": <uint>,// Número total de mensajes en todo el historial
    "total_summary": <uint>,// Suma total de valores en todo el historial
    "value": <double>       // Último valor; si es -348201.3876, el valor es desconocido
  },
  "<sensor_id3>": {
    "type": 3,              // Tipo de sensor: sensor diferencial
    "counter": <uint>,      // Suma de valores en el evento
    "total_counter": <uint>,// Suma de valores en el historial
    "value": <double>       // Último valor; si es -348201.3876, el valor es desconocido
  },
  "<sensor_id4>": {
    "type": 4,              // Tipo de sensor: sensor analógico
    "value": <double>       // Último valor; si es -348201.3876, el valor es desconocido
  }
}
Copied!
"lls": {
  "<sensor_id>": {
    "value": <double>, // Valor del último mensaje con el nivel calculado
    "level": <double>, // Valor de mediana promedio (después de la filtración FLS)
    "filled": <double> // Cantidad de combustible llenado
  }
}
Copied!
"trips": {
  "state": <bool>,       // Estado del viaje: 0 — estacionamiento, 1 — viaje, 2 — parada
  "max_speed": <uint>,   // Velocidad máxima durante el viaje
  "curr_speed": <uint>,  // Velocidad actual
  "avg_speed": <uint>,   // Velocidad promedio basada en la distancia
  "distance": <uint>,    // Kilometraje GPS durante el viaje
  "odometer": <uint>,    // Distancia total de todos los viajes en el historial
  "course": <uint>,      // Rumbo
  "altitude": <uint>     // Altitud
}
Copied!
"counters": {
  "engine_hours": <uint>, // contador de horas de motor
  "mileage": <uint>,      // contador de kilometraje
  "bytes": <uint>         // contador de tráfico GPRS
}
Copied!
"speedings": {
  "max_speed": <uint>,  // Velocidad en el momento del máximo exceso de velocidad — el momento de mayor diferencia entre la velocidad permitida y la real
  "last_speed": <uint>, // Velocidad del último mensaje dentro del intervalo
  "limit": <uint>       // Límite de velocidad ena
}

Marca 0x4

Devuelve parámetros de usuario. La respuesta depende de los parámetros que el usuario haya especificado para el evento.

Copied!
"<type_name>": {
  "<sensor_id>": {
    "p": {                // Contenido del objeto definido por el usuario
      "test": 2,
      "foo": "bar",
      "trips": 1
    }
  }
}

Marca 0x8

Devuelve JSON con parámetros adicionales. Para trips, devuelve un recorrido de unidad en notación de Google.

Copied!
{
  "trips": {
    "0": [
      {
        "track": "wspnGgvcv@??oey@kwl@~dtBkeRwjzF??~ja@_qo]??g~g^????????????~bV???????"
      }
    ]
  }
}

Marca 0x10

Devuelve JSON completo.

Para sensores con type=2 y type=3 (excepto sensores de nivel de combustible), la respuesta es la siguiente:

Copied!
"sensors": {
  "<sensor_id>": {
    "msgs": [
      {
        "tm": <uint>,  // Tiempo del mensaje (tiempo UNIX)
        "v": <double>  // Valor
      },
      ...
    ]
  },
  ...
}

Para un sensor de nivel de combustible, la respuesta es la siguiente:

Copied!
"lls": {
  "<sensor_id>": {
    "msgs": [
      {
        "tm": <uint>,  // Tiempo del mensaje (tiempo UNIX)
        "v": <double>, // Valor
        "l": <double>  // Valor de mediana promedio (con filtración FLS aplicada)
      },
      ...
    ]
  }
},
...

Marca 0x20

Devuelve valores formateados.

Copied!
"ignition": {
  "<sensor_id>": {
    "format": {
      "value": <text>  // Valor formateado (generalmente "On"/"Off")
    }
  }
}
Copied!
"sensors": {
  "<sensor_id>": {
    "format": {
      "value": <text>  // Valor formateado, depende del tipo de sensor y formato
    }
  }
}
Copied!
"trips": {
  "format": {
    "distance": <text>,   // Distancia basada en el mensaje anterior
    "avg_speed": <text>   // Velocidad promedio en relación con "distance"
  }
}
Copied!
"lls": {
  "<sensor_id>": {
    "format": {
      "value": <text>,   // Valor formateado, depende del tipo de sensor y formato
      "filled": <text>   // Combustible llenado
    }
  }
}
Copied!
"counters": {
  "format": {
    "engine_hours": <uint>,  // Valor formateado del contador de horas de motor
    "mileage": <text>,       // Valor formateado del contador de kilometraje
    "bytes": <uint>          // Valor formateado del contador de tráfico GPRS
  }
}

Marca 0x40

Copied!
"selector": [
  {
    "tf": <uint>,  // Inicio del intervalo de intersección (tiempo UNIX)
    "tt": <uint>,  // Fin del intervalo de intersección (tiempo UNIX)
    "d": {
      "<type_name>": {
        "<sensor_id>": [
          { }  
        ]
      }
    }
  }
]

Marca 0x80

Copied!
"selector": {
  "<type_name>": {
    "<sensor_id>": [
      { } 
    ]
  }
},

"summary": {
  "<type_name>": {
    "<sensor_id>": {
      "<summary_param_value>": <uint>,  // Resumen; el significado varía para diferentes detectores
      "format": {
        "value": <text>  // Valor formateado, depende del tipo de sensor y formato
      }
    }
  }
}

Códigos de error

Código Descripción
1 SID de solicitud no válido u obsoleto.
4 Error de validación de parámetros.
7 No se pudo cargar la biblioteca adf_avl_events.

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

Informar de un error

Su mensaje ha sido enviado. ¡Gracias!

Se produjo un error al enviar el formulario