Changelog
SIGN INSIGN UP
Back to All

SPA Live Tracking

26 days ago by Matthew Davis

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.

[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.