Quick Start — Real-Time Telematics Integration

Prerequisites

Before integrating with the Real-Time Telematics Service, ensure you have:

1. Latest Damoov SDK Version — Refer to the changelog for updates:
   • iOS: https://docs.damoov.com/changelog/sdk-for-ios
   • Android: https://docs.damoov.com/changelog/sdk-for-android
2. Real-Time Data Enabled — Enable real-time data for your instance (User Group) via Datahub or contact our support team. Settings propagation takes up to 30 minutes.
3. Valid JWT Token — Obtain an admin JWT token for API access. See the Authentication Guide for details.
4. Instance ID — Your unique instance identifier, also known as a User Group.

Quick Integration Steps

Step 1: Verify Data Flow

Use the tracking page to confirm data is flowing from your mobile apps:

https://portal-apis.telematicssdk.com/tracker

Step 2: Test API Access

Verify your JWT token and instance access:

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  "https://portal-apis.telematicssdk.com/realtime/api/v1/devices/DEVICE_TOKEN/position"

Step 3: Choose Your Integration Method

Integration Examples

Embed a Live Tracker (Fastest)

Drop this into any web page to get a live tracking map:

<iframe
  src="https://portal-apis.telematicssdk.com/embedded-map?instanceId=YOUR_INSTANCE&jwt=YOUR_JWT"
  width="100%"
  height="600px"
  style="border: none; border-radius: 8px;"
  allow="clipboard-write">
</iframe>

See the Embedded SPA guide for all configuration options.

Track a Single Device via API

curl -H "Authorization: Bearer YOUR_JWT" \
  "https://portal-apis.telematicssdk.com/realtime/api/v1/devices/DEVICE_TOKEN/position"

Stream Live Updates via WebSocket

Connect to the WebSocket endpoint with your JWT and instance ID for sub-second position updates. See the API Reference for the full protocol.

Share a Driver's Location

Create a temporary link for a customer to track their delivery in real-time:

curl -X POST "https://portal-apis.telematicssdk.com/realtime/api/v1/sharing/sessions" \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "device_token": "DEVICE_UUID",
    "instance_id": "YOUR_INSTANCE",
    "expires_in_hours": 4,
    "recipient_name": "Jane Doe",
    "notes": "Your package is on the way!"
  }'

Send the returned share_url to your customer. See the Location Sharing guide for full details.

Set Up Driver Display Names

Replace raw device tokens with human-readable names on maps and share pages:

curl -X POST "https://portal-apis.telematicssdk.com/realtime/api/v1/devices/metadata/refresh?instance_id=YOUR_INSTANCE" \
  -H "Authorization: Bearer YOUR_JWT"

See the Driver Display Names guide for customization options.

Authentication

All endpoints require JWT authentication:

Authorization: Bearer YOUR_JWT_TOKEN

The JWT token must have access to the specified instance and device tokens.

Next Steps

1. Test Integration — Start with the embedded iFrame for immediate visualization
2. Configure Display Names — Refresh device metadata for human-readable names
3. Implement Backend — Add REST API calls to your backend systems
4. Add Real-Time — Integrate WebSocket streaming for live updates
5. Enable Sharing — Set up location sharing for customer-facing tracking
6. Customize — Use the Tracker Constructor to fine-tune the embedded experience

Need Help? Contact our integration team for technical support and custom implementation assistance.