Activos

Métodos relacionados a los activos

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

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	Ejemplo
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/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	Ejemplo
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/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	Ejemplo
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/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 23:59:59",
                "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	Ejemplo
apikey	Llave de autorización para uso de los Servicios Web.	25sdsd234234aa93sdsdsd37c70118e72
token	Token devuelto por el método getToken.	wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
idvehiculo	Identificador del vehiculo	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