Datos de unidades - getData

POST https://api.service24gps.com/api/v1/getdata 

 Este método devuelve un array de datos con la última información o reporte enviado por las unidades de rastreo asignadas al usuario autentificado. 

 IMPORTANTE: No recomendamos utilizar este método para consultar de forma recurrente las posiciones de todos los Activos. Si necesitas recibir continuamente la información reportada por tus Activos en un sistema externo, utiliza un Web Service genérico . 

 

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

 

 

 UseUTCDate 

 

 Valor booleano (Opcional por defecto es 0) 

 0 = Como la envió la unidad de rastreo. 

 1 = Especifica si la fecha del reporte es en formato UTC. 

 

 

 1 

 

 0 

 

 

 sensores 

 

 Valor booleano 

 0 = No trae la información de los sensores. 

 1 = Especifica si se desea obtener la información de sensores. 

 

 

 1 

 

 1 

 

 

 

 

 

 Solicitud de ejemplo: 

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

--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \

--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'

--form 'UseUTCDate="0"' \

--form 'sensores="1"' 

 Respuesta de ejemplo: 

 {

	"status": 200,

	"data": [

	{

		"UnitId": "Jeep Patriot",

		"UnitPlate": "NTX9553",

		"GpsIdentif": "0580012342332337",

		"ReportDate": "2021-04-26 16:42:43",

		"Latitude": "+19.528530",

		"Longitude": "-99.171165",

 	"UrlLocation": "https://maps.google.com/?ie=UTF8&q=19.7893235448976,-98.96555386318250",

		"Altitude": 0,

		"GpsSpeed": "0",

		"Direction": "N",

		"Satellites": "22",

		"Ignition": "0",

		"Odometer": 0,

		"IdEvento": "1",

		"Domicilio": "Camino a San Juan Ixtacala 479, San Juan, Gustavo A. Madero, Mexico City, Mexico",

		"Puerto": "",

		"IpOrigen": "",

		"BateriaGps": "-1",

		"BateriaVeh": "-1",

		"Grupo": null,

		"Conductor": "Salvador Lopez",

		"Inputs": "0|0|0|0|0|0|0|0|0|0|0|0|0|0|0",

 "TipoDato": "Ubicación",

 "Senal": "62",

 "InsertionDate": "2021-04-26 16:43:13",

		"Sensores": ""

	}

	]

} 

 Nota: Los campos con valor -1 se refieren que no se han enviado por el dispositivo de rastreo. 

 

 Ver campos de respuesta: 

 

 

 

 

 Campo 

 

 Descripción 

 

 Formato 

 

 

 UnitId 

 Valor por el qué es identificada la unidad o vehículo. 

 Cadena de Texto 

 

 

 UnitPlate 

 Se refiere a la placa/patente del vehículo. 

 Cadena de Texto 

 

 

 GpsIdentif 

 

 Número de serie o IMEI que permite identificar el dispositivo de rastreo 

 

 Cadena de Texto, con longitud de 16 caracteres. 

 

 

 

 ReportDate 

 

 

 Fecha/hora de la posición 

 

 aaaa-mm-dd hh:mm:ss 

 

 

 

 Latitude 

 

 

 Latitud de la posición del vehículo. 

 

 

 Grados decimales 

 

 

 

 

 Longitude 

 

 

 Longitud de la posición del vehículo. 

 

 

 Grados decimales 

 

 

 

 

 UrlLocation 

 

 

 Url de localización  

 

 

 Cadena de Texto 

 

 

 

 

 Altitude 

 

 

 Altitud de la posición del vehículo. 

 

 

 Metros 

 

 

 

 

 GpsSpeed 

 

 Orientación del vehículo, Norte, Sur, Este, etc. 

 Kilómetros / hora 

 

 

 

 Direction 

 

 

 N,S,E,O,NO,NE,SO,SE 

 

 

 Orientación del vehículo, Norte, Sur, Este, etc. 

 

 

 

 

 Satellites 

 

 

 Número de satélites con Fix de la posición. 

 

 

 Entero 

 

 

 

 

 Ignition 

 

 

 Status Ignición: 

 0 = OFF 

 1 = ON 

 2 = Desconocida 

 

 

  Entero 

 

 

 

 

 Odometer 

 

 

 Odómetro del vehículo en la posición. 

 

 

 Metros 

 

 

 

 

 IdEvento 

 

 

 Identificador del evento que reportó el equipo GPS. 

 

 

 Entero 

 

 

 

 

 Domicilio 

 

 

 Dirección correspondiente a la latitud y longitud reportada por el equipo. 

 

 

 Cadena de texto 

 

 

 

 

 Puerto 

 

 

 Puerto de origen de reporte del equipo GPS. 

 

 

 Entero 

 

 

 

 IpOrigen 

 Ip de origen de reporte del equipo GPS 

 

 Cadena de texto 

 

 

 

 

 BateriaGps 

 

 

 Nivel de voltaje o porcentaje del equipo GPS 

 

 

 Cadena de texto 

 

 

 

 

 BateriaVeh 

 

 

 Nivel de voltaje de la fuente conectada al GPS. 

 

 

 Cadena de texto 

 

 

 

 

 Grupo 

 

 

 Nombre del grupo al que pertenece el vehículo. 

 

 

 Cadena de texto 

 

 

 

 

 Conductor 

 

 

 Nombre del conductor asociado al vehículo. 

 

 

 Cadena de texto 

 

 

 

 

 Inputs 

 

 

 Estados de cada entrada del equipo: 

 0 = Desactivada 

 1 = Activada. 

 

 

 Cadena de texto 

 

 

 

 

 TipoDato 

 

 

 Tipo de dato. 

 

 

 Cadena de texto 

 

 

 

 

 Senal 

 

 

 Señal del equipo GPS. 

 

 

 Entero 

 

 

 

 

 

 InsertionDate 

 

 

 

 Fecha/hora de inserción. 

 

 

 aaaa-mm-dd hh:mm:ss 

 

 

 

 

 Sensores 

 

 

 Json de datos de los sensores 

 

 

 JSON 

 

 

 

 

 

 

 Formato de respuesta de sensores 

 

 Ver formato: 

 

 

 

 

 Nombre 

 Descripción  

 Valor de la propiedad 

 Ejemplo 

 

 

 Sensores 

 

 Formato de respuesta de la petición.  

 

 

 

 82: Id del sensor. 

 Bateria_gps: nombre del sensor. 

 Valores enviados por el equipo relacionado al sensor (Consulta el listado de sensores en  getSensors ).  

 

 

 

 

 "82":{ 

          "Bateria_gps":{ 

                  "nombre":  "Bateria_gps", 

                  "valor":  "0",                                                           "fecha":  "2023-03-14 12:01:51" 

          } 

 

 

 }