Fleet Debugger is an open-source web tool designed to help you visualize and analyze logs from Google Maps Platform’s Mobility solutions, supporting both Scheduled tasks and On-demand trips. It provides an interactive map and timeline to analyze vehicle and task or trip data, running entirely in your browser.

Key Features
Fleet Debugger helps you understand complex journey and vehicle behaviors by offering:
- Interactive map and timeline replay: Observe vehicle movement in real time or at an accelerated time-lapse.
- Synchronization: Events are linked across the map, data table, and timeline. Click an event in one place, and it’s highlighted everywhere.
- Detailed log entry inspection: Deep dive into API requests and responses.
- Filter & inspect log messages: Use customizable table views to easily find and analyze specific log entries.
- File Import: Load logs from JSON or ZIP files.
- Direct Cloud Logging Connection: Securely fetch logs directly from your Google Cloud project.
- Flexible Filtering: Easily narrow down data by time range, entity IDs, and more.
- View status changes: Track changes in vehicle, trip, task, and navigation status.
- Visualize multiple trips: View all trips or tasks for a single vehicle.
- Analyze GPS data: Examine location, accuracy, and heading information.
- Analyze dwell times: Measure time spent at specific locations (dwell times).
- View planned navigation routes: See the routes with traffic conditions as experienced by drivers (requires Restricted Use Logs).
- See requested vs. actual pickup and dropoff points: (requires Restricted Use Logs).
- Map and Timeslider Interaction: Click directly on the map or the timeslider to select the nearest log event.
- Tracking (Chevron): Use the tracking button to keep the map centered on the current event during replay.
- Exporting Logs: Export loaded dataset to a local file for easy collaboration.
Using the Demo Site
The fastest way to get started is using our GitHub hosted site.
This site includes demo data for:
Loading Your Data
Click on any empty “Load Dataset” button to open the data loading interface.

1. Direct Cloud Logging Connection (Recommended)
- Configure Parameters: Input your Project ID, Vehicle ID(s) or Trip/Task ID(s), and the selected time range within the UI.
- Connect to Cloud Logging: Click the “Sign in and Fetch Logs” button and follow the prompts to authenticate with your Google Account and grant access. You’ll need appropriate IAM permissions (e.g.,
roles/logging.viewer) to read logs.
2. Import from Log Files
You can load log data from JSON or ZIP files using the “Load JSON or ZIP file instead” button. This is useful for:
- Analyzing logs shared with you.
- Loading previously exported datasets.
You can export logs from the Google Cloud Console’s Logs Explorer.
Note: All data processing happens client-side. Your logs or API keys are not uploaded to any server. Data is stored in your browser’s Local Storage.
Restricted Use Logs
To see features like the driver’s planned navigation route, traffic, and original requested stop locations, you need to enable
Restricted Use Logs in your Google Cloud project. This is not required for the tool to function but highly recommended for a richer analysis.
Managing Datasets
Each dataset has a dropdown menu:
- Export: Save the current dataset as a JSON file to your local system.
- Delete: Remove the dataset from the Fleet Debugger and your browser’s local storage.
Restoring Demo Data
To reload the original demo data:
- Select “Delete” from the
Dataset 1 dropdown menu.
- Refresh the page. The demo data will be automatically reloaded.
Running Your Own Server
Development Setup
- Install dependencies:
- Clone the repository:
git clone https://github.com/googlemaps/fleet-debugger.git
cd fleet-debugger
- Install node modules:
- Add Maps Javascript API Key to src/constants.js
Start development server
This will open the app in your default browser, usually at http://localhost:3000.
Building and Deploying
# Generate static build
npm run build
The static files will be in the build folder. You can deploy this folder to any static site hosting service. For Firebase Hosting:
# Optional: Install Firebase CLI globally
npm install -g firebase-tools
# Deploy to Firebase Hosting
firebase deploy --only hosting
(Requires Firebase project setup and firebase login)
Privacy
This project is 100% client-side. Please see our Privacy Policy for full details.
Support & Contributing
This Fleet Debugger tool is offered under an open source license. It is not an officially supported Google product.