# Tracking

See where your vehicles, drivers, and assets are right now on a live map, and review their trip history, events, and video footage.

<figure><img src="/files/ywAQtkz02rNWQe8C3a0N" alt=""><figcaption></figcaption></figure>

## Overview

From the sidebar, select **Tracking** (satellite icon) to open the fleet tracking page. The Tracking page uses a split-panel layout: a searchable list panel on the left and an interactive map powered by **Trimble Maps** on the right.

The tracking page supports three distinct modes --- **Vehicles**, **Drivers**, and **Assets** --- each tailored to a different operational view. Switch between modes using the toolbar buttons at the top of the page.

## Toolbar

The toolbar sits at the top of the tracking page and provides quick access to mode switching, map controls, and display overlays.

<figure><img src="/files/Y8Ni93BZWkbpkJR1ewR8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The toolbar is hidden by default. To show it, click the **Config** (cog) button and enable the **Show Toolbar** toggle.
{% endhint %}

| Control          | Description                                                                                              |
| ---------------- | -------------------------------------------------------------------------------------------------------- |
| **Vehicles**     | Switch to Vehicle mode (default). Shows all tracked vehicles.                                            |
| **Drivers**      | Switch to Driver mode. Shows drivers with active vehicle assignments.                                    |
| **Assets**       | Switch to Asset mode. Shows vehicles classified as assets.                                               |
| **Keep In View** | When enabled, the map automatically re-centres on the selected vehicle or driver if it moves off-screen. |
| **POIs**         | Show or hide Point of Interest markers on the map.                                                       |
| **Fleets**       | Show or hide fleet grouping overlays.                                                                    |
| **Cost Centres** | Show or hide Cost Centre overlays.                                                                       |
| **Geofences**    | Show or hide geofence boundaries on the map.                                                             |
| **Search**       | Type an address and press **Enter** to fly the map to that location.                                     |

The mode buttons are mutually exclusive, only one mode can be active at a time. The display toggles (POIs, Fleets, Cost Centres, Geofences) can each be turned on or off independently.

## Tracking modes

FleetFusion offers three tracking modes, each designed for a different operational focus. For full detail on each mode, see [Tracking Modes](/documentation/fleet-operations/tracking/tracking-modes.md).

### Vehicle mode (default)

Vehicle mode shows all vehicles with connected telematics devices on the map and in the list panel. Each list entry displays the vehicle's VRN, current speed, location, assigned driver, and any active alerts.

You can choose from five display styles for the vehicle list via the **Config** menu:

| Style                  | Description                                             |
| ---------------------- | ------------------------------------------------------- |
| **Standard**           | Icon and key details in a balanced card layout.         |
| **Standard Text Only** | Text-only cards without vehicle icons.                  |
| **List View**          | Compact single-line rows for high-density viewing.      |
| **Detailed**           | Expanded cards with additional telemetry data.          |
| **Minimal**            | Stripped-back cards showing only essential information. |

### Driver mode

Driver mode shows drivers as the primary entity rather than vehicles. The list displays driver names with their assigned vehicle VRN as secondary information. Only drivers with active vehicle assignments and valid GPS positions appear.

On the map, drivers are represented by circular avatar icons (a blue generic icon if no photo has been uploaded) with a white border and drop shadow. Driver name labels appear beneath each marker.

### Asset mode

Asset mode filters the list and map to show only vehicles where the vehicle type is set to **Asset**. Assets use grey container-style icons on the map. Several detail tabs are disabled in this mode, only **Info** and **Events** are available.

## Detail tabs

When you select a vehicle, driver, or asset from the list, a detail panel appears with tabbed access to different data views.

| Tab            | Description                                                             | Availability                                           |
| -------------- | ----------------------------------------------------------------------- | ------------------------------------------------------ |
| **Info**       | Summary of the selected entity, location, speed, driver, device status. | All modes                                              |
| **Trips**      | Trip history with route replay, timeline, and journey statistics.       | Vehicles and Drivers only                              |
| **Events**     | Driving events such as harsh braking, speeding, and idling.             | All modes                                              |
| **Videos**     | Video footage from connected cameras (FTCloud devices).                 | Vehicles and Drivers only                              |
| **Playback**   | Live route playback for a selected trip.                                | Vehicles and Drivers (requires FTCloud)                |
| **Livestream** | Real-time camera feed from the vehicle.                                 | Vehicles and Drivers (requires FTCloud, device online) |

Tab icons display in full colour when active and appear faded when the tab is inactive or unavailable.

{% hint style="warning" %}
**Playback** and **Livestream** tabs are disabled when the vehicle does not have an FTCloud device connected, or when the device is offline. The tab icons appear greyed out to indicate this.
{% endhint %}

{% hint style="info" %}
When viewing trips, the selected trip date persists when you switch between vehicles, it does not reset to today's date. This makes it easy to compare trips across vehicles for the same day.
{% endhint %}

## Timeline

When viewing the **Trips** tab, a timeline strip appears beneath the map showing a visual summary of the selected trip.

* **Thumbnail strip** --- Displays Street View images along the route. For vehicles with FTCloud devices, real camera snapshots are shown instead.
* **Activity bar** --- A colour-coded bar beneath the thumbnails: green for driving, amber for idle, and grey for parked.
* **Hover preview** --- Hover over any thumbnail or the activity bar to see an enlarged preview. FTCloud vehicles show a larger preview (420 x 260 px) with real camera imagery.

### Route rendering

Trip routes are drawn on the map using a three-layer rendering technique for clarity:

1. **Base layer** --- The primary route colour.
2. **Mid layer** --- A white wash for contrast.
3. **Top layer** --- A white centre-line that creates a glossy road effect.

## Map features

### POI markers

When the **POIs** display toggle is enabled, Points of Interest appear on the map as light blue circles with their name labels. If a vehicle is within 100 metres of a POI, a purple marker icon appears in the vehicle's location text in the list panel.

### Road sign colour coding

Location text in the vehicle list uses UK road sign colour conventions for road numbers:

| Road type        | Colour           | Example |
| ---------------- | ---------------- | ------- |
| **Motorway (M)** | Blue background  | M1, M25 |
| **A road**       | Green background | A1, A66 |
| **B road**       | White background | B1234   |

This colour coding also applies to road references appearing mid-string, such as *(A66)* or *(M 4)*.

## Config menu

Click the **Config** (cog) button to open the configuration panel. The menu uses a two-column layout.

### Left column, List settings

| Setting           | Description                                                                                        |
| ----------------- | -------------------------------------------------------------------------------------------------- |
| **Display Style** | Choose from five list display styles (Standard, Standard Text Only, List View, Detailed, Minimal). |
| **Customise**     | Configure vehicle icon appearance and VRN display style.                                           |
| **Speed Info**    | Toggle speed information display in the vehicle list.                                              |

### Right column, Map settings

| Setting                    | Description                                                           |
| -------------------------- | --------------------------------------------------------------------- |
| **Selected Vehicle Style** | Choose how the currently selected vehicle is highlighted on the map.  |
| **Parked Transparent**     | When enabled, parked vehicles appear with reduced opacity on the map. |
| **Show Toolbar**           | Toggle the toolbar visibility at the top of the page.                 |

## How tracking works

Vehicle tracking requires a connected telematics device installed in the vehicle. FleetFusion integrates with telematics providers through the integration marketplace (configured under **Settings > Integrations**). Position data is polled at regular intervals, so the map updates as new data arrives.

{% hint style="warning" %}
If you see "No vehicles found" on the tracking page, it means no vehicles in your organisation have connected telematics devices. Contact your administrator to set up a telematics integration.
{% endhint %}

## Trip history

In addition to live positions, FleetFusion records trip history for tracked vehicles. Trip records include start and end locations (reverse geocoded to readable addresses via Trimble Maps), distance travelled, duration, and idle time. You can view trip history from the **Trips** tab when a vehicle is selected, or from the **Telematics** tab on a vehicle's detail page.

{% hint style="info" %}
Tracking data also feeds into the Telematics reports available under **Reports**. See [Telematics Reports](/documentation/fleet-operations/reports/telematics-reports.md) for details.
{% endhint %}

## Sub-pages

In addition to the main map, the Tracking module includes four dedicated sub-pages. Reach them from the **Tracking** menu in the sidebar or directly via the URLs below.

| Page                                                                     | Path                     | What it is for                                                                                                                                                                                                           |
| ------------------------------------------------------------------------ | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Geofences](/documentation/fleet-operations/tracking/geofences.md)       | `/tracking/geofences`    | Create, edit, and manage geofence boundaries. Geofences drive entry and exit alerts and appear as overlays on the live map when the **Geofences** toggle is on.                                                          |
| [POIs](/documentation/fleet-operations/tracking/poi.md)                  | `/tracking/poi`          | Manage Points of Interest, named locations such as customer sites, depots, or fuel stations. POIs appear as light-blue markers on the map when the **POIs** toggle is on, and proximity is surfaced in the vehicle list. |
| [Media](/documentation/fleet-operations/tracking/media.md)               | `/tracking/media`        | Browse and review media (photos and short clips) captured by connected cameras across your fleet, filtered by vehicle, driver, and date.                                                                                 |
| [Video Events](/documentation/fleet-operations/tracking/video-events.md) | `/tracking/video-events` | Review video clips automatically generated by driving events such as harsh braking, collision warnings, and distraction triggers. Each entry links back to the trip and event for full context.                          |

## Related articles

* [Tracking Modes](/documentation/fleet-operations/tracking/tracking-modes.md)
* [Geofences](/documentation/fleet-operations/tracking/geofences.md)
* [POIs](/documentation/fleet-operations/tracking/poi.md)
* [Media](/documentation/fleet-operations/tracking/media.md)
* [Video Events](/documentation/fleet-operations/tracking/video-events.md)
* [Reports](/documentation/fleet-operations/reports.md)
* [Telematics Reports](/documentation/fleet-operations/reports/telematics-reports.md)
* [Integrations](/documentation/settings/integrations.md)
* [Device Hub](/documentation/settings/device-hub.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fleetfusion.ai/documentation/fleet-operations/tracking.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
