Android SDK

Android SDK

Native Android SDK for Kotlin and Java applications.

Installation

Add to your build.gradle:

dependencies {
    implementation("com.localsdk:sdk:2.0.0")
}

Quick Start

import com.localsdk.LocalSDK
import com.localsdk.TrackingMode

val sdk = LocalSDK.init(context, "your_api_key")

sdk.startTracking(TrackingMode.ADAPTIVE)

sdk.onLocation { update ->
    Log.d("Location", "${update.latitude}, ${update.longitude}")
}

Requirements

Android API 26+ (Android 8.0)
Google Play Services Location 21.0+
Kotlin 1.9+ (Java 11+ for Java projects)

Permissions

Add to your AndroidManifest.xml:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

Background Tracking

LocalSDK uses a foreground service for reliable background tracking:

sdk.startTracking(
    mode = TrackingMode.ADAPTIVE,
    foregroundService = true,
    notificationConfig = NotificationConfig(
        title = "Tracking active",
        icon = R.drawable.ic_location
    )
)

Installation

Install LocalSDK for your platform — JavaScript, iOS, Android, Flutter, or React Native.

iOS SDK

Native iOS SDK for Swift and Objective-C applications.