get
Después de cargar los eventos en la sesión, puede visualizarlos ejecutando el método events/get.
svc=events/get¶ms={
"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).
"<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.
"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.
"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
}
}
"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
}
}
"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
}
"counters": {
"engine_hours": <uint>, // contador de horas de motor
"mileage": <uint>, // contador de kilometraje
"bytes": <uint> // contador de tráfico GPRS
}
"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 en vía
}
Marca 0x4
Devuelve parámetros de usuario. La respuesta depende de los parámetros que el usuario haya especificado para el evento.
"<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.
{
"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:
"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:
"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.
"ignition": {
"<sensor_id>": {
"format": {
"value": <text> // Valor formateado (generalmente "On"/"Off")
}
}
}
"sensors": {
"<sensor_id>": {
"format": {
"value": <text> // Valor formateado, depende del tipo de sensor y formato
}
}
}
"trips": {
"format": {
"distance": <text>, // Distancia basada en el mensaje anterior
"avg_speed": <text> // Velocidad promedio en relación con "distance"
}
}
"lls": {
"<sensor_id>": {
"format": {
"value": <text>, // Valor formateado, depende del tipo de sensor y formato
"filled": <text> // Combustible llenado
}
}
}
"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
"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
"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. |