Ir al contenido principal

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"
         }
}
Volver arriba