Key Features

1. Tracked Assets — A generic grev.tracked.asset model that can stand on its own or be linked to a fleet vehicle and a product variant
2. Asset Types — Catalog of categories with per-type marker color and icon
3. GPS Data Ingestion — JSON-RPC webhook API with per-device API key auth
4. Map Dashboard — Full-screen Leaflet map with asset markers, type filters, geofence overlays, and live KPIs
5. Journey Detection — Automatic trip start/end detection from speed
6. Routed Playback — Trip routes snapped to real roads via leaflet-routing-machine
7. Geofencing — Polygon and circle zones with entry/exit alerts in chatter
8. Rental Integration — Link tracked assets to rentable product variants
9. Multi-company & Security — Three-tier role hierarchy with record rules

Installation

1. Install the module from the Odoo Apps menu
2. The module depends on base, mail, fleet, product, and the Grevlin Map View module (auto-installed)

Setting Up Asset Types

1. Navigate to :menuselection:`Asset Tracking --> Configuration --> Asset Types`
2. Click :guilabel:`New`
3. Enter a name (for example, Truck, Trailer, Field Technician)
4. Pick a marker color and icon — these will be used on the map dashboard

Creating a Tracked Asset

1. Navigate to :menuselection:`Asset Tracking --> Tracked Assets`
2. Click :guilabel:`New`
3. Enter the asset name and select an :guilabel:`Asset Type`
4. Optionally link the asset to a :guilabel:`Fleet Vehicle`
5. Optionally link the asset to a :guilabel:`Product Variant` (enables rental flows when the product is rentable)
6. Save the record

Setting Up GPS Devices

1. Navigate to :menuselection:`Asset Tracking --> Configuration --> GPS Devices`
2. Click :guilabel:`New`
3. Enter the device serial number and select the device type
4. Assign the device to a tracked asset
5. Copy the auto-generated :guilabel:`API Key` — this is used for webhook authentication

Setting Up Geofences

1. Navigate to :menuselection:`Asset Tracking --> Geofencing --> Geofences`
2. Click :guilabel:`New`
3. Enter a name and select the fence type (Polygon or Circle)
4. Use the interactive map editor to draw the geofence zone
5. Configure entry/exit alert preferences and select users to notify

GPS Data Ingestion API

Send GPS data to the webhook endpoint:

curl -X POST https://your-odoo.com/api/v1/gps/ingest \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "params": {
      "api_key": "YOUR_DEVICE_API_KEY",
      "events": [
        {
          "timestamp": "2025-01-01T10:15:00Z",
          "latitude": 40.7128,
          "longitude": -74.0060,
          "speed": 42,
          "heading": 180,
          "accuracy": 5,
          "battery_level": 85
        }
      ]
    }
  }'

Map Dashboard

Access the map dashboard from :menuselection:`Asset Tracking --> Dashboard`.

The dashboard displays:

• Tracked asset markers colored and iconified by asset type
• Geofence polygon and circle overlays
• Sidebar with asset list, search, type filters, and live KPIs
• Auto-refresh of asset positions

Journey Tracking and Routed Playback

Journeys are detected automatically by a cron job:

• A journey starts when asset speed exceeds 5 km/h
• A journey ends when speed stays below 2 km/h for more than 5 minutes

View journeys at :menuselection:`Asset Tracking --> Tracking --> Journeys`. Open any journey to replay the route as a road-snapped path rendered by leaflet-routing-machine, alongside distance, duration, max speed, and idle time metrics.

Rental Integration

When a tracked asset is linked to a rentable product.product variant, the asset becomes visible from the product form and can be associated with rental orders. The included demo data ships with several tracked assets connected to rentable products to showcase the flow end-to-end.

Models

• grev.tracked.asset — Generic tracked asset, optionally linked to a fleet vehicle and a product variant
• grev.tracked.asset.type — Asset type catalog with marker color/icon
• fleet.vehicle — Extended with a back-reference to its tracked asset
• product.product — Extended with a back-reference to its tracked asset
• grev.device — GPS tracking device with API key authentication
• grev.location.event — Raw GPS telemetry data (high-volume)
• grev.journey — Detected trips with distance, duration, and routed path
• grev.geofence — Operational zones (polygon or circle)
• grev.geofence.event — Geofence entry/exit event log

API Endpoints

• POST /api/v1/gps/ingest — GPS data ingestion (JSON-RPC, public auth)

Supported GPS Vendors

The webhook API accepts standard GPS data and is compatible with:

• Teltonika
• Queclink
• CalAmp
• Digital Matter
• Any device capable of HTTP POST with JSON payload