Integrations-API

A. Verwendung von WPs bei Veranstaltungen

So kontrollieren Sie STOPs, die Geschwindigkeit in Kontrollzonen, die Durchfahrt an Kontroll-WPs, WPs für Gleichmäßigkeitsprüfungen und sonstige WPs.

1. Haltkontrolle an STOPS

Um zu prüfen, ob die Fahrer an den gewünschten Punkten STOPs von mindestens 1 Sekunde einlegen, fügen Sie einfach in die GPX-Datei zur Prüfung der Veranstaltung WPs mit folgender Struktur ein.

STOPX

Der WP-Name muss STOP in Großbuchstaben sein, gefolgt von der STOP-Nummer.

Beispiel:

STOP1 , STOP56 , etc.

2. Höchstgeschwindigkeitskontrolle in bestimmten Zonen

Man kann prüfen, ob der Fahrer in bestimmten Zonen die Geschwindigkeit überschreitet. Sobald er sie in einem Abschnitt auch nur einmal überschreitet, gilt dieser als bestraft, und das System zeigt an, wie viele Kontrollzonen bestanden oder bestraft wurden. Gibt es zum Beispiel 6 Zonen und überschreitet der Fahrer die Geschwindigkeit in zweien, werden 4 von 6 Zonen als korrekt gewertet.

Um zu prüfen, ob die Fahrer in bestimmten Zonen die Geschwindigkeit nicht überschreiten, fügen Sie in die GPX-Datei zur Prüfung der Veranstaltung WPs mit folgender Struktur ein.

SPEED_XXX_T_NN

• XXX = Geschwindigkeit. Numerischer Wert, Ziffern 0 bis 9; bei zwei Ziffern eine 0 voranstellen.
• T = Typ Abschnittsbeginn oder -ende. Optionen (I = Beginn, F = Ende)
• N = WP-Nummer. Numerischer Wert, Ziffern 0 bis 9; bei einer einzelnen Ziffer eine 0 voranstellen.

Beispiel:

SPEED_090_I_01  ( Beginn eines 90er-Geschwindigkeitsabschnitts )
SPEED_090_F_01  ( Ende eines 90er-Geschwindigkeitsabschnitts )

3. Durchfahrtskontrolle an WPs

Man kann prüfen, ob der Fahrer die gewünschten WPs passiert: Das System zeigt an, welche WPs er passiert hat, und wertet sie. Hat die GPX-Datei z. B. 256 WPs und der Fahrer hat nur 232 passiert, werden 232 von 256 als gültig gewertet.

Dazu fügen Sie einfach in die GPX-Datei zur Prüfung der Veranstaltung WPs mit folgender Struktur ein.

CPXX

Der WP-Name muss mit CP in Großbuchstaben beginnen, gefolgt von der WP-Nummer.

Beispiel:

CP1 , CP34 ,etc

4. Durchfahrtskontrolle an WPs von Gleichmäßigkeitsprüfungen

Man kann prüfen, ob der Fahrer die gewünschten WPs zur gewünschten Zeit passiert: Das System zeigt an, welche WPs innerhalb der Toleranz passiert wurden, und bestraft die Zeitdifferenz.

Das System erlaubt ein Zeitfenster ohne Strafe für den Fahrer, eine Strafe pro Sekunde Verspätung oder Verfrühung und eine Strafe für das Auslassen des WP

Nehmen wir einen WP mit einer Durchfahrtszeit von 1 h 45 min 21 s nach dem Start und einer Toleranz von 20 s.

Passiert der Fahrer 1 h 45 min 15 s nach dem Start, vergibt das System 0 Strafpunkte.

Dazu fügen Sie einfach in die GPX-Datei zur Prüfung der Veranstaltung WPs mit folgender Struktur ein.

CPRXXXXX

Der WP-Name muss mit CPR in Großbuchstaben beginnen, gefolgt von den Sekunden nach dem Start, zu denen der Fahrer den WP passieren muss.

• XXXXX = Sekunden. Numerischer Wert, Ziffern 0 bis 9; bei weniger als fünf Ziffern mit Nullen auffüllen.

Beispiel:

CPR00034  = WP der Gleichmäßigkeitskontrolle, der Fahrer muss ihn 34 Sekunden nach dem Start passieren
CPR02421 = WP der Gleichmäßigkeitskontrolle, der Fahrer muss ihn  2421  Sekunden nach dem Start passieren

5. Sonstige WPs

Informative WPs werden auf der Karte der Tracking-Website angezeigt. Dazu fügen Sie einfach in die GPX-Datei zur Prüfung der Veranstaltung WPs mit folgender Struktur ein.

Jeder WP-Name, der nicht mit den oben genannten WPs beginnt, also nicht mit SPEED, STOP, CP oder CPR.

---

B. Integrations-API: Daten an TeamTrack senden

Möchten Sie Ihre App oder Ihr Gerät mit unserer Plattform verbinden?

Fordern Sie die Dokumentation an, und wir erklären Ihnen, wie es ganz einfach geht.

Sie können Daten aus Ihrer App oder Ihrem Gerät an unsere Plattform senden, um sie auf unseren Karten darzustellen – mit allen Funktionen und kostenlos.

Dies erfolgt über eine HTTP-GET-Anfrage mit folgender Struktur:

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

Beispielwerte:

latitud : 22.54596 (Pflicht)
longitud : 113.94389 (Pflicht)
velocidad : 23.56
datetime : 2018/12/04Z08:39:03 (Pflicht)
altitud:  128
bateria:  95
id_usuario_tt : 1285 (Pflicht)
key_api : TU_KEY_API (Pflicht)

Wenn Sie die Position aus Ihrer App oder Ihrem Gerät an unsere Plattform senden, können Sie wie gewohnt die TeamTrack-Tracking-Websites nutzen, ebenso den Bewegungsverlauf, die aus der TeamTrack-App auf iOS- und Android-Geräten gesendete Position usw.

Abfrageformat:

Antworten:

• OK – Daten empfangen
• Fehler – Fehler in den übermittelten Daten. Bitte die gesendeten Daten prüfen.

---

C. Integrations-API: Daten aus TeamTrack abrufen

Möchten Sie Daten aus unserer Plattform abrufen, um sie zu verwalten oder anzuzeigen?

Fordern Sie die Dokumentation an, und wir erklären Ihnen, wie es ganz einfach geht.

Es gibt verschiedene Abfragen:

1. Abfrage der Daten der für eine Veranstaltung angemeldeten Teilnehmer

Dies erfolgt über eine HTTP-GET-Anfrage mit folgender Struktur:

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

Beispielwerte:

race_id : 365 (Pflicht) – Veranstaltungs-ID
key_api :  TU_KEY_API  (Pflicht)

Beispielabfrage:

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

Bei der Abfrage antwortet das System mit den Informationen zu den Teilnehmern der Veranstaltung und folgenden Daten:

[
{"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. Abfrage der Strecke eines Teilnehmers in einem Zeitraum

Dies erfolgt über eine HTTP-GET-Anfrage mit folgender Struktur:

https://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

Beispielwerte:

race_id : 365 (Pflicht) Veranstaltungs-ID
num_dorsal : 1 (Pflicht) Startnummer des Fahrers
date_time_ini : 2020/12/04Z08:30:00 (Pflicht) Datum und Uhrzeit, ab denen die Daten des Fahrers angezeigt werden
date_time_fin : 2020/12/04Z19:30:00 (Pflicht) Datum und Uhrzeit, bis zu denen die Daten des Fahrers angezeigt werden
backup_gps : 1 oder 0 (optional) 1 sendet die Daten des Ersatzsenders, 0 die des Hauptsenders; standardmäßig die des Hauptsenders
key_api : TU_KEY_API (Pflicht)

Beispielabfrage:

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

Bei der Abfrage antwortet das System mit den Informationen zu den Teilnehmern der Veranstaltung und folgenden Daten:

[
{"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"}
]