Fahrzeugtelemetrie und -verfolgung

Fahrzeugtelemetrie ist der Echtzeit-Datenstrom von den IoT-Geräten Ihrer Flotte. Diese Anleitung behandelt, wie Telemetrie funktioniert, welche Daten verfügbar sind und wie Sie sie für das Flottenmanagement nutzen können.

Was ist Fahrzeugtelemetrie?

Telemetrie bezieht sich auf die automatisierte Erfassung und Übertragung von Daten von Ihren Fahrzeugen zur Levy Fleets-Plattform. Das IoT-Gerät jedes Fahrzeugs meldet kontinuierlich:

• Standort - GPS-Koordinaten
• Akkuladestände - Sowohl Fahrzeug- als auch IoT-Akku
• Sperrzustand - Ob das Fahrzeug gesperrt oder entsperrt ist
• Bewegungsstatus - In Bewegung oder stationär
• Geschwindigkeit - Aktuelle Geschwindigkeit
• Kilometerstand - Gesamte zurückgelegte Strecke
• Fehlercodes - Alle Geräte- oder Fahrzeugfehler
• Signalstärke - Mobilfunk-Verbindungsqualität

Wie Telemetrie funktioniert

Datenfluss

Fahrzeug-IoT-Gerät → Mobilfunknetz → Levy-Server → Dashboard
        ↓                                    ↓
    Sendet Daten                      Speichert & verarbeitet
    alle 10-60 Sek.                   Aktualisiert in Echtzeit

Aktualisierungsfrequenz

Telemetrie-Aktualisierungsintervalle variieren je nach Gerätetyp und Zustand:

Telemetriedaten anzeigen

Fahrzeuglistenansicht

Die Fahrzeugliste zeigt wichtige Telemetriedaten auf einen Blick:

Fahrzeugdetailseite

Die Detailseite bietet umfassende Telemetrie:

Status- und Telemetrie-Karte:

• Fahrzeug-Akkuprozentsatz mit Farbcodierung
• IoT-Akkuprozentsatz (getrennt vom Fahrzeugakku)
• Ladeanzeige
• Sperr-/Entsperrstatus
• Aktuelle GPS-Koordinaten mit Zeitstempel
• Signalstärkenanzeige
• Fehlercodes (falls vorhanden)

Standortkarte:

• Aktuelle Positionsmarkierung
• Historischer Standortverlauf
• Zonen-Overlays

Echtzeit-Updates

Telemetrie wird automatisch über WebSocket-Abonnements aktualisiert:

1. Wenn Sie eine Fahrzeugdetailseite öffnen, wird ein Abonnement erstellt
2. Neue Telemetrie wird sofort an Ihren Browser gepusht
3. Status-Badges, Akkuladestände und Standort aktualisieren sich ohne Seitenaktualisierung
4. Das Verlassen der Seite schließt das Abonnement

GPS-Verfolgung

Standortdaten

Jedes GPS-Update enthält:

Standortgenauigkeit

Die GPS-Genauigkeit variiert je nach Bedingungen:

Historische Verfolgung

Sehen Sie, wo sich ein Fahrzeug befunden hat:

1. Öffnen Sie die Fahrzeugdetailseite
2. Betrachten Sie die Standortkarte
3. Der historische Breadcrumb-Trail zeigt die letzten Positionen
4. Fahren Sie mit der Maus über Punkte, um Zeitstempel zu sehen

Akkuüberwachung

Zwei Akkutypen

Die meisten Fahrzeuge melden zwei Akkuladestände:

Akkuladestandanzeigen

Farbcodierung hilft, den Akkuzustand schnell zu bewerten:

Ladeerkennung

Das Feld is_charging zeigt an, wenn ein Fahrzeug angeschlossen ist:

• Zeigt Ladesymbol in der Fahrzeugliste
• Nützlich zur Verfolgung der Ladestationsnutzung
• Hilft zu überprüfen, ob Ladegeräte funktionieren

Sperrzustandsüberwachung

Sperrstatus

Fahrzeuge melden ihren aktuellen Sperrzustand:

Sperr-/Entsperr-Ereignisse

Jede Sperrzustandsänderung wird protokolliert:

• Wer die Änderung initiiert hat (Kunde, Personal, System)
• Zeitstempel der Änderung
• Befehlserfolg/-misserfolg
• Nützlich für Auditing und Fehlerbehebung

Signal und Konnektivität

Mobilfunksignal

Telemetrie enthält Signalqualitätsindikatoren:

Zeit seit letztem Signal

Der "Letztes Signal"-Zeitstempel zeigt, wann das Gerät zuletzt kommuniziert hat:

Fehlercodes

Fehlercodes verstehen

IoT-Geräte melden Fehlercodes, wenn Probleme auftreten:

Fehler anzeigen

Fehler erscheinen in:

• Fahrzeugdetailseite (Statusbereich)
• Aktueller Telemetrie-Feed
• Alarmbenachrichtigungen (falls konfiguriert)

Häufige Fehlercodes

Telemetrie-Feed

Roh-Telemetrieansicht

Auf der Fahrzeugdetailseite erweitern Sie "Befehle anzeigen", um Roh-Telemetrie zu sehen:

• Letzte 30 Nachrichten angezeigt
• Klicken Sie auf Einträge, um vollständige Payload zu erweitern
• Rohdaten zum Debuggen kopieren
• Nachrichtentypen angezeigt (Status, Heartbeat, Bestätigung)

Nachrichtentypen

Telemetrie für Flottenmanagement nutzen

Fahrzeuge mit niedrigem Akku finden

1. Gehen Sie zur Fahrzeuge-Seite
2. Klicken Sie auf Weitere Filter
3. Setzen Sie Akkuladestand (Max %) auf 20
4. Sehen Sie alle Fahrzeuge, die geladen werden müssen

Offline-Fahrzeuge lokalisieren

1. Klicken Sie auf die Offline-Statuskarte
2. Überprüfen Sie die letzten bekannten Standorte
3. Prüfen Sie die Zeitstempel des letzten Signals
4. Priorisieren Sie die Untersuchung nach Offline-Dauer

Aktive Fahrten überwachen

Während einer Fahrt zeigt die Telemetrie:

• Echtzeit-Standort-Updates
• Geschwindigkeitsüberwachung
• Akkuentladungsrate
• Zurückgelegte Strecke

Anomalien erkennen

Achten Sie auf ungewöhnliche Muster:

• Plötzliche Standortsprünge (GPS-Glitch oder Transport)
• Schnelle Akkuentladung (potenzielles Problem)
• Längere Zeiträume ohne Bewegung (möglicherweise zurückgelassen)
• Sperrzustand entspricht nicht dem erwarteten (Befehlsfehler)

Telemetriespeicherung

Datenspeicherung

Telemetriedaten werden gespeichert für:

Zugriff auf historische Daten

• Fahrzeugdetailseite zeigt aktuelle Historie
• Export über API für längere Analysen
• Fahrtdetailseiten enthalten fahrtspezifische Telemetrie

API-Zugriff

Fahrzeugtelemetrie abrufen

GET /api/vehicles/{id}

Gibt aktuellen Telemetriezustand zurück:

{
  "id": "fahrzeug-uuid",
  "vehicle_number": "VH-001",
  "battery_level": 85,
  "iot_battery_pct": 92,
  "is_charging": false,
  "lock_status": "locked",
  "latitude": 40.7128,
  "longitude": -74.0060,
  "last_location_update": "2025-01-15T12:30:00Z",
  "vehicle_odometer": "1234.5",
  "gps_signal": 4,
  "error_code": null
}

Echtzeit-Updates abonnieren

Verwenden Sie Supabase-Echtzeit-Abonnements:

const subscription = supabase
  .channel('vehicle-telemetry')
  .on('postgres_changes',
    { event: 'UPDATE', schema: 'public', table: 'vehicles', filter: `id=eq.${vehicleId}` },
    (payload) => {
      console.log('Telemetrie-Update:', payload.new)
    }
  )
  .subscribe()

Fehlerbehebung

Keine Telemetrie-Updates

1. Fahrzeug-Akkuladestand prüfen (kann leer sein)
2. Überprüfen, ob IoT-Gerät korrekt verknüpft ist
3. Mobilfunkabdeckung am Fahrzeugstandort prüfen
4. Letzte bekannte Position auf Hinweise überprüfen
5. Physische Inspektion kann erforderlich sein

Ungenaues GPS

1. GPS-Genauigkeitsfeld in Telemetrie prüfen
2. Fahrzeug kann sich in Innenräumen oder schlechter Abdeckung befinden
3. Zeit für GPS-Fix nach Geräteweckung einräumen
4. Auf Antennenprobleme am Gerät prüfen

Akkuanzeige falsch

1. Fahrzeug- vs. IoT-Akkuanzeigen vergleichen
2. Prüfen, ob Ladeanzeige der Realität entspricht
3. Akkukalibrierung kann erforderlich sein
4. Auf Akkuverbindungsprobleme prüfen

Verzögerte Updates

1. Mobilfunksignalstärke überprüfen
2. Prüfen, ob Gerät im Schlafmodus ist
3. IoT-Gerätekonfiguration überprüfen
4. Kann auf Netzwerküberlastung hinweisen

---