Documentation

Positions Report

The Positions Report shows every GPS fix recorded for a selected vehicle during the chosen time period. Unlike Trips or Stops, which summarize movement, Positions gives you the raw data — every latitude/longitude point, speed reading, altitude, course, and any sensor values the device transmitted (odometer, fuel level, RPM, ignition state, etc.).

Use this report for detailed auditing, device diagnostics, or to understand exactly where a vehicle was at any given second.

Generating a Report

1. Select a Vehicle: Choose a single vehicle from the dropdown
2. Set Date Range: Select a predefined option (Today, Yesterday, Last 7 Days) or custom dates
3. Click Show to generate the report

Positions only supports one vehicle at a time since it returns high-volume raw data.

Position Details

Each row represents one GPS fix. The standard columns are:

• Fix Time: The timestamp when the GPS position was recorded
• Latitude / Longitude: GPS coordinates (6 decimal places)
• Altitude: Elevation above sea level (m)
• Speed: Vehicle speed at the time of the fix (km/h)
• Course: Direction of travel in degrees (0–360°)
• Accuracy: GPS accuracy estimate (m)
• Address: The physical address at the recorded coordinates — click Show address to fetch it on demand

Device Sensor Columns

After a report loads, additional columns may appear in the column selector depending on what your device transmits. Common examples:

These columns are hidden by default when first discovered. Enable them from the column selector (columns icon) after generating the report.

Viewing Positions on the Map

Click the map pin icon on any row to highlight that position on the route map:

• The full route is always displayed — the map never zooms in to just the selected point
• The selected point is highlighted on the route
• The corresponding table row is highlighted and scrolled into view
• Click any point directly on the map to highlight the matching row in the table

The map shows the complete route for the period, making it easy to follow the vehicle's path while inspecting individual position details in the table.

Showing Addresses

The Address column does not show a value by default. Click Show address on any row to fetch the street address for that position. Addresses are retrieved from Nominatim (OpenStreetMap) and appear in your current display language.

Column Visibility

Use the columns icon button to show or hide columns. Useful for:

• Hiding columns not relevant to your device (e.g. hiding Fuel if the device does not report it)
• Showing hidden columns like Altitude, Course, or Accuracy
• Enabling newly discovered device sensor columns

Column preferences are saved per device.

Exporting Reports

Use the dropdown menu next to the Show button:

• Export: Download the full report as an Excel spreadsheet
• Print: Open a print-friendly version

Exported data includes all visible columns with formatted values (speeds in km/h, distances in km, times in your locale).

Scheduling Reports

Click the calendar icon to schedule this report to run automatically and be emailed as a CSV. This button is only available to users with the Schedule Reports permission.

Use Cases

• Detailed Route Audit: Review every recorded point for a specific journey
• Device Diagnostics: Check whether a device is recording positions at the expected interval
• Sensor Monitoring: Track fuel consumption, RPM, or ignition events over time
• Compliance: Verify a vehicle was where it was supposed to be at a specific time

No Data Found

If the report shows no data:

• Check that the vehicle was active and the GPS device was online during the selected dates
• Try a shorter date range — very long ranges may return no data if the device was offline
• Verify the GPS device is properly configured and syncing with the server