Skip to content

Latest commit

 

History

History
108 lines (82 loc) · 3.69 KB

README.md

File metadata and controls

108 lines (82 loc) · 3.69 KB

Fleet Debugger Tool

A visualization and debugging tool for Google Maps Platform's Mobility Solutions, supporting Scheduled tasks and On-demand trips.

Screenshot

Using the Demo Site(s)

The fastest way to get started is using our GitHub hosted site
https://googlemaps.github.io/fleet-debugger/demos/multiple-trips

We also have demo data for:

Loading Your Data

  1. Export your Fleet Engine logs from Cloud Logging using this filter (customize as needed): \
-- On-demand trips
resource.type="fleetengine.googleapis.com/Fleet"
AND (labels.vehicle_id="YOUR_VEHICLE_ID" OR
     labels.trip_id=~"(TRIP_ID_1|TRIP_ID_2)")
AND timestamp >= "START_TIME" -- ISO 8601 format (YYYY-MM-DDTHH:MM:SS)
AND timestamp <= "END_TIME" -- ISO 8601 format (YYYY-MM-DDTHH:MM:SS)
AND (
    logName:"logs/fleetengine.googleapis.com%2Fcreate_vehicle" OR
    logName:"logs/fleetengine.googleapis.com%2Fupdate_vehicle" OR
    logName:"logs/fleetengine.googleapis.com%2Fcreate_trip" OR
    logName:"logs/fleetengine.googleapis.com%2Fupdate_trip"
)
-- Scheduled tasks
resource.type="fleetengine.googleapis.com/DeliveryFleet"
AND (labels.delivery_vehicle_id="YOUR_VEHICLE_ID" OR
     labels.task_id=~"(TASK_ID_1|TASK_ID_2)")
AND timestamp >= "START_TIME" -- ISO 8601 format (YYYY-MM-DDTHH:MM:SS)
AND timestamp <= "END_TIME" -- ISO 8601 format (YYYY-MM-DDTHH:MM:SS)
AND (
    logName:"logs/fleetengine.googleapis.com%2Fcreate_delivery_vehicle" OR
    logName:"logs/fleetengine.googleapis.com%2Fupdate_delivery_vehicle" OR
    logName:"logs/fleetengine.googleapis.com%2Fcreate_task" OR
    logName:"logs/fleetengine.googleapis.com%2Fupdate_task"
)
  1. Download the logs in JSON format and optionally zip them
  2. Import the JSON/ZIP file to Fleet Debugger

Note: All data processing happens client-side. Your logs remain in your browser's Local Storage and are not uploaded to Google/GitHub.

Key Features

  • Filter & inspect log messages with customizable table views
  • View planned navigation routes with traffic conditions as experienced by drivers
  • Replay vehicle movement (real time or time lapse)
  • See requested vs. actual pickup and dropoff points
  • View status changes (vehicle, trip, navigation)
  • Analyze GPS data (location, accuracy, heading)
  • Visualize multiple trips for one vehicle
  • View GPS accuracy, speed, and heading
  • Analyze dwell times

Note: Planned navigation routes and Pickup/DropOff points requires enablement of Restricted Use Logs

Restoring Demo Data

To restore the original demo data after overwriting it:

  1. Long press the "Dataset 1" button
  2. When prompted, do NOT upload a file
  3. Refresh the page

Running Your Own Server

Development Setup

  1. Install dependencies:

  2. Install node modules:

npm install

Start development server

npm start

Building and Deploying

# Generate static build
npm run build

# Deploy to firebase
npm install -g firebase-tools
firebase deploy --only hosting

Disclaimer

This is not an officially supported Google product.

Additional Resources