¿ Quieres integrar tu app o dispositivo con nuestra plataforma ? WPs, STOPS, SPEED, Regularidad y API Integracion - TeamTrack

Vaya al Contenido

¿ Quieres integrar tu app o dispositivo con nuestra plataforma ? WPs, STOPS, SPEED, Regularidad y API Integracion

A. Uso de WP en eventos

Como controlar la parada STOPs, la velocidad en zonas de velocidad controlada, paso por WP de control, WP para eventos de regularidad y WP varios.


1. Control de parada en STOPS
Para controlar que los pilotos hacen los STOPs de al menos 1 segundo en los puntos deseados es tan sencillo como insertar en el GPX que se adjunta para la verificacion de la prueba unos WP con la siguiente estructura.

STOPX

El nombre del WP debe ser STOP en mayuscula seguido del numero de STOP.
Ejemplo:
STOP1,STOP56, etc.

2. Control de velocidad maxima en zonas concretas
Se puede controlar que el piloto no excede la velocidad en zonas concretas, en el momento en el que un piloto excede la velocidad aunque solo sea una vez en un tramo ya se considera como tramo penalizado, el sistema indicará cuantas zonas de control de velocidad valido o penalizo. Si tiene por ejemplo 6 zonas de velocidad controlada y el piloto excede la velocidad en dos zonas marcaria como correctas 4 de 6 zonas.
Para controlar que los pilotos no exceden la velocidad en zonas concretas hay que insertar en el GPX que se adjunta para la verificacion de la prueba unos WP con la siguiente estructura.

SPEED_XXX_T_NN

XXX = Velocidad. Valor numerico, digitos del 0 al 9 si son dos digitos introducir un 0 delante.
T = Tipo de Inicio o Fin de tramos. Opciones (I = inicio, F = Fin)
N = Numero del wp. Valor numerico, digitos del 0 al 9 si un digito introducir un 0 delante.
Ejemplo:
SPEED_090_I_01 ( Inicio de tramo de control de velocidad a 90 )
SPEED_090_F_01 ( Fin de tramo de control de velocidad a 90 )

3. Control de paso por WPs
Se puede controlar que el piloto pasa por los WPs deseados, el sistema indicara por cual de los WP el piloto paso y lo validará. Si por ejemplo el GPX tiene 256 WP y el piloto solo registro el paso por 232 el sistema marcaria como validados o correctos 232 de 256.
Para ello es tan sencillo como insertar en el GPX que se adjunta para la verificacion de la prueba unos WP con la siguiente estructura.

CPXX

El nombre del WP debe empezar por CP en mayuscula seguido del numero de WP.
Ejemplo:
CP1,CP34,etc

4. Control de paso por WP de eventos de regularidad
Se puede controlar que el piloto pasa por los WPs deseados a la hora deseada, el sistema indicara por cual de los WP el piloto paso dentro del tiempo de margen establecido y penalizará con la diferencia de tiempo.
El sistema permite un rango de tiempo en el cual el piloto no tendra penalizacion, una penalizacion por cada segundo de retraso o anticipo y una penalizacion por no pasar por el WP
Imaginemos un WP que tiene la hora de paso 1h 45min  y 21 seg tras la salida del piloto y que el rango de tiempo de cortesia son 20 seg.
Si el piloto pasa 1h 45 min y 15 seg tras su salida el sistema penalizara con 0 puntos al piloto.
Para ello es tan sencillo como insertar en el GPX que se adjunta para la verificacion de la prueba unos WP con la siguiente estructura.


CPRXXXXX

El nombre del WP debe empezar por CPR en mayuscula seguido de los segundos a los que debe pasar el piloto por el WP tras su salida.
XXXXX = segundos. Valor numerico, digitos del 0 al 9 si no se llega a los cinco digitos introducir un 0 delante.

Ejemplo:
CPR00034 = Wp de control de regularidad, el piloto debe pasar por el 34 segundos tras su salida
CPR02421= Wp de control de regularidad, el piloto debe pasar por el 2421 segundos tras su salida

5. WP varios
Se insertar WP informativos en el mapa para la web de seguimiento. Para ello es tan sencillo como insertar en el GPX que se adjunta para la verificacion de la prueba unos WP con la siguiente estructura.

Cualquier nombre de WP que no comience con los WP indicados anteriormente, es decir que no empiecen por SPEED, STOP, CP ó CPR.


B. API de integración enviar datos a TeamTrack

¿ Quieres integrar tu app o dispositivo con nuestra plataforma ?

Solicitanos la documentación y te explicamos como hacerlo facilmente.

Podrás enviarnos desde tu app o dispositivo los datos a nuestra plataforma para poder ubicarlos en nuestros mapas usando todas nuestras funciones y de forma gratuita.






Se realiza mediante un protocolo HTTP GET con la siguiente estructura:

https://www.teamtrackonline.com/gestion/inputs/input.php?lat=latitud&lon=longitud&speed=velocidad&datetime=datetime&altitude=altitud&battery=bateria&usuario_tt=id_usuario_tt&key_api=key


Ejemplos de valores:
latitud: 22.54596 (obligatorio)
longitud: 113.94389 (obligatorio)
velocidad: 23.56
datetime: 2018/12/04Z08:39:03 (obligatorio)
altitud: 128
bateria: 95
id_usuario_tt: 1285 (obligatorio)
key_api: fwf3gSgry436736assgsS (obligatorio)



Enviando la ubicacion desde tu app o dispositivo a nuestra plataforma podrás usar como hasta ahora las webs de seguimiento de TeamTrack. Asi como el historico de movimientos, ver la ubicacion enviada desde el app de TeamTrack en dispositivos iOS y Android, etc ...




Formato de consultas
CampoTipoComentario
latitud
Double. Con punto como separador de decimales
Latitud de la ubicacion.
Ejemplo: 22.54876
Admite negativo tipo -3.345
Campo obligatorio.
longitud
Double. Con punto como separador de decimales
Longitud de la ubicacion.
Ejemplo: 113.54876
Admite negativo tipo -42.845
Campo obligatorio.
velocidad
Double. Con punto como separador de decimales
Velocidad actual del usuario expresada en km/h.
Ejemplo: 23.56
En caso de no usar enviar 0.
datetimeDatetime. AAAA/MM/DDZHH:MM_SSUsar Z como separador entre la fecha y la hora.
Ejemplo: 2018/12/04Z08:39:03
Campo obligatorio.
altitud
Double. Con punto como separador de decimales
Altura del usuario expresada en metros
Ejemplo: 128.32
En caso de no usar enviar 0.
bateria
Double. Con punto como separador de decimales
Nivel de bateria del dispositivo.
Ejemplo: 95
En caso de no usar enviar 0.
id_usuario_ttInteger.Numero de ID de usuario de TeamTrack.
Ejemplo: 1464
Campo obligatorio.
puntos_no
Double. Con punto como separador de decimales
Puntos de Naviopen.
Ejemplo: 251.12
Admite negativos.
En caso de no usar enviar 0.
key_apivarchar 30 caracteresKey del API proporcionada por TeamTrack que identifica la aplicacion que envia los datos.
Campo obligatorio.
Respuestas:

OK - Informacion recibida
Error - Error en la informacion adjuntada. Revisar los datos enviados.

C. API de integración obtener los datos de TeamTrack

¿ Quieres sacar los datos de nuestra plataforma para gestionarlos o mostrarlos ?

Solicitanos la documentación y te explicamos como hacerlo facilmente.


Existes distintas consultas:

1. Consulta de datos de participantes apuntados a un evento
2. Consulta del recorrido de un participante en un intervalo de tiempo


1. Consulta de datos de participantes apuntados a un evento

Se realiza mediante un protocolo HTTP GET con la siguiente estructura:

https://www.teamtrackonline.com/dka/existe.php?action=participants&race_id=race_id&api_key=key_api  


Ejemplos de valores:
race_id: 365 (obligatorio) - Id del evento
key_api: At7ZKBEPqLE3G4w4MPWFidOlw4kjuX (obligatorio)

Ejemplo de consulta:

https://www.teamtrackonline.com/dka/existe.php?action=participants&race_id=365&api_key=At7ZKBEPqLE3G4w4MPWFidOlw4kjuX

Al realizar la consulta el sistema responde con la informacion de los participantes al evento con los siguientes datos:

[
{"nombre_usuario":"Piloto 1 ","num_dorsal":"1","ultima_actualizacion":"2021-03-17 09:14:46","lat":"37.425678","lon":"-2.972899","vel":"43.1","alt":"1206.6","bateria":"63 %"},
{"nombre_usuario":"Piloto 2 ","num_dorsal":"2","ultima_actualizacion":"2021-03-17 09:14:36","lat":"37.423009","lon":"-2.970436","vel":"55.4","alt":"1226.5","bateria":"58 %"},
{"nombre_usuario":"Piloto 3 ","num_dorsal":"3","ultima_actualizacion":"2021-03-17 09:14:47","lat":"37.422543","lon":"-2.980097","vel":"28.7","alt":"1182.5","bateria":"96 %"},
{"nombre_usuario":"Piloto 4 ","num_dorsal":"4","ultima_actualizacion":"2021-03-17 09:14:26","lat":"37.434076","lon":"-2.999814","vel":"82.3","alt":"1115.1","bateria":"55 %"},
{"nombre_usuario":"Piloto 5 ","num_dorsal":"5","ultima_actualizacion":"2021-03-17 09:14:45","lat":"37.425076","lon":"-2.994982","vel":"39.1","alt":"1113.0","bateria":"62 %"},
{"nombre_usuario":"Piloto 5 ","num_dorsal":"R","ultima_actualizacion":"2021-03-17 09:14:47","lat":"37.485225","lon":"-3.032848","vel":"27.0","alt":"1000.5","bateria":"100 %"}
]

2. Consulta del recorrido de un participante en un intervalo de tiempo

Se realiza mediante un protocolo HTTP GET con la siguiente estructura:

http://www.teamtrackonline.com/dka/existe.php?action=participant_route&race_id=race_id&num_dorsal=num_dorsal&date_time_ini=date_time_ini&date_time_fin=date_time_fin&api_key=key_api

Ejemplos de valores:
race_id: 365 (obligatorio) Id del evento
num,_dorsal: 1 (obligatorio) Numero de dorsal del piloto
date_time_ini: 2020/12/04Z08:30:00 (obligatorio) Fecha y hora desde donde se mostraran los registros del piloto
date_time_fin: 2020/12/04Z19:30:00 (obligatorio) Fecha y hora hasta donde se mostraran los registros del piloto
key_api: At7ZKBEPqLE3G4w4MPWFidOlw4kjuX (obligatorio)

Ejemplo de consulta:

https://www.teamtrackonline.com/dka/existe.php?action=participant_route&race_id=365&num_dorsal=3&date_time_ini=2021-03-17Z08:04:00&date_time_fin=2021-03-17Z08:04:55&api_key=At7ZKBEPqLE3G4w4MPWFidOlw4kjuX

Al realizar la consulta el sistema responde con la informacion de los participantes al evento con los siguientes datos:

[
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.2","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:01"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:03"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:05"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:07"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:09"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:11"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:13"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:15"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:17"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:19"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:21"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:23"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:25"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:27"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:29"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:31"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:33"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:35"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:37"},
{"usuario":"3901","lat":"37.294017","lon":"-3.167673","alt":"985.0","vel":"0.0","bearing":"27","GNSS_AC":"1","fecha":"2021-03-17 08:04:39"},
{"usuario":"3901","lat":"37.294038","lon":"-3.167659","alt":"985.2","vel":"8.7","bearing":"18","GNSS_AC":"1","fecha":"2021-03-17 08:04:41"},
{"usuario":"3901","lat":"37.294060","lon":"-3.167653","alt":"985.0","vel":"3.4","bearing":"10","GNSS_AC":"1","fecha":"2021-03-17 08:04:43"},
{"usuario":"3901","lat":"37.294066","lon":"-3.167652","alt":"984.6","vel":"0.5","bearing":"10","GNSS_AC":"1","fecha":"2021-03-17 08:04:45"},
{"usuario":"3901","lat":"37.294066","lon":"-3.167652","alt":"984.7","vel":"0.0","bearing":"10","GNSS_AC":"1","fecha":"2021-03-17 08:04:47"},
{"usuario":"3901","lat":"37.294066","lon":"-3.167652","alt":"984.7","vel":"0.0","bearing":"10","GNSS_AC":"1","fecha":"2021-03-17 08:04:49"},
{"usuario":"3901","lat":"37.294066","lon":"-3.167652","alt":"984.7","vel":"0.0","bearing":"10","GNSS_AC":"1","fecha":"2021-03-17 08:04:53"},
{"usuario":"3901","lat":"37.294066","lon":"-3.167652","alt":"984.7","vel":"0.0","bearing":"10","GNSS_AC":"1","fecha":"2021-03-17 08:04:55"},
]


Regreso al contenido