Datos históricos equipo - history/get

POST https://api.service24gps.com/api/v1/history/get  

 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 

 Longitud 

 Ejemplo 

 

 

 apikey 

 (Requerido)  Llave de autorización para uso de los Servicios Web. 

 50 

 25sdsd234234aa93sdsdsd37c70118e72 

 

 

 token 

 (Requerido) Token devuelto por el método getToken. 

 500 

 wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== 

 

 

 equipo 

 

 (Requerido) IMEI o Identificador único del dispositivo configurado en la plataforma. 

 

 

 200 

 

 0580012342332337 

 

 

 

 fechaIni 

 

 (Requerido) Fecha Inicial de los datos. 

 19 

 2023-03-08 00:00:00 

 

 

 

 fechaFin 

 

 

 (Requerido) Fecha Final de los datos. 

 

 

 19 

 

 2023-03-08 23:59:59 

 

 

 

 format 

 

 

 (Requerido) Si se pasan horas en  fechaIni  y  fechaFin  debe enviar “DateTime”, de lo contrario utilice “Date”. 

 

 

 8 

 

 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 

 

 

 

 

 

 Nota: El limite máximo para consultar datos históricos es de 15 días por equipo. 

 Solicitud de ejemplo: 

 curl --location --request POST 'https://api.service24gps.com/api/v1/history/get' \

--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