Skip to content

Latest commit

 

History

History
485 lines (450 loc) · 10.1 KB

File metadata and controls

485 lines (450 loc) · 10.1 KB

Fleet Location Tracking - Event Types Reference

Complete reference for all event types generated by the unified fleet tracking event generator.


Trip Lifecycle Events

trip_started

{
  "event_id": "evt_001",
  "event_type": "trip_started",
  "timestamp": "2025-11-03T10:00:00.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "device_id": "GPS_DEVICE_789",
  "location": {
    "lat": 37.7749,
    "lng": -122.4194
  },
  "planned_distance_km": 142.5,
  "estimated_duration_hours": 4.5
}

trip_completed

{
  "event_id": "evt_002",
  "event_type": "trip_completed",
  "timestamp": "2025-11-03T14:30:00.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "device_id": "GPS_DEVICE_789",
  "location": {
    "lat": 37.8044,
    "lng": -122.2712
  },
  "total_distance_km": 142.5,
  "duration_minutes": 270,
  "fuel_consumed_percent": 18.5
}

trip_cancelled

{
  "event_id": "evt_003",
  "event_type": "trip_cancelled",
  "timestamp": "2025-11-03T11:30:00.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "cancellation_reason": "vehicle_malfunction",
  "location": {
    "lat": 37.7650,
    "lng": -122.4350
  },
  "distance_completed_km": 12.8,
  "elapsed_time_minutes": 40
}

Location & Movement Events

location_ping

{
  "event_id": "evt_004",
  "event_type": "location_ping",
  "timestamp": "2025-11-03T10:05:00.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "location": {
    "lat": 37.7751,
    "lng": -122.4189,
    "accuracy_meters": 8.5,
    "altitude_meters": 15.2
  },
  "movement": {
    "speed_kmh": 45.0,
    "heading_degrees": 85.3,
    "moving": true
  },
  "distance_travelled_km": 12.5,
  "signal_quality": "excellent",
  "device": {
    "battery_level": 87.3,
    "charging": false
  },
  "overspeed": false
}

signal_lost

{
  "event_id": "evt_005",
  "event_type": "signal_lost",
  "timestamp": "2025-11-03T11:15:08.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "location": {
    "lat": 37.7521,
    "lng": -121.9552,
    "accuracy_meters": 8.5,
    "altitude_meters": 45.2
  },
  "movement": {
    "speed_kmh": 65.0,
    "heading_degrees": 125.3,
    "moving": true
  },
  "distance_travelled_km": 45.8,
  "signal_quality": "poor",
  "device": {
    "battery_level": 78.5,
    "charging": false
  },
  "overspeed": true
}

signal_recovered

{
  "event_id": "evt_006",
  "event_type": "signal_recovered",
  "timestamp": "2025-11-03T11:15:45.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "location": {
    "lat": 37.7528,
    "lng": -121.9485,
    "accuracy_meters": 12.5,
    "altitude_meters": 48.7
  },
  "movement": {
    "speed_kmh": 62.0,
    "heading_degrees": 128.7,
    "moving": true
  },
  "distance_travelled_km": 46.2,
  "signal_quality": "fair",
  "device": {
    "battery_level": 78.4,
    "charging": false
  },
  "overspeed": true,
  "signal_lost_duration_seconds": 37,
  "signal_quality_after_recovery": "fair"
}

Vehicle State Events

vehicle_stopped

{
  "event_id": "evt_007",
  "event_type": "vehicle_stopped",
  "timestamp": "2025-11-03T10:35:00.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "location": {
    "lat": 37.7950,
    "lng": -122.4000,
    "accuracy_meters": 8.5,
    "altitude_meters": 25.2
  },
  "movement": {
    "speed_kmh": 35.0,
    "heading_degrees": 95.3,
    "moving": true
  },
  "distance_travelled_km": 25.8,
  "signal_quality": "good",
  "device": {
    "battery_level": 82.1,
    "charging": false
  },
  "overspeed": false
}

vehicle_moving

{
  "event_id": "evt_008",
  "event_type": "vehicle_moving",
  "timestamp": "2025-11-03T10:48:00.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "location": {
    "lat": 37.7950,
    "lng": -122.4000,
    "accuracy_meters": 8.5,
    "altitude_meters": 25.2
  },
  "movement": {
    "speed_kmh": 15.0,
    "heading_degrees": 95.3,
    "moving": true
  },
  "distance_travelled_km": 25.8,
  "signal_quality": "good",
  "device": {
    "battery_level": 82.1,
    "charging": false
  },
  "overspeed": false,
  "stop_duration_minutes": 13
}

speed_violation

{
  "event_id": "evt_009",
  "event_type": "speed_violation",
  "timestamp": "2025-11-03T11:47:20.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "location": {
    "lat": 37.7895,
    "lng": -122.3752,
    "accuracy_meters": 8.5,
    "altitude_meters": 35.2
  },
  "movement": {
    "speed_kmh": 120.0,
    "heading_degrees": 185.3,
    "moving": true
  },
  "distance_travelled_km": 85.8,
  "signal_quality": "excellent",
  "device": {
    "battery_level": 65.1,
    "charging": false
  },
  "overspeed": true,
  "speed_limit_kmh": 105,
  "violation_amount_kmh": 15,
  "severity": "moderate"
}

Telemetry Events

vehicle_telemetry

{
  "event_id": "evt_010",
  "event_type": "vehicle_telemetry",
  "timestamp": "2025-11-03T10:15:42.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "location": {
    "lat": 37.7758,
    "lng": -122.4181,
    "accuracy_meters": 8.5,
    "altitude_meters": 15.2
  },
  "movement": {
    "speed_kmh": 55.0,
    "heading_degrees": 85.3,
    "moving": true
  },
  "distance_travelled_km": 15.8,
  "signal_quality": "excellent",
  "device": {
    "battery_level": 87.3,
    "charging": false
  },
  "overspeed": false,
  "telemetry": {
    "odometer_km": 125678.5,
    "fuel_level_percent": 68.5,
    "engine_hours": 8456,
    "coolant_temp_celsius": 90,
    "oil_pressure_kpa": 290,
    "battery_voltage": 13.8
  }
}

device_error

{
  "event_id": "evt_011",
  "event_type": "device_error",
  "timestamp": "2025-11-03T12:25:00.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "location": {
    "lat": 37.7885,
    "lng": -122.3825,
    "accuracy_meters": 8.5,
    "altitude_meters": 25.2
  },
  "movement": {
    "speed_kmh": 45.0,
    "heading_degrees": 95.3,
    "moving": true
  },
  "distance_travelled_km": 45.8,
  "signal_quality": "good",
  "device": {
    "battery_level": 75.1,
    "charging": false
  },
  "overspeed": false,
  "error_type": "sensor_malfunction",
  "error_code": "ERR_FUEL_SENSOR_003",
  "error_message": "Fuel level sensor reading invalid",
  "severity": "warning"
}

System Warning Events

battery_low

{
  "event_id": "evt_012",
  "event_type": "battery_low",
  "timestamp": "2025-11-03T15:30:00.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "location": {
    "lat": 37.8150,
    "lng": -122.3500,
    "accuracy_meters": 8.5,
    "altitude_meters": 45.2
  },
  "movement": {
    "speed_kmh": 35.0,
    "heading_degrees": 125.3,
    "moving": true
  },
  "distance_travelled_km": 125.8,
  "signal_quality": "good",
  "device": {
    "battery_level": 9.5,
    "charging": false
  },
  "overspeed": false,
  "battery_level_percent": 9.5,
  "threshold_percent": 10,
  "estimated_remaining_hours": 2.5
}

Fuel Events

fuel_level_low

{
  "event_id": "evt_013",
  "event_type": "fuel_level_low",
  "timestamp": "2025-11-03T13:15:00.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "location": {
    "lat": 37.7885,
    "lng": -122.3825,
    "accuracy_meters": 8.5,
    "altitude_meters": 35.2
  },
  "movement": {
    "speed_kmh": 55.0,
    "heading_degrees": 125.3,
    "moving": true
  },
  "distance_travelled_km": 95.8,
  "signal_quality": "good",
  "device": {
    "battery_level": 65.1,
    "charging": false
  },
  "overspeed": false,
  "fuel_level_percent": 14.5,
  "threshold_percent": 15,
  "estimated_range_km": 45
}

refueling_started

{
  "event_id": "evt_014",
  "event_type": "refueling_started",
  "timestamp": "2025-11-03T13:25:00.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "location": {
    "lat": 37.7935,
    "lng": -122.3894,
    "accuracy_meters": 8.5,
    "altitude_meters": 35.2
  },
  "movement": {
    "speed_kmh": 45.0,
    "heading_degrees": 125.3,
    "moving": true
  },
  "distance_travelled_km": 105.8,
  "signal_quality": "good",
  "device": {
    "battery_level": 62.1,
    "charging": false
  },
  "overspeed": false
}

refueling_completed

{
  "event_id": "evt_015",
  "event_type": "refueling_completed",
  "timestamp": "2025-11-03T13:38:00.000Z",
  "vehicle_id": "VH_123",
  "trip_id": "trip_20251103_100000",
  "location": {
    "lat": 37.7935,
    "lng": -122.3894,
    "accuracy_meters": 8.5,
    "altitude_meters": 35.2
  },
  "movement": {
    "speed_kmh": 45.0,
    "heading_degrees": 125.3,
    "moving": true
  },
  "distance_travelled_km": 105.8,
  "signal_quality": "good",
  "device": {
    "battery_level": 62.1,
    "charging": false
  },
  "overspeed": false,
  "refuel_duration_minutes": 13,
  "fuel_level_after_refuel": 85.0,
  "fuel_added_percent": 70.5
}

Summary

This reference covers all event types generated by the unified fleet tracking event generator. Each event includes:

  • Event ID: Unique identifier for tracking and deduplication
  • Event Type: Clear categorization for event processing
  • Timestamp: ISO 8601 format in UTC with dynamic timing
  • Vehicle ID: Identifier for the vehicle
  • Trip ID: Links events to specific trips
  • Location: GPS coordinates with accuracy and altitude
  • Movement: Speed, heading, and movement status
  • Device: Battery level and charging status
  • Overspeed: Boolean flag indicating speed limit violations
  • Event-Specific Data: Additional contextual information per event type

Event Categories

  1. Trip Lifecycle Events (3 events): trip_started, trip_completed, trip_cancelled
  2. Location & Movement Events (3 events): location_ping, signal_lost, signal_recovered
  3. Vehicle State Events (3 events): vehicle_stopped, vehicle_moving, speed_violation
  4. Telemetry Events (2 events): vehicle_telemetry, device_error
  5. System Warning Events (1 event): battery_low
  6. Fuel Events (3 events): fuel_level_low, refueling_started, refueling_completed

Total Event Types: 15