WebServices de retransmisión de datos
En este documento se podrán consultar los WebServices que tenemos integrados en la plataforma.
- Web Services integrados
- Webservice de reenvío genérico
- Web Service de Reenvío Genérico (Nueva Versión)
- Web Service Paquetes
Web Services integrados
A continuación se listan los Web Services disponibles, ordenados alfabéticamente:
Web Service | País | Tipo de envío |
Accio (Amazon AWS) | México | JSON |
Aleph | México | JSON |
Alto Movup | Chile | JSON |
Altotrack | General | XML |
Arm Cybermapa (CAESSAT v2) | Argentina | JSON |
Arm Services (CAESSAT v2) | Argentina | JSON |
Assistcargo | Argentina | XML |
Aval (CAESSAT v2) | Argentina | JSON |
AVL Control | Chile | JSON |
Bermann | Chile | JSON |
Blacsolutions | México | JSON |
Boson | General | JSON |
C5 | México | JSON |
Caletabay | Chile | JSON |
Calico Cybermapa (CAESSAT v2) | Argentina | JSON |
Canacar | México | JSON |
Carbess | Chile | JSON |
Carbess (CAESSAT v2) | Argentina | JSON |
Carcoolbox GPS | General | JSON |
Cargas de combustible | Panama | JSON |
CAT | México | JSON |
Cementos Progreso | General | XML |
Centinela | México | JSON |
Centinela V2 | México | JSON |
CMSV | General | JSON |
ControlT | General | XML |
Copec | Chile | JSON |
Coyote | México | XML |
Ctac | Chile | JSON |
CyberMapa (CERSAT) | Argentina | STRING |
Don Pedro (CAESSAT v2) | Argentina | JSON |
Drivin | Guatemala | JSON |
Drive Tech | Chile | JSON |
DS | Chile | JSON |
Ecopetrol - POC | Colombia | JSON |
Ecopetrol V2 | Colombia | JSON |
Ermap (CAESSAT v2) | Argentina | JSON |
Farletza transporte | Ecuador | JSON |
Fleetio | General | JSON |
Freightverify | General | JSON |
Frulog | Chile | JSON |
Generic Web Service | General | JSON |
Geogo-Geopark | Colombia | XML |
GPS Chile | Chile | XML |
GPS Chile V2 | Chile | JSON |
Grupo UDA | México | XML |
GTrack | Chile | JSON |
I-place | México | JSON |
ILSP | México | JSON |
Integra Cemin | Chile | JSON |
Konexa | Peru | JSON |
KRONH | México | XML |
Landstar | México | XML |
Lavorante (CAESSAT v2) | Argentina | JSON |
LogicTracker (CAESSAT v2) | Argentina | JSON |
Logitex | General | JSON |
Logitrack | México | JSON |
Maersk | General | JSON |
Maersk V2 | General | JSON |
MaquinariaAmarilla | Colombia | JSON |
Marchamos | General | XML |
MaxTracker (CAESSAT v2) | Argentina | JSON |
Mercosur (CAESSAT v2) | Argentina | JSON |
Midlog / Zenware | Chile | XML |
Migtra | Chile | JSON |
Motumcloud | México | JSON |
Multitrack | México | JSON |
Navi 3.0 | General | XML |
Nettek | General | JSON |
Nexus | México | JSON |
Orbcomm | General | JSON |
Osinergmin | Peru | JSON |
OTM | General | JSON |
Overhaul GSK | México | JSON |
Paquetes | General | JSON |
Pegaso | Colombia | JSON |
Pegasus | Chile | JSON |
Position endpoint | Chile | JSON |
Project44 V2 | General | JSON |
Protrans | México | JSON |
Pub/Sub Google | General | JSON |
Pxpdu | Perú | JSON |
Pxpdu Colombia | Colombia | JSON |
Pxpdu Ecuador | Ecuador | JSON |
QMGPS | General | XML |
QuadMinds | Argentina | JSON |
Recurso Confiable Mex (Irontracking) | General | XML |
Rolbox IPS | Chile | JSON |
RsRurales (CAESSAT v2) | Argentina | JSON |
Samtech | Chile | XML |
SandBox Tracker | General | JSON |
Sauer (CAESSAT v2) | Argentina | JSON |
Semov | México | JSON |
Service Layer | Panama | JSON |
Siames C5 | México | XML |
Sider Peru | Perú | JSON |
Simpli Route | Chile | JSON |
Simpli Route & iDUX | Chile | JSON |
SIPCOP-M | Perú | JSON |
SISLOGSOS | Colombia | JSON |
Sitrack | Chile | JSON |
Sitrack Connect | México | JSON |
Skynav | Chile | JSON |
Smartsc | México | JSON |
SOS Contingencias | Colombia | JSON |
SuKarne | México | XML |
Sutran | Perú | JSON |
Tecnologistica (CAESSAT v2) | Argentina | JSON |
Torre de Control | México | JSON |
Torre dedicada mabe | México | JSON |
Tracklog | Peru | JSON |
TrackTec | Chile | JSON |
Uber Freight | México | JSON |
Unigis Argentina (antes Assistcargo) | Argentina | XML |
Unigis Bolivia | Bolivia | XML |
Unigis Chile (antes Assistcargo) | Chile | XML |
Unigis Colombia | Colombia | XML |
Unigis México (antes Assistcargo) | México | XML |
Unigis Republica Dominicana | República Dominicana | XML |
Unigis Salvador | El Salvador | XML |
Unisolutions (CAESSAT v2) | Argentina | JSON |
Vigilia seguridad (CAESSAT v2) | Argentina | JSON |
Visor Grupo Acerero | México | JSON |
Wirsolut (CAESSAT v2) | Argentina | JSON |
Wirtrack | Argentina | JSON |
Wisetrack (antes GerdauSider) | General | JSON |
WS Arm GPS | Argentina | JSON |
WS Integrados | México | JSON |
WS Position | Chile | XML |
Ziyu | Chile | JSON |
Webservice de reenvío genérico
A continuación se explica brevemente la interfaz del Servicio Web Genérico de la plataforma de Monitoreo, para sus clientes o empresas externas autorizadas.
Tecnología de integración
Para la integración del Servicio Web de la plataforma de Monitoreo, se ha diseñado una arquitectura abierta, segura y compatible con las tecnologías más utilizadas en la industria actualmente, es por ello que la interfaz que ofrecemos se encuentra desarrollada bajo los estándares de RESTful Web Services según se describe en el presente documento.
Intrucciones de uso
Para poder utilizar el Servicio Web, cada distribuidor deberá ingresar a su Partners e ingresar a la opción "Webservice", ahí se encuentra listado "Generic Web Service":
Con el botón "Asignar activos" se seleccionan los clientes y las unidades que van a retransmitir al Servicio Web Genérico.
Una vez que seleccionamos el cliente, con el botón "Credenciales", se puede ingresar las credenciales de seguridad, en caso de que sea necesario, y el hostname, donde podemos indicar la URL a donde se enviará la información.
Descripción del reenvío
Los equipos GPS del distribuidor/cliente reportan a la plataforma, se almacena la información en la base de datos (BD), el WebService Genérico se encarga de leer la información de los equipos y la reenvía a la URL que el cliente configure en la plataforma, en cuanto llegue un reporte este es inmediatamente reenviado.
La descripción general se puede representar con el siguiente diagrama:
Protocolo del WebService
Se ha creado una estructura de forma API RESTful que utiliza JSON como entrega mediante método POST, que se encarga de estar reenviando la información de los equipos GPS, que tenemos disponible en la plataforma a la URL que el cliente configure.
URL : La que el cliente configure.
Método : POST
Usuario: El que el cliente configure.
Contraseña: La que el cliente configure.
Ejemplo del envío:
{
“deviceImei”:”4176845511245678”,
“dateTimeUtc”:”2021-08-21 18:21:22”,
“dateTimeLocal”:”2021-08-21 18:23:25”,
“latitude”:-14.464430,
“longitude”:-75.405083,
“speed”:19.0,
“direction”:285,
“ignition”:1
}
Web Service de Reenvío Genérico (Nueva Versión)
A continuación se explica brevemente la interfaz del Servicio Web Genérico de la plataforma de Monitoreo, para sus clientes o empresas externas autorizadas.
Tecnología de integración
Para la integración del Servicio Web de la plataforma de Monitoreo, se ha diseñado una arquitectura abierta, segura y compatible con las tecnologías más utilizadas en la industria actualmente, es por ello que la interfaz que ofrecemos se encuentra desarrollada bajo los estándares de RESTful Web Services según se describe en el presente documento.
Instrucciones de uso
Para utilizar la nueva versión del Servicio Web, cada distribuidor deberá ingresar a su Partners e ingresar a la opción "Webservice", ahí se encuentra listado "Generic Web Service":
Con el botón "Configurar Acceso" (icono anaranjado) abriremos la interfaz para configurar las credenciales:
Se abrirá una ventana con las siguientes pestañas:
- Credenciales
- Ubicación
- Alertas
- Eventos
- Paquetes
Configurar credenciales
Con la pestaña credenciales podemos seleccionar dos tipos de recurso para asignar las recursos de seguridad para el envío de datos.
- API REST
- TCP/UDP
Acceso por API REST:
Para configurar el acceso por API REST debemos ingresar la url del Host, donde podemos indicar la URL hacia donde se enviará la información.
Acceso por TCP/UDP:
Deberá proporcionar los siguientes parámetros.
- Ip
- Puerto
- Protocolo: Debe especificar si usará TCP o UDP.
Configurar Ubicación
En esta pestaña podrá seleccionar la información que desea enviar al Web Service, deberá establecer la URL a la que desea enviar la información deseada.
En caso de necesitarlo, podrá definir un alias para los parámetros que necesitará, así como establecer el tipo especifico de dato (texto, entero, flotante, etc...)
Los valores que puede configurar en la nueva versión del web service genérico se muestran a continuación en la siguiente tabla:
URL | idconductor | gmt | tiempo | fecha | hora |
latitud | longitud | timestamp | idtipo_dato_gps | velocidad | dirección |
señal | satélites | input | odómetro | bateria_gps | bateria_veh |
ignicion | buffered | equipo_gps | imei | id_vehiculo | vehiculo |
placa | num_economico | horometro | odometro_vehiculo | notas | cliente |
idcliente | rfc | distribuidor |
Configurar Alertas
En la nueva versión del Web Service es posible seleccionar los tipos de alertas y la información que desee enviar. Es posible editar el nombre y el tipo de dato de cada una de las alertas para tener un mejor control de la información enviada.
Para hacer uso de este servicio debe habilitarlo mediante la opción "¿Enviar datos de alertas emitidas?", posteriormente ingrese la URL de su Web Service y seleccione los tipos de alerta deseados.
Los valores que puede configurar se muestran a continuación en la siguiente tabla:
equipo | fecha | hora | descripcion | latitud |
longitud | domicilio | statusalerta | tipoalerta | idtipoalerta |
Configurar Eventos
En la nueva versión del Web Service es posible seleccionar los tipos de evento y la información que desee enviar. Es posible editar el nombre y el tipo de dato de cada una de las alertas para tener un mejor control de la información enviada.
Para hacer uso de este servicio debe habilitarlo mediante la opción "¿Enviar reportes de eventos?", posteriormente ingrese la URL de su Web Service y seleccione los tipos de alerta deseados.
Los valores que puede configurar se muestran a continuación en la siguiente tabla:
idconductor | gmt | tiempo | fecha |
hora | latitud | longitud | timestamp |
idtipo_dato_gps | velocidad | dirección | señal |
satelites | inputs | odometro | bateria_gps |
bateria_veh | ignicion | buffered | equipogps |
imei | idvehiculo | vehiculo | placa |
num_economico | horometro | odometro_vehiculo | notas |
cliente | idcliente | rfc | distribuidor |
Configurar Paquetes
Los valores que puede configurar se muestran a continuación en la siguiente tabla:
idconductor | gmt | tiempo | fecha |
hora | latitud | longitud | timestamp |
idtipo_dato_gps | velocidad | direccion | señal |
satélites | inputs | odometro | bateria_gps |
bateria_veh | ignicion | buffered | equipogps |
imei | idvehiculo | vehiculo | placa |
num_economico | horometro | odometro_vehiculo | notas |
cliente | idcliente | rfc | distribuidor |
Descripción del reenvío
Los equipos GPS del distribuidor/cliente reportan a la plataforma, se almacena la información en la base de datos (BD), el WebService Genérico se encarga de leer la información de los equipos y la reenvía a la URL que el cliente configure en la plataforma, en cuanto llegue un reporte este es inmediatamente reenviado.
La descripción general se puede representar con el siguiente diagrama:
Protocolo del WebService
Se ha creado una estructura de forma API RESTful que utiliza JSON como entrega mediante método POST, que se encarga de estar reenviando la información de los equipos GPS, que tenemos disponible en la plataforma a la URL que el cliente configure.
URL : La que el cliente configure.
Método : POST
Usuario: El que el cliente configure.
Contraseña: La que el cliente configure.
Ejemplo del envío:
{
"device":"111111111111111",
"latitude":"4.608071",
"longitude":"-74.175262",
"date":"2024-09-11",
"time":"11:48:02",
"timestamp":"20240911114802",
"speed":9,
"course":236,
"ignition":1,
"satellites":10,
"idevent":1,
"event":"Movimiento",
"signal":8,
"inputs":"0",
"isbuffer":0,
"odometer":345943.64845408,
"address":"Cl. 12 Sur #78m-333, México, México",
"asset":"632",
"plate":"XXX111",
"idclient":55524,
"client":"Cliente Example",
"idgroup":6943,
"group":"GRUPO 1",
"iddriver":0,
"driver":"",
"sensors":{
"82":{
"Bateria_gps":{
"name":"Bateria_gps",
"value":"",
"datetime":"2024-09-11 11:48:02",
"percentage":100
}
}
}
}
Web Service Paquetes
A continuación se explica brevemente la interfaz del Servicio Web para el envío o retransmisión de Paquetes generados por los dispositivos reportando en la plataforma de Monitoreo, a sus clientes o empresas externas autorizadas.
Tecnología de integración
Para poder integrar el envío de Paquetes, se ha diseñado una arquitectura abierta, segura y compatible con las tecnologías más utilizadas en la industria actualmente, es por ello que la interfaz ofrecemos se encuentra desarrollada bajo los estándares de RESTful según se describe en el presente documento.
Instrucciones de uso
Para utilizar este Web Service, cada distribuidor deberá ingresar a su Partners e ingresar a la opción "Webservice", ahí se encuentra listado "Paquetes":
Con el botón "Configurar Acceso" (icono anaranjado) abriremos la interfaz para realizar las configuraciones de envío:
Se abrirá una ventana y debemos de elegir qué tipo de transmisión se va a ocupar para el envío de datos, TCP/UDP o API REST:
Configurar Recurso
Podemos seleccionar dos tipos de recursos para el envío de datos.
- API REST
- TCP/UDP
Acceso por API REST:
Para configurar el acceso por API REST debemos ingresar la url del Host, donde podemos indicar la URL hacia donde se enviará la información.
Acceso por TCP/UDP:
Deberá proporcionar los siguientes parámetros.
- Ip
- Puerto
- Protocolo: Debe especificar si usará TCP o UDP.
Asignación de clientes y sus activos para el reenvío de paquetes al recurso previamente configurado:
Descripción del reenvío
Los equipos GPS del distribuidor/cliente reportan a la plataforma, se almacenan sus paquetes crudos en la base de datos (BD), el Web Service Paquetes se encarga de obtener la información de los paquetes crudos de los equipos y la reenvía a la URL o IP que se haya configurado previamente, en cuanto se obtenga un paquete este es inmediatamente reenviado.
La descripción general se puede representar con el siguiente diagrama:
Estructura del Web Service
Se ha creado una estructura que utiliza JSON como entrega, dependiendo la configuración TCP/UDP o API REST.
Ejemplo del envío:
{
"device":"345456577489456",
"package":"2525A47121111JD124552525",
"date":"2024-09-11",
"time":11:48:02",
"asset":"AA123",
"plate":"SPP433"
}
Visualización del log para el envío de paquetes: