---
agentTools:
  projectIndex: https://docs.damoov.com/llms.txt
---

# SPA Live Tracking

## Version 0.9.0 Release date 15.04.2026

All notable changes to the Real-Time Tracking service. This log covers new features, improvements, and fixes relevant to integrators and end users.

Service documentation: <https://docs.damoov.com/docs/live-gps-tracking>

***

## \[0.9.0] — 2026-04-15

### Added

* **"Center on driver" button on share pages** — viewers can tap a crosshair icon to recenter the map on the driver's current position.
* **"Fit all drivers" button on embedded tracker** — a single tap zooms the map to frame all visible device markers. Centers on a single device or fits bounds around multiple devices.
* **`hideUI`URL parameter** — append `&hideUI=true` to the embedded tracker URL to hide all floating overlay buttons (status button, fit-all button). Ideal for clean, customer-facing iframe embeds.
* **"Hide overlay UI" toggle in Tracker Constructor** — the constructor now includes a toggle to generate URLs with `hideUI=true` pre-configured.
* **Share page driver details card** — the share page now displays speed, heading, and last-updated time in a dedicated card below the map.
* **Driver display names** — devices now show human-readable names (e.g. "John Smith") instead of raw device tokens. Names are resolved from user profiles and appear on map markers, share pages, and API responses.
* **Display field selection** — choose which profile field to show (`full_name`, `nickname`, `email`, `phone`, `client_id`, etc.) per device or in bulk. Automatic fallback through alternatives if the chosen field is empty.
* **Location sharing** — generate secure, time-limited links that let third parties view a driver's live position on a map. No login required for viewers. Configurable options for speed, heading, ETA, and destination display.
* **Share page** — a dedicated, mobile-friendly page for share link recipients with live map, driver marker, ETA countdown, and connection status indicator.
* **Share modal in embedded tracker** — create and manage share sessions directly from the embedded map. Click a device marker, configure the share options, and generate a link.
* **Tracker Constructor** — a visual configuration tool for developers. Configure the embedded tracker through a form, preview it live, and generate a ready-to-use embed URL.
* **Device metadata API** — REST endpoints for managing device metadata, including display names, profile data, and display field preferences.
* **User profile integration** — device profiles are fetched from the Telematics User Service for display name resolution.

### Fixed

* **Share page speed display** — the "Show speed" option now defaults to enabled when creating new share sessions, ensuring speed data appears on share pages by default.
* **Configuration resilience** — the backend no longer crashes when new environment variables are introduced during upgrades.
* **Frontend configuration** — resolved an issue where the frontend could connect to the wrong API endpoint under certain URL paths.

<br />

***

## \[0.4.0] — 2025-10-06

### Added

* **UUID case normalization** — device tokens and instance IDs are now consistently normalized, preventing duplicate entries and lookup mismatches.

### Improved

* **Logging** — cleaned up verbose console output for a better debugging experience.

***

## \[0.3.0] — 2025-09-05

### Added

* **3-tier device status system** — devices are categorized as Active (< 1 min), Inactive (1–6 min), or Offline (> 6 min) based on last seen time.
* **Speed monitoring** — set speed limits via URL parameter (`maxspeed`). Devices exceeding the limit are visually highlighted on the map.
* **Unit conversion** — support for metric (km/h, meters) and imperial (mph, feet) units, configurable via the `units` URL parameter.
* **Multi-device and single-device modes** — the embedded tracker supports both fleet-wide views and focused single-device tracking with trip history.

### Improved

* **Performance** — optimized data processing for high-volume real-time updates.
* **Service monitoring** — added health check endpoints and request logging.

***

## \[0.2.0] — 2025-09-01

### Added

* **Scalable architecture** — separated data ingestion and API serving into independent services for better scalability and reliability.
* **REST API** — device position endpoints, health checks, and WebSocket connections for real-time data streaming.
* **Embedded tracker** — full-featured embeddable map widget with device markers, status indicators, popups, and configurable URL parameters.