Activos

Métodos relacionados a los activos

Datos de unidades - getData
Lista de vehículos - vehicleGetAll
Lista de vehículos + infoextra - vehicleGetAllComplete
Listar los contenedores de activos - getDataContainers
Odómetro de activo(s) - getOdometer
Listar clientes que pertenecen a un activo - getClientsByVehicle
Obtener / visualizar los tanques para PEMEX - showTanks
Listado de grupo de activos - getAssetGroups

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

Lista de vehículos - vehicleGetAll

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

Lista los vehículos asignados al usuario autentificado en la API.

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

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/vehicleGetAll' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'

Respuesta de ejemplo:

{
   "status": 200,
   "data": [
     {
       "id": "198098",
       "nombre": "Jeep Patriot",
       "patente": "NT-53-53",
       "idgps": "0580012342332337",
       "gatewayip": "107.170.254.11",
       "conductor": "Luis M.",
       "grupo": "Seguridad SA.",
       "marca": "Ford",
       "modelo": "G15",
       "color": "Azul",
       "anio": "2025",
       "numero_serie": "N8798895611",
       "odometro": "25682.2",
       "tipo_vehiculo": "Camioneta",
       "notas": "",
       "idgrupo_vehiculo": "878954"
     }
   ]
}

Ver campos de respuesta:

Campo	Descripción	Formato
id	Identificador único del vehículo dentro de la plataforma.	Entero
nombre	Nombre que identifica al vehículo en la plataforma.	Cadena de Texto
patente	Placa/patente del vehículo.	Cadena de Texto
idgps	Equipo GPS instalado en el vehículo.	Cadena de Texto
gatewayip	IP en la que se encuentra reportando el GPS.	Cadena de Texto
conductor	Nombre del conductor asociado al vehículo.	Cadena de Texto
grupo	Nombre del grupo al que pertenece el vehículo.	Cadena de Texto
marca	Marca del vehículo (VolksWagen, Ford, etc.)	Cadena de Texto
modelo	Modelo del vehículo (Vento, Figo, etc...)	Cadena de Texto
color	Color de la carrocería del vehículo.	Cadena de Texto
anio	Indica el año en que fue lanzado a la venta el vehículo.	Cadena de Texto
numero_serie	Número de serie asociado al activo.	Cadena de Texto
odometro	Valor del odometro.	Cadena de Texto
tipo_vehiculo	Indica si el activo es un: automóvil, peatón, etc.	Cadena de Texto
notas	Información adicional del vehículo.	Cadena de Texto
idgrupo_vehiculo	Identificador único del grupo que pertenece el vehículo.	Cadena de Texto

Lista de vehículos + infoextra - vehicleGetAllComplete

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

Lista los vehículos asignados al usuario autentificado en la API.

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

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/vehicleGetAllComplete' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'

Respuesta de ejemplo:

{
   "status": 200,
   "data": [
     {
       "id": "1980",
       "nombre": "Auto Test",
       "patente": "NTX9553",
       "idgps": "0580012342332337",
       "gatewayip": "107.170.254.11",
       "conductor": "User Test",
       "grupo": "Test Group",
       "marca": "Ford",
       "modelo": "Mustang",
       "color": "Rojo",
       "anio": "2015",
       "numero_serie": "N123456789",
       "num_economico": "rd23",
       "tipo_vehiculo": "Automovil",
       "icono_vehiculo": "./Iconos/Vehiculos/01.png",
       "idequipo_gps": "0",
       "idtipo_vehiculo": "3",
       "idmarca_vehiculo": "0",
       "idconductor": "0",
       "idgrupo_vehiculo": "0"
       
     }
   ]
}

Ver campos de respuesta:

Campo	Descripción	Formato
id	Identificador único del vehículo dentro de la plataforma.	Entero
nombre	Nombre que identifica al vehículo en la plataforma.	Cadena de Texto
patente	Placa/patente del vehículo.	Cadena de Texto
idgps	Equipo GPS instalado en el vehículo.	Cadena de Texto
gatewayip	IP en la que se encuentra reportando el GPS.	Cadena de Texto
conductor	Nombre del conductor asociado al vehículo.	Cadena de Texto
grupo	Nombre del grupo al que pertenece el vehículo.	Cadena de Texto
marca	Marca del vehículo (VolksWagen, Ford, etc...)	Cadena de Texto
modelo	Modelo del vehículo (Vento, Figo, etc...)	Cadena de Texto
color	Color de la carrocería del vehículo.	Cadena de Texto
anio	Indica el año en que fue lanzado a la venta el vehículo.	Cadena de Texto
numero_serie	Número de serie asociado al activo.	Cadena de Texto
num_economico	Número económico del vehículo	Cadena de Texto
tipo_vehiculo	Indica si el activo es un: automóvil, peatón, etc...	Cadena de Texto
icono_vehiculo	URL de la imagen del vehiculo	Cadena de Texto
idequipo_gps	Identificador del dispositivo.	Entero
idtipo_vehiculo	Identificador del tipo de vehículo.	Entero
idmarca_vehiculo	Identificador de la marca del vehiculo.	Entero
idconductor	Identificador asignado al conductor.	Entero
idgrupo_vehiculo	Identificador del grupo que pertenece el vehículo.	Entero

Listar los contenedores de activos - getDataContainers

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

Lista todos los contenedores de uno o varios remolques de todos los activos del cliente.

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

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/getDataContainers' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'

Respuesta de ejemplo:

{
    "status": 200,
    "data": [
        {
            "unitid": "MTR2",
            "unitplate": "MTR2",
            "gpsidentif": "5107BE5A902E6256",
            "gpsdate": "2022-03-02T23:09:09",
            "gpslat": "-15.348761848591401",
            "gpslong": "-75.1446473753456",
            "event": "Ubicación",
            "containers": [
                {
                    "id": "152",
                    "worder": "2151",
                    "containerno": "Contedor  1",
                    "bookingno": "1231",
                    "client": "User Test",
                    "origin": "Sonora, Mexico",
                    "destination": "Puerto Manzanillo, Mexico",
                    "eta": "15564",
                    "self_billing": "215",
                    "naviera": "",
                    "gross_weight": "500kg"
                },
                {
                    "id": "285",
                    "worder": "2151",
                    "containerno": "Contedor  2",
                    "bookingno": "1231",
                    "client": "User Test",
                    "origin": "Sonora, Mexico",
                    "destination": "Puerto Manzanillo, Mexico",
                    "eta": "15564",
                    "self_billing": "215",
                    "naviera": "",
                    "gross_weight": "500kg"
                }
            ]
        }
    ]
}

Odómetro de activo(s) - getOdometer

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

Este método permíte consultar el odómetro de uno o varios activos en una fecha específica.

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. Equipo o equipos separados por “,”	0580012342332337
fecha	Fecha en la que se calculará el odómetro del activo.	2021-04-27
hora	Hora en la que se calculará el odómetro del activo.	23:59:59
odometro_gps	Si la fecha se envía vacía devolverá el último odómetro reportado por el GPS. Si se envía una fecha en específico entonces se devolverá el último odómetro reportado para ese día. 0 = Odómetro calculado por la plataforma. 1 = Odómetro reportado por el GPS.	1

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/getOdometer' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'equipo="0580012342332337"' \
--form 'fecha="2021-04-27"' \
--form 'hora="23:59:59"' \
--form 'odometro_gps="1"'

Respuesta de ejemplo:

{
    "status": 200,
    "data": [
        {
            "0580012342332337": {
                "Fecha": "2021-04-27",
                "Kilometros": 0,
                "Odometro": "0.00",
                "Horas": 0
            }
        }
    ]
}

Ver campos de respuesta:

Campo	Descripción	Formato
Fecha	Fecha a la que pertenece el odómetro.	Fecha (aaaa-mm-dd)
Kilometros	Distancia recorrida por el activo en la fecha indicada.	Distancia en kilómetros
Odometro	Odómetro del activo a la fecha consultada.	Kilómetros
Horas	Horas de uso de motor correspondientes a la fecha.	Flotante

Listar clientes que pertenecen a un activo - getClientsByVehicle

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

Lista los clientes que están asignados a un activo especifico.

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==
idvehiculo	Identificador del vehiculo	8	51651

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/getClientsByVehicle' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'\
--form 'idvehiculo="51651"'

Respuesta de ejemplo:

{
    "status": 200,
    "data": [
        {
            "idcliente": "42251",
            "cliente": "Empresa CEO"
        },
        {
            "idcliente": "1129759",
            "cliente": "Sucursal Norte"
        },
        {
            "idcliente": "15470",
            "cliente": "Empresa de carga ICO"
        },
        {
            "idcliente": "8229",
            "cliente": "Sucursal Sur"
        }
    ]
}

Ver campos de respuesta:

Campo	Descripción	Formato
idcliente	Identificador único del cliente.	Entero
cliente	Nombre del cliente.	Cadena de Texto

Obtener / visualizar los tanques para PEMEX - showTanks

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

Se obtiene los reportes de las unidades de los últimos 5 minutos, los valores retornados es un formato requerido por parte del documento de PEMEX: "Carga de datos de rastreo de autotanques con presentación de servicios para Pemex Logística".

Ver parámetros de solicitud:

apikey	Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==

Solicitud de ejemplo:

curl --location --request POST 'https://api.service24gps.com/api/v1/showTanks' \
--header 'Cookie: PHPSESSID=0ab8djc97ouk13tev2t9epf1l2' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'

Respuesta de ejemplo:

{
    "status": 200,
    "data": [
        {
            "ID_UNIDAD": "XX805",
            "FECHA": "08/07/2022 09:57:37",
            "LATITUD": "25.39214",
            "LONGITUD": "-100.11898",
            "VELOCIDAD": "11",
            "OBSERVACIONES": "",
            "COMPANIA": "ONCETG"
        },
        {
            "ID_UNIDAD": "XX317",
            "FECHA": "08/07/2022 09:58:20",
            "LATITUD": "27.59561",
            "LONGITUD": "-99.58542",
            "VELOCIDAD": "0",
            "OBSERVACIONES": "",
            "COMPANIA": "ONCETG"
        }
    ]
}

Ver campos de respuesta:

Campo	Descripción	Formato
ID_UNIDAD	Placa o nombre de la unidad (activo), sin espacios y guiones.	Texto
FECHA	Fecha hora del reporte, Formato: DD/MM/YYY hh:mm:ss Zona Horaria de la Ciudad de México	Date
LATITUD	Latitud del reporte en formato: WGS84	Texto
LONGITUD	Longitud del reporte en formato: WGS84	Texto
VELOCIDAD	Velocidad del reporte	Entero
OBSERVACIONES	Notas o comentarios de la unidad	Texto
COMPANIA	Nombre de la compañía o empresa que pertenecen las unidades	Texto

Listado de grupo de activos - getAssetGroups

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

Obtiene el listado de los grupos de activos.

Ver parámetros de solicitud:

Parámetros	Descripción	Ejemplo
apikey	(Requerido) Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	(Requerido) Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==

Solicitud de ejemplo:

curl --location 'https://api.service24gps.com/api/v1/getAssetGroups' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'

Respuesta de ejemplo:

{
    "status": 200,
    "data": [
        {
            "id": 5621235,
            "name": "Grupo de activos 1",
            "idcliente_sistema": "53725"
        },
        {
            "id": 5621236,
            "name": "Grupo de activos 2",
            "idcliente_sistema": "53725"
        },
        {
            "id": 5621237,
            "name": "Grupo de activos 3",
            "idcliente_sistema": "53725"
        }
    ]
}

Respuesta de ejemplo:

Ver campos de respuesta:

Campo	Descripción	Formato
Id	Identificador único del grupo de activos.	Entero
name	Nombre del grupo de activos.	Cadena de texto.
idcliente_sistema	Identificador único del cliente.	Cadena de texto.