Datos históricos equipo - historyGet
POST https://api.service24gps.com/api/v1/historyGet
Este método permite consultar los datos históricos de un equipo para un rango de fechas y horas especificados.
Ver parámetros de solicitud:
| Parámetros | Descripción | Ejemplo |
|---|---|---|
| apikey | Llave de autorización para uso de los Servicios Web. | 25sdsd234234aa93sdsdsd37c70118e72 |
| token | Token devuelto por el método getToken. | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
| equipo |
IMEI o Identificador único del dispositivo configurado en la plataforma. |
0580012342332337 |
|
fechaIni |
Fecha Inicial de los datos. | 2023-03-08 00:00:00 |
|
fechaFin |
Fecha Final de los datos. |
2023-03-08 23:59:59 |
|
format |
Si se pasan horas en fechaIni y fechaFin debe enviar “DateTime”, de lo contrario utilice “Date”. |
DateTime |
|
limite |
(Opcional) Permite establecer un límite de filas de datos a recibir del WS, si no especifica un límite se regresan todos los datos. |
1 |
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/historyget' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'equipo="0580012342332337"' \
--form 'fechaIni="2023-03-08 00:00:00"' \
--form 'fechaFin="2023-03-08 23:59:59"' \
--form 'format="DateTime"' \
--form 'limite="1"'Respuesta de ejemplo:
{
"status": 200,
"data": {
"equipo": "0580012342332337",
"latitud": "+19.528530",
"longitud": "-99.171165",
"iporigen": "",
"puerto": "",
"idstatus": "1",
"gmt": "-5",
"fecha": "2023-03-08",
"hora": "23:59:39",
"fecha_reporte": "20230308235939",
"idevento": "1",
"velocidad": "0",
"orientacion": "0",
"senal": "65",
"satelites": "20",
"inputs": "0|0|0|0|0|0|0|0|0|0|0|0|0|0|0",
"odometro": "57373562",
"bateria_gps": "100",
"bateria_veh": "13.83",
"ignicion": "1",
"idconductor": "0",
"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": "Flota 1",
"conductor": "",
"patente": "ABC-813",
"activo": "Activo-01"
}
}
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 |
|
|
iporigen |
Ip de origen de reporte del equipo GPS. |
Cadena de texto |
|
|
puerto |
Puerto de origen de reporte del equipo GPS. |
Entero |
|
|
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 |
aaaa-mm-dd |
|
|
hora |
Hora |
hh:mm:ss |
|
|
fecha_reporte |
Fecha hora de la posición del vehículo. |
DateTime |
|
|
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 |
|
|
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 |
Cadena de texto |
|
|
conductor |
Nombre del conductor |
Cadena de texto |
|
|
patente |
Patente del activo |
Cadena de texto |
|
|
activo |
Nombre del activo |
Cadena de texto |
|