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