92 lines
2.6 KiB
Markdown
92 lines
2.6 KiB
Markdown
# Train Tracker
|
|
|
|
## Beschreibung
|
|
|
|
Train Tracker ist ein in Go geschriebenes Programm, das Echtzeitinformationen über Zugbewegungen verfolgt und speichert. Es nutzt die DB-Vendo-API, um Abfahrtsinformationen von spezifizierten Bahnhöfen abzurufen, berechnet die aktuelle Position der Züge basierend auf ihrer Route und speichert diese Informationen in einer MySQL-Datenbank.
|
|
|
|
## Funktionen
|
|
|
|
- Abrufen von Zugabfahrten für mehrere Bahnhöfe
|
|
- Berechnung der aktuellen Zugposition basierend auf Abfahrtszeit und Routeninformationen
|
|
- Speichern und Aktualisieren von Zuginformationen in einer MySQL-Datenbank
|
|
- Automatisches Löschen veralteter Einträge
|
|
- Regelmäßige Protokollierung von Datenbankstatistiken
|
|
|
|
## Voraussetzungen
|
|
|
|
- Go 1.15 oder höher
|
|
- MySQL-Datenbank
|
|
- Zugang zur DB-Vendo-API
|
|
|
|
## Installation
|
|
|
|
1. Klonen Sie das Repository:
|
|
```
|
|
git clone https://code.brothertec.eu/simono41/train-tracker.git
|
|
```
|
|
|
|
2. Navigieren Sie in das Projektverzeichnis:
|
|
```
|
|
cd train-tracker
|
|
```
|
|
|
|
3. Installieren Sie die Abhängigkeiten:
|
|
```
|
|
go mod tidy
|
|
```
|
|
|
|
## Konfiguration
|
|
|
|
Konfigurieren Sie die Anwendung über folgende Umgebungsvariablen:
|
|
|
|
- `DB_DSN`: MySQL-Datenbankverbindungsstring
|
|
- `API_BASE_URL`: Basis-URL der DB-Vendo-API
|
|
- `DURATION`: Zeitspanne in Minuten für die Abfrage von Abfahrten
|
|
- `DELETE_AFTER_MINUTES`: Zeit in Minuten, nach der alte Einträge gelöscht werden
|
|
- `STATION_IDS`: Komma-getrennte Liste von Bahnhofs-IDs
|
|
|
|
## Datenbankstruktur
|
|
|
|
Stellen Sie sicher, dass Ihre MySQL-Datenbank eine `trips`-Tabelle mit folgender Struktur hat:
|
|
|
|
```sql
|
|
CREATE TABLE trips (
|
|
id VARCHAR(36) PRIMARY KEY,
|
|
timestamp DATETIME,
|
|
train_name VARCHAR(255),
|
|
fahrt_nr VARCHAR(255),
|
|
trip_id VARCHAR(255),
|
|
latitude DOUBLE,
|
|
longitude DOUBLE
|
|
);
|
|
```
|
|
|
|
## Verwendung
|
|
|
|
1. Setzen Sie die erforderlichen Umgebungsvariablen.
|
|
|
|
2. Starten Sie die Anwendung:
|
|
```
|
|
go run main.go
|
|
```
|
|
|
|
Die Anwendung wird nun kontinuierlich Abfahrtsinformationen abrufen, die Zugpositionen berechnen und in der Datenbank speichern.
|
|
|
|
## Entwicklung
|
|
|
|
### Code-Struktur
|
|
|
|
- `main.go`: Hauptanwendungslogik und Einstiegspunkt des Programms
|
|
- Funktionen wie `fetchDepartures()`, `fetchTripDetails()`, `savePosition()`, `calculateCurrentPosition()` und `deleteOldEntries()` implementieren die Kernfunktionalität
|
|
|
|
### Beitrag
|
|
|
|
Beiträge sind willkommen! Bitte erstellen Sie einen Pull Request für Verbesserungen oder Fehlerbehebungen.
|
|
|
|
## Lizenz
|
|
|
|
Dieses Projekt ist unter der [MIT-Lizenz](https://opensource.org/licenses/MIT) lizenziert.
|
|
|
|
## Kontakt
|
|
|
|
Bei Fragen oder Problemen öffnen Sie bitte ein Issue im [Git-Repository](https://code.brothertec.eu/simono41/train-tracker).
|