Welcome to the Damoov Mobile Telematics Integration Guide! Whether you're venturing into the telematics universe for the first time or aiming to upgrade an existing application, Damoov offers a comprehensive suite to meet your needs. Here, we outline two primary paths to bring the power of our telematics into your digital solutions:

Option 1: Integrate Telematics Into your Existing App 🔄: For those who've already built a mobile application and wish to harness the capabilities of Damoov's telematics suite, this option seamlessly bridges our advanced features with your current app.

Option 2: Using Damoov's Open Source App (Zenroad) 📱: Ideal for those seeking a ready-made platform to get started swiftly, Zenroad provides a fully-fledged telematics application. Customize it to your liking and hit the road running!

Choose your path and let's dive deep into the integration process!

🎯 Getting Started

🛠 Integrate Telematics Into Existing App

If you've already invested time in creating a mobile application and want to enhance its capabilities with Damoov's telematics suite, this option is ideal. By integrating our telematics SDK and telematics APIs into your current app, you can maintain your existing user interface and features while adding the power of advanced telematics to your toolset.

1. Initial Setup 🏁

• Register on Damoov Datahub for app credentials.

2. User Registration & API Integration 🔑

📘

Note: Each app user needs a unique Telematics User ID for identification.

• Register a telematics user either from the mobile application side using our iOS and Android frameworks, or directly with our API.
• For backend registration, use our API or 🐍Python SDK
• Implement user authorization or admin authorization and integrate our API services for further functionality.

3. SDK Integration to your mobile app 📱

• Choose your platform:
  • Native: iOS | Android
  • Cross-Platform: React Native | Flutter | Xamarin

📱 Using Damoov's Open Source App (Zenroad)

For developers looking to quickly set up and test Damoov's telematics features without starting from scratch, the Zenroad open-source application offers an immediate solution. By using this pre-built platform, you can expedite the integration process, easily access advanced telematics features, and customize according to your needs.

1. Set Up 🛠

• Create a company account on Damoov Datahub to register your application and obtain necessary credentials.
• Fetch the open-source application source code from our GitHub repository.

2. Configuration ⚙️

• Set up a Firebase account, enabling Firebase Authentication and the Realtime Database.
• Follow our GitHub documentation and the video guide for complete app configuration.

3. Testing 🧪

• Use our tools for testing and troubleshooting guide for a seamless test process.

📚 Essential Resources & Best Practices

• UI/UX Integration: 🎨 An integral part of the SDK is the permission wizard and push notifications. Learn about customizing these assets in our assets and customization guide.
• Webhooks/Callbacks: 🕸 For information about setting up webhooks or backend callbacks, visit callback configuration guide.
• SDK Initialization & Error Handling: ⚠️ Ensure you follow the steps correctly. If there's an error in integration, follow the SDK troubleshooting guide.
• Testing & Debugging: 🔍 Once integrated, register a Telematics User ID. Fake trips can be generated for testing via your Datahub account. More on Trips and Statistics API and Testing guide.
• Community & Support: 💬 Reach out for queries through the Intercom bubble present on all our platforms. Join discussions on our forum or our GitHub community.
• Latency & Data Streams: 🌊 Understand the expected latency in data processing and the types of data streams supported. More details here.