Skip to main content

IOS SDK

📄 Integration Guide (SPM)

How to add the SDK and configure the project.

📄 Integration Guide (CocoaPods)

How to add the SDK and configure the project.

📄 Permissions Setup

Mandatory permissions and how to declare them.

📄 Permissions Runtime Behavior

How permissions behave at runtime and how to handle them.

📄 Usage Examples

Code examples for common flows.

Overview​

The TelematicsSDK for iOS is a native SDK that provides telematics capabilities for iOS applications, including continuous location tracking, motion analysis, and trip data collection.

It exposes a set of APIs to manage users and vehicles, control the telemetry lifecycle, handle permissions, and retrieve trips and metrics in a reliable and predictable way.

The SDK is designed to operate under modern iOS background execution constraints and follows a strict permission model to ensure data integrity and system compliance.

This section provides an overview of the iOS SDK and points you to the relevant guides for integration, permissions setup, and common usage patterns.

How to use this documentation​

Use the sections below to navigate the iOS SDK documentation:

  • Integration Guide (SPM): Learn how to add the SDK to your project using Swift Package Manager and configure authentication.
  • Integration Guide (CocoaPods): Learn how to integrate the SDK using CocoaPods and configure the project correctly.
  • Permissions Setup: Understand which permissions and capabilities are mandatory, why they are required, and how to declare them.
  • Permissions Runtime Behavior: Learn how the SDK evaluates permissions at runtime and how it reacts to permission changes, interruptions, and telemetry gaps while the app is running.
  • Usage Examples: Explore common flows such as SDK initialization, session handling, vehicle setup, telemetry control, attention detection, and data retrieval.

Each section focuses on a specific aspect of the SDK and can be read independently.