MANUAL DE INTEGRACIÓN GPS

PARA MINERA CENTINELA

(PROVEEDORES GPS)
SERVICIO DE GESTIÓN, CONTROL Y MONITOREO DE RUTAS Y
VELOCIDADES EN MINERA CENTINELA
 Página 2 de 9

Índice
1 Introducción .......................................................................................................................................... 3
2 Descripción............................................................................................................................................ 3
3 Proceso de integración de datos GPS ................................................................................................... 4
3.1 Instrucciones de integración de datos GPS ................................................................................... 4
3.2 Manual de integración de datos GPS ............................................................................................ 5
3.2.1 Datos acceso webservice ...................................................................................................... 5
3.2.2 Definición de campos webservice......................................................................................... 5
3.2.3 Formatos de Fecha Compatibles ........................................................................................... 7
3.2.4 Respuestas webservice ......................................................................................................... 8
3.2.5 Tabla de eventos GPS ............................................................................................................ 8
3.2.6 Consideraciones respecto a la integración ........................................................................... 9
3.2.7 Consideraciones respecto a la certificación .......................................................................... 9

A
en p
al
fid v S
ci
on a
C yn
Sk

Versión Descripción Autor Fecha

1.0 Primera revisión Reinaldo Espejo 04-08-2023
1.1 Se agrega consideraciones de datos Pablo Espejo 22-08-2023
y detalles varios.

MANUAL DE INTEGRACIÓN GPS PARA

SERVICIO DE GESTIÓN, CONTROL Y MONITOREO DE RUTAS Y VELOCIDADES EN MINERA CENTINELA
MINERA CENTINELA (PROVEEDORES GPS)
 Página 3 de 9

1 Introducción

Este documento tiene como finalidad entregar las características del proceso de integración de datos GPS
para poder acreditar vehículos que harán ingreso a dependencias de Minera Centinela. El proceso de
certificación se detalla en el manual de certificado GPS, que será entregado a empresas contratistas.

2 Descripción

Este manual está dirigido hacia las empresas proveedoras de servicios de posicionamiento GPS,
detallándose el proceso para realizar la integración de datos hacia el sistema de integración MCEN –
SKYNAV.

Agradecemos que dispongan del tiempo para leer detenidamente este manual, para así evitar futuros
inconvenientes a la hora de integrar y acreditar un vehículo.

A
en p
al
fid v S
ci
on a
C yn
Sk

MANUAL DE INTEGRACIÓN GPS PARA

SERVICIO DE GESTIÓN, CONTROL Y MONITOREO DE RUTAS Y VELOCIDADES EN MINERA CENTINELA
MINERA CENTINELA (PROVEEDORES GPS)
 Página 4 de 9

3 Proceso de integración de datos GPS

El proceso que se detalla a continuación está enfocado hacia los proveedores GPS. Para el proceso de
certificación y revisión de los datos de cada empresa, favor solicitar y revisar el manual respectivo.

El token generado corresponde al acceso para el proveedor GPS, éste puede ser utilizado para todos sus
clientes y móviles que requieran integrarse al sistema.

3.1 Instrucciones de integración de datos GPS

Los pasos que debe seguir el proveedor GPS son:

1. Enviar un email a integracion.centinela@skynav.cl con el asunto “Solicitud token de acceso”.

2. Adjuntar en el correo los siguientes datos:
a. RUT del proveedor
b. Nombre del proveedor (ej. “GPS Valdivia S.A.”)
c. Nombre corto del proveedor (ej. “valdivia”)

A
3. Una vez validados los datos, se ingresará información al sistema y se enviará token de acceso para
comenzar con sus pruebas y/o envíos de datos.
en p 4. Desarrollar integración de datos GPS. Puede usar la URL de Pruebas para verificar que no haya
errores en el envío de datos (no se guardan ni registran datos en esta URL)
5. Enviar datos a URL producción, solicitar en el mismo ticket de integración la confirmación que la

al
fid v S
integración está OK.

ci
on a
C yn
Sk

MANUAL DE INTEGRACIÓN GPS PARA

SERVICIO DE GESTIÓN, CONTROL Y MONITOREO DE RUTAS Y VELOCIDADES EN MINERA CENTINELA
MINERA CENTINELA (PROVEEDORES GPS)
 Página 5 de 9

3.2 Manual de integración de datos GPS

3.2.1 Datos acceso webservice

• URL Producción: https://external.skynav.cl/integrador/centinela/transmision

• URL Pruebas: https://external.skynav.cl/integrador/centinela/test/transmision
• Método: POST
• Headers:
o Content-Type: application/json
o Authorization: Bearer {token entregado posterior al registro como proveedor}
• Body: Listado de transmisiones en formato JSON, definido en la siguiente sección

3.2.2 Definición de campos webservice

Los datos deben ser enviados en formato JSON, en forma de lista de una o más transmisiones (límite
sugerido 10.000).

A
Ejemplo de dato enviado:

[
en p {
"patente":"AABB99",
"imei":"886552321556",
"latitud": -30.6584,

al
fid v S
"longitud": -70.6584,
"altitud": 1000.0,
"fechaHora":"08-03-2023 22:05:33",
"evento":41,
ci "velocidad":100,
"heading":270,
"ignicion":1
},
on a

{
"patente":"XXYY33",
"imei":"886552321543",
"latitud": -30.6584,
C yn

"longitud": -70.6584,
"altitud": 1000.0,
"fechaHora":"08-03-2023 22:05:34",
"evento":41,
"velocidad":90,
"heading":15,
Sk

"ignicion":1
}
]

MANUAL DE INTEGRACIÓN GPS PARA

SERVICIO DE GESTIÓN, CONTROL Y MONITOREO DE RUTAS Y VELOCIDADES EN MINERA CENTINELA
MINERA CENTINELA (PROVEEDORES GPS)
 Página 6 de 9

Los campos de cada transmisión se definen en la siguiente tabla:

Campo Descripción Tipo Dato Obligatorio

Fecha y hora del evento, en hora local, y
formateada en alguno de los formatos
fechaHora String Sí
compatibles, definidos en la tabla
“Formatos de Fecha Compatibles”

latitud Latitud en formato decimal WGS84 Double o String Sí

longitud Longitud en formato decimal WGS84 Double o String Sí
Patente del vehículo, con o sin guiones o
patente String Sí
espacios
imei IMEI del GPS asociado al vehículo String No
Código del Evento, según tabla “Códigos de
evento Integer o String No
Eventos GPS”
velocidad Velocidad en km/h Integer o String Sí

A
altitud Altitud en metros Double o String No
heading Heading en valor entero entre 0° y 360° Integer o String Sí
en p Valor numérico para representar el estado
de la ignición del vehículo:

al
ignicion Integer o String Sí
fid v S
Ignición ON = 1
Ignición OFF = 0
ci
on a
C yn
Sk

MANUAL DE INTEGRACIÓN GPS PARA

SERVICIO DE GESTIÓN, CONTROL Y MONITOREO DE RUTAS Y VELOCIDADES EN MINERA CENTINELA
MINERA CENTINELA (PROVEEDORES GPS)

3.2.3 Formatos de Fecha Compatibles
Los formatos de fecha/hora aceptados se definen a continuación. Todas las fechas horas serán
decodificadas en hora local, independiente del formato que se utilice.
Considerar como ejemplo, la fecha/hora local “01-08-2023 18:30:10”
Formato
yyyy-MM-dd HH:mm:ss
yyyy-MM-dd'T'HH:mm:ss
yyyy-MM-dd h:mm:ss a
yyyy-MM-dd'T'h:mm:ss a
yyyy-MM-dd HH:mm:ss.SSS
yyyy-MM-dd HH:mm:ss.SSS z
yyyy-MM-dd HH:mm:ss.SSS Z
yyyy-MM-dd HH:mm:ss.SSSX
yyyy-MM-dd HH:mm:ss.SSSXXX
dd-MM-yyyy HH:mm:ss
A
dd-MM-yyyy'T'HH:mm:ss
dd-MM-yyyy h:mm:ss a
dd-MM-yyyy'T'h:mm:ss a
en pdd-MM-yyyy HH:mm:ss.SSS
dd-MM-yyyy HH:mm:ss.SSS z
al
dd-MM-yyyy HH:mm:ss.SSS Z
fid v S
dd-MM-yyyy HH:mm:ss.SSSX
dd-MM-yyyy HH:mm:ss.SSSXXX
yyyy/MM/dd HH:mm:ss
ciyyyy/MM/dd'T'HH:mm:ss
yyyy/MM/dd h:mm:ss a
on a
yyyy/MM/dd'T'h:mm:ss a
yyyy/MM/dd HH:mm:ss.SSS
yyyy/MM/dd HH:mm:ss.SSS z
C yn
yyyy/MM/dd HH:mm:ss.SSS Z
yyyy/MM/dd HH:mm:ss.SSSX
yyyy/MM/dd HH:mm:ss.SSSXXX
dd/MM/yyyy HH:mm:ss
Sk
dd/MM/yyyy'T'HH:mm:ss
dd/MM/yyyy h:mm:ss a
dd/MM/yyyy'T'h:mm:ss a
dd/MM/yyyy HH:mm:ss.SSS
dd/MM/yyyy HH:mm:ss.SSS z
dd/MM/yyyy HH:mm:ss.SSS Z
dd/MM/yyyy HH:mm:ss.SSSX
dd/MM/yyyy HH:mm:ss.SSSXXX
MANUAL DE INTEGRACIÓN GPS PARA
SERVICIO DE GESTIÓN, CONTROL Y MONITOREO DE RUTAS Y VELOCIDADES EN MINERA CENTINELA
MINERA CENTINELA (PROVEEDORES GPS)
Página 7 de 9
Ejemplo
2023-08-01 18:30:10
2023-08-01T18:30:10
2023-08-01 6:30:10 PM
2023-08-01T6:30:10 PM
2023-08-01 18:30:10.123
2023-08-01 18:30:10.123 GMT-03
2023-08-01 18:30:10.123 -0300
2023-08-01 18:30:10.123-3
2023-08-01 18:30:10.123-03:00
01-08-2023 18:30:10
01-08-2023T18:30:10
01-08-2023 6:30:10 PM
01-08-2023T6:30:10 PM
01-08-2023 18:30:10.123
01-08-2023 18:30:10.123 GMT-03
01-08-2023 18:30:10.123 -0300
01-08-2023 18:30:10.123-3
01-08-2023 18:30:10.123-03:00
2023/08/01 18:30:10
2023/08/01T18:30:10
2023/08/01 6:30:10 PM
2023/08/01T6:30:10 PM
2023/08/01 18:30:10.123
2023/08/01 18:30:10.123 GMT-03
2023/08/01 18:30:10.123 -0300
2023/08/01 18:30:10.123-3
2023/08/01 18:30:10.123-03:00
01/08/2023 18:30:10
01/08/2023T18:30:10
01/08/2023 6:30:10 PM
01/08/2023T6:30:10 PM
01/08/2023 18:30:10.123
01/08/2023 18:30:10.123 GMT-03
01/08/2023 18:30:10.123 -0300
01/08/2023 18:30:10.123-3
01/08/2023 18:30:10.123-03:00
 Página 8 de 9

3.2.4 Respuestas webservice

El servidor responde un código HTTP de acuerdo al nivel de éxito de la comunicación: 200 si el proceso se
realizó correctamente, 4XX si hubo un problema grave que no permitió procesar el envío.

Además, en el cuerpo de la respuesta se adjunta un JSON con un resumen del resultado del procesamiento
de los datos. Este JSON tiene la siguiente estructura:

{
"mensaje": "", //mensaje de OK o descripción de un error general 4XX
"recibidos": 0, //cantidad de transmisiones recibidas
"correctos": 0, //cantidad de transmisiones completas y correctas
"incorrectos": 0, //cantidad de transmisiones con faltas de completitud o con datos inválidos
"procesados": 0, //cantidad de transmisiones procesadas e insertadas
"errores": [] //mensajes de error en caso de tener transmisiones incorrectas
}

A continuación, se muestran algunas respuestas típicas:

200 OK
{

A
"mensaje": "OK",
"recibidos": 1,
"correctos": 1,
"incorrectos": 0,
en p }
"procesados": 1,
"errores": []

al
fid v S
422 Unprocessable Entity
"mensaje": "Error al procesar una o más fechas: JSON parse error: … ",
"recibidos": 0,
ci "correctos": 0,
"incorrectos": 0,
"procesados": 0,
"errores": []
on a

} // Los errores fatales ocurren al momento de procesar la llamada, por lo que los contadores siempre estarán en cero en estos casos

3.2.5 Tabla de eventos GPS

C yn

EVENTO DESCRIPCIÓN
41 Posición con Ignición ON (Movimiento)
42 Posición con Ignición OFF (Estacionado)
Sk

51 Ignición ON
52 Ignición OFF
911 Botón de Pánico

MANUAL DE INTEGRACIÓN GPS PARA

SERVICIO DE GESTIÓN, CONTROL Y MONITOREO DE RUTAS Y VELOCIDADES EN MINERA CENTINELA
MINERA CENTINELA (PROVEEDORES GPS)
 Página 9 de 9

3.2.6 Consideraciones respecto a la integración

• Las transmisiones deben ser enviadas en vivo. No hay límite en la frecuencia del envío.

• La cantidad máxima de transmisiones por envío es de 10.000, sin embargo, esto no debiese
suceder, al ser un requerimiento el que las transmisiones no se encolen.

• Considerar un timeout de conexión y respuesta de 30 segundos, o de 5 segundos por cada 100

transmisiones en el caso de esperar una respuesta

• No es necesario esperar respuestas, se puede enviar de manera asíncrona y manejar las

respuestas en los casos necesarios

• Considerar una política de reintento de conexión de al menos 30 segundos, ya que eso es lo que
demora el proceso de fail-over en casos de caída o interrupción de alguno de los servidores

• Reportar errores que no tengan causa clara al correo integracion.centinela@skynav.cl con el

asunto “Error en integración Centinela”. Se debe adjuntar un detalle del JSON enviado.

A
3.2.7 Consideraciones respecto a la certificación
en p Para generar un certificado a la empresa respectiva, se tomarán en cuenta los siguientes puntos:

al
fid v S
• Fecha Hora: debe reportar información en vivo (Ej: datos actualizados dentro del mismo día, no
fechas/horas futuras)
ci • Latitud / Longitud: posición debe estar dentro de territorio chileno. (Ej: no tener transmisiones
con lat/long “0,0” o “-90,-180”)
• Patente: debe ser en formato válido (AABB11)
on a

• Patentes Válidas: se debe enviar datos exclusivamente de vehículos acreditados / por acreditar.
• Heading: el vehículo debe reportar su heading correctamente. (Ej: no tener un valor fijo durante
C yn

movimientos)
• Ignición: se debe reportar ignición correctamente (Ej: 1 en movimiento, 0 estacionado)
• Frecuencia: en movimiento debe generar datos cada 20 segundos, en detención cada 1 hora (Esto
no influye en la frecuencia de envío de datos, la cual puede ser menor)
Sk

El no cumplimiento de estos puntos puede ser motivo de no entrega de certificado y/o bloqueo de token
de acceso en caso de recurrencia.

MANUAL DE INTEGRACIÓN GPS PARA

SERVICIO DE GESTIÓN, CONTROL Y MONITOREO DE RUTAS Y VELOCIDADES EN MINERA CENTINELA
MINERA CENTINELA (PROVEEDORES GPS)