API Documentation

GET /api/gtfs-realtime/vehicle-positions

Fetch real-time vehicle positions from DRT GTFS Realtime feed.

Response Schema:

{
  vehicles: LiveVehicle[];
  count: number;
  timestamp: string;
}

LiveVehicle {
  vehicleId: string;
  vehicleLabel?: string;
  routeId?: string;
  routeShortName?: string; // e.g., "112" (from routes.txt)
  routeLongName?: string; // Full route name (from routes.txt)
  routeColor?: string; // Route color hex (from routes.txt)
  routeTextColor?: string; // Route text color hex (from routes.txt)
  tripId?: string;
  tripHeadsign?: string; // Destination name (e.g., "Downtown", "Airport") from trips.txt
  directionId?: number; // 0 or 1 for different directions
  latitude: number;
  longitude: number;
  bearing?: number;
  speed?: number; // meters per second
  timestamp?: number; // Unix timestamp in seconds
  currentStopSequence?: number;
  stopId?: string;
  currentStatus?: number;
}