Guides
SIGN INSIGN UP

Quick Start - Real-Time Telematics Integration

Suggest Edits

Prerequisites

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

  1. Latest Damoov SDK Version - Refer to the changelog for updates:

  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 Authentication Guide for details.

  4. Instance ID - unique instance identifier, also known as a User Group

Integration Options

Choose your preferred integration method:

Option 1: Embedded SPA via iFrame

Best for: Quick web portal integration with minimal development

<iframe 
  src="https://portal-apis.telematicssdk.com/embedded-map?instanceId=YOUR_INSTANCE&jwt=YOUR_JWT_TOKEN"
  width="100%" 
  height="600px" 
  frameborder="0">
</iframe>

Features: Interactive map, device tracking, trip visualization, speed monitoring

Option 2: REST API Integration

Best for: Backend systems, mobile apps, custom dashboards

Base URL: https://portal-apis.telematicssdk.com/realtime/api/v1

Key Endpoints:

  • GET /devices/{device_token}/position - Latest device position
  • GET /devices/{device_token}/tracks - Current trip data
  • GET /devices/{device_token}/stats - Device statistics

Option 3: WebSocket Real-Time Streaming

Best for: Live dashboards, real-time monitoring applications

WebSocket URL: wss://portal-apis.telematicssdk.com/realtime/api/v1/ws/realtime

Features: Sub-second latency, automatic reconnection, heartbeat monitoring

Quick Integration Steps

Step 1: Verify Data Flow

Use our 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 Integration Method

  • Quick Start: Use embedded iFrame for immediate results
  • Custom Development: Implement REST API or WebSocket integration
  • Hybrid Approach: Combine multiple methods as needed

Authentication

All endpoints require JWT authentication:

Authorization: Bearer YOUR_JWT_TOKEN

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

Support Resources

Next Steps

  1. Test Integration: Start with the embedded iFrame for immediate visualization
  2. Implement Backend: Add REST API calls to your backend systems
  3. Add Real-Time: Integrate WebSocket streaming for live updates
  4. Customize: Tailor the integration to your specific requirements

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

Updated about 2 hours ago