getHistory(JSON dataHistory)
Al invocar este método, se obtiene el detalle completo de eventos históricos de un equipo dado, en un rango de fechas, la información se retorna en formato JSON
Definición de atributos que deben ser incluidos en el objeto JSON que se recibe como parámetro al realizar la solicitud:
Atributos | Definición |
equipo
|
IMEI o Identificador único del dispositivo configurado en la plataforma |
fechaIni
|
Fecha inicial de los datos: 'aaaa-mm-dd hh:mm:ss' |
fechaFin
|
Fecha final de los datos: 'aaaa-mm-dd hh:mm:ss' |
format
|
Formato de las fechas a pocesar, por default
'DateTime'
|
Ejemplo de JSON:
let dataAlert = {
equipo : '356486080930374',
fechaIni : '2021-01-12 00:00:00',
fechaFin : '2021-01-12 23:59:59',
format : 'DateTime',
};
Ejemplo de solicitud en JS:
try {
const history = await _gpsApiv2.getHistory(dataHistory);
} catch (error) {
console.error(error);
}
Definición de atributos de la respuesta:
Atributos | Definición |
---|---|
equipo | Número de serie o IMEI que permite identificar el dispositivo |
latitud | Latitud de la posición del vehículo |
longitud | Longitud de la posición del vehículo |
iporigen | IP de origen de reporte del equipo GPS |
puerto | Puerto de origen de reporte del equipo GPS |
idstatus | Status de la información que reportó el equipo: 1 = Información actual, 2 = Información a futuro |
gmt | Fecha hora de la posición del vehículo |
fecha_reporte | Fecha hora de la posición del vehículo |
idevento | Identificador del evento que reportó el equipo GPS |
nombre_evento | Nombre del evento que reportó el equipo GPS |
velocidad | Velocidad en km/h que detecta el equipo GPS |
orientacion | Orientación en grados en la que reportó el equipo GPS |
serial | Señal GSM del equipo GPS |
satelites | Cantidad de satélites |
inputs | Estados de cada entrada del equipo, 0 = D |
combustible | Porcentaje (%) del nivel de combustible del sensor 1 |
consumocomb | Litros (lts) del consumo anterior de combustible del sensor 1 |
listroscomb | Litros (lts) del nivel de combustible del sensor 1 |
combustible2 | Porcentaje (%) del nivel de combustible del sensor 2 |
consumocomb2 | Litros (lts) del consumo anterior de combustible del sensor 2 |
litroscomb2 | Litros (lts) del nivel de combustible del sensor 2. |
voltajecomb | Voltaje (v), que envía la entrada análoga del equipo GPS. |
cuadalimetro | Medición del caudal. |
odometro | Metros (mts) que ha recorrido el vehículo, detectado por el GPS. |
bateria_gps | Porcentaje o voltaje del nivel de la batería interna del GPS |
bateria_veh | Voltaje (v) de la batería del vehículo. |
temperatura | Grados (°) del primer sensor de temperatura |
temperatura2 | Grados (°) del segundo sensor de temperatura |
ignicion | Status Ignición: 0 = OFF, 1 = ON, 2 = Desconocida |
idConductor | Id del conductor autentificado |
de_buffer | Status del tipo de reporte |
contador_pasajeros | Cantidad de pasajeros, Sensor de contador de pasajeros. |
OBD_rpm_motor | Revoluciones por minuto del motor, OBDII. |
OBD_carga_motor | Porcentaje de la carga de motor, OBDII |
OBD_temperatura_anticong | Grados de la temperatura de anticongelante, OBDII. |
OBD_posicion_aclerador | Porcentaje de la posición del acelerador, OBDII. |
datos_extras | Valores que son obtenidos del protocolo OBDII |
grupo | Grupo al que pertenece el vehículo. |
conductor | Conductor asociado al vehículo. |
patente | Placa / patente del activo |
activo | Nombre con el que se identifica el vehículo dentro de la plataforma. |
Respuesta de ejemplo:
[0:{
'equipo':'356486080930374',
'latitud':'18.983685420160437',
'longitud':'-98.22891569128842',
'iporigen':'',
'puerto':'',
'idstatus':'1',
'gmt':'0',
'fecha_reporte':'20190612120236',
'idevento':'1',
'velocidad':'75',
'orientacion':'90',
'senal':'5',
'satelites':'1',
'inputs':'',
'combustible':'-1',
'consumocomb':'-1',
'litroscomb':'-1',
'combustible2':'-1',
'consumocomb2':'-1',
'litroscomb2':'-1',
'voltageomb':'-1',
'caudalietro':'-1',
'odometro':'-1',
'odometro_veh':'0',
'bateria_gps':'100',
'bateria_veh':'12',
'temperatura':'-1',
'temperatura2':'-1',
'ignicion':'2',
'idconductor':'0',
'domicilio':'Carretera Federal 190, Ampliación Arboledas de Loma Bella, Heróica Puebla deZaragoza, Pue., México',
'de_buffer':'0',
'contador_pasajeros':'-1',
'obd_rpm_motor':'481',
'obd_carga_motor':'29',
'obd_temperatura_anticong':'16',
'obd_posicion_acelerador':'70',
'datos_extras':'{
'obd_fuel_level':'58'
'obd_engine_speed':'677'
'obd_total_engine_hours':'559'
'obd_engine_temperatura':'434'
'obd_vehicle_speed':'79'
'obd_driving_time':'65'
'obd_engine_percent_load':'79'
'time_stamp_insert':'20190612170203'
}',
'grupo':'Reportes',
'conductor':'Pablo Calvo',
'patente':'POP-1234',
'activo':'Polo',
}]