Datos históricos de eventos del equipo - historyGetEvents
POST https://api.service24gps.com/api/v1/historyGetEvents
Este método permite consultar los datos históricos de los eventos de un equipo para un rango de fechas y horas especificados.
Ver parámetros de solicitud:
Parámetros | Descripción | Longitud | Ejemplo |
---|---|---|---|
apikey | Llave de autorización para uso de los Servicios Web. | 50 | 25sdsd234234aa93sdsdsd37c70118e72 |
token | Token devuelto por el método getToken. | 500 | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
equipo |
IMEI o Identificador único del dispositivo configurado en la plataforma. |
200 |
0580012342332337 |
fechaIni |
Fecha Inicial de los datos. | 19 | 2021-04-27 00:00:00 |
fechaFin |
Fecha Final de los datos. |
19 |
2021-04-27 23:59:59 |
format |
Si se pasan horas en fechaIni y fechaFin debe enviar “DateTime”, de lo contrario utilice “Date”. |
8 |
DateTime |
idsEvents |
Se específica un o muchos Id de los eventos a consultar, separados por coma sin espacios. Si no se especifican se obtienen todos los eventos que no sean ubicación. |
|
1321,1322,1323,1324,1325,1326,1336,1337,1338,1339 |
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/historygetevents' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'equipo="0580012342332337"' \
--form 'fechaIni="2021-04-27 00:00:00"' \
--form 'fechaFin="2021-04-27 23:59:59"' \
--form 'format="DateTime"' \
--form 'idsEvents="1321,1322,1323,1324,1325,1326,1336,1337,1338,1339"'
{
"status": 200,
"data": {
"equipo": "0580012342332337",
"latitud": "19.528530",
"longitud": "--99.171165",
"idstatus": "1",
"gmt": "-6",
"fecha": "2024-01-04",
"hora": "10:14:18",
"fecha_reporte": "20240104101418",
"idevento": "348",
"velocidad": "0",
"orientacion": "0",
"senal": "0",
"satelites": "0",
"inputs": "0|0|0|0|0|0|0|0|0|0|0|0|0|0|0",
"odometro": "0",
"bateria_gps": "86",
"bateria_veh": "0",
"ignicion": "1",
"idconductor": "34110",
"domicilio": "Camino a San Juan Ixtacala 479, San Juan, Gustavo A. Madero, Mexico City, Mexico",
"de_buffer": "0",
"datos_extras": "{\"parameters\":{\"out_1\":\"0\",\"out_2\":\"0\",\"out_3\":\"0\",\"out_4\":\"0\",\"out_5\":\"0\",\"out_6\":\"0\",\"out_7\":\"0\",\"out_8\":\"0\"},\"outputs\":\"0|0|0|0|0|0|0|0\",\"Time_stamp_insert\":\"20210427201542\",\"tipo_dato\":{\"1\":\"2021-04-28 01:15:42\",\"13\":\"2021-04-27 21:04:29\",\"55\":\"2021-04-27 21:04:30\",\"14\":\"2021-04-27 21:05:42\",\"3\":\"2021-04-27 21:03:42\"},\"gw\":\"Escuchar-ST4340-TCP.php\",\"ip\":\"107.170.254.11\",\"kp\":\"6088b73e3a7f5\"}",
"grupo": "CONDUCTORES MX",
"conductor": "CONDUCTOR1",
"patente": "ABC123",
"activo": "ACTIVO 1"
}
}
Respuesta de ejemplo:
Ver campos de respuesta:
Campo |
Descripción |
Formato |
---|---|---|
equipo |
Número de serie o IMEI que permite identificar el dispositivo. |
Entero |
latitud |
Latitud de la posición del vehículo. |
Grados decimales |
longitud |
Longitud de la posición del vehículo. |
Grados decimales |
idstatus |
Status de la información que reportó el equipo: 1 = Información actual 2 = Información a futuro. |
Entero |
gmt |
Greenwich Mean Time. |
Cadena de texto |
fecha |
Fecha de la posición del vehículo. |
DateTime |
hora |
Hora de la posición del vehículo. |
HH::MM:SS |
fecha_reporte |
Fecha y hora de la posición del vehículo. |
Timestamp |
idevento |
Identificador del evento que reportó el equipo GPS. |
Entero |
velocidad |
Velocidad en km/h que detecta el equipo GPS. |
Entero |
orientacion |
Orientación en grados en la que reportó el equipo GPS. |
Entero |
senal |
Señal GSM del equipo GPS. |
Entero |
satelites |
Cantidad de satélites. |
Entero |
inputs |
Estados de cada entrada del equipo: 0 = Desactivada 1 = Activada |
Cadena de texto |
odometro |
Metros (mts) que ha recorrido el vehículo, detectado por el GPS. |
Entero |
bateria_gps |
Porcentaje o voltaje del nivel de la batería interna del GPS. |
Entero | Decimales |
bateria_veh |
Voltaje (v) de la batería del vehículo. |
Decimales |
ignicion |
Status Ignición: 0 = OFF 1 = ON 2 = Desconocida |
Entero |
IdConductor |
Id del conductor autentificado, Ibutton |
Entero |
domicilio |
Domicilio. |
Cadena de texto |
de_buffer |
Status del tipo de reporte: 0 = Sin Buffer 1 = Buffer |
Entero |
datos_extras |
Valores que son obtenidos del protocolo OBDII. |
JSON |
grupo |
Nombre del grupo que pertenece. |
Cadena de texto |
conductor |
Nombre del conductor. |
Cadena de texto |
patente |
Nombre de la patente. |
Cadena de texto |
activo |
Nombre del activo. |
Cadena de texto |