Activos

Métodos relacionados a los activos

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": "1980",
       "nombre": "Jeep Patriot",
       "patente": "NTX9553",
       "idgps": "0580012342332337",
       "gatewayip": "107.170.254.11",
       "conductor": "Salvador Lopez",
       "grupo": null,
       "marca": "Jeep",
       "modelo": "",
       "color": "",
       "anio": "0",
       "numero_serie": "N",
       "tipo_vehiculo": "Camioneta"
     }
   ]
}
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

tipo_vehiculo

Indica si el activo es un: automóvil, peatón, etc...

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