🎯 Smart Location

The most advanced, battery-efficient background location & telematics engine for Flutter.

smart_location is a highly modular, enterprise-grade mobility suite. Whether you just need simple background tracking or you want to build a full telematics & fleet management app, this package has you covered.

Why choose Smart Location?

• 🔋 Battery First: Automatically throttles GPS when the phone overheats or battery drops below 15%.
• 🛡 App Store Safe: Built-in Google Play Prominent Disclosure UI guarantees you won't get rejected.
• 🧠 AI Telematics: Detects harsh braking and sharp cornering natively using IMU sensors.
• ⚡ Real-Time: WebSockets and Delta-Encoding save 70% of network bandwidth.

🚀 Quick Start (In 2 Minutes) #

You don't need to be an expert to get started. Just want background location? Here you go:

1. Request Permissions safely #

Avoid App Store & Play Store rejections by using our built-in Prominent Disclosure:

import 'package:smart_location/smart_location.dart';

await smartPermission.requestBackgroundWithProminentDisclosure(
  context: context,
  appName: 'My App',
  justification: 'calculate route distance automatically',
);

2. Start Tracking (Even when killed!) #

await NativeEngine.startTracking(
  accuracy: LocationAccuracy.high,
  distanceFilter: 10, // meters
);

That's it! Your app is now tracking in the background natively.

🛠 Advanced Features (Modular & Opt-In) #

smart_location is completely modular. If you don't use these features, they won't run, keeping your app incredibly lightweight.

🎯 Velocity-Aware Geofencing #

Traditional geofences are static. Our geofences dynamically expand based on how fast the user is driving, ensuring your app wakes up before they blow past the destination!

await NativeGeofenceManager.addGeofence(
  id: 'warehouse_1',
  latitude: 37.7749,
  longitude: -122.4194,
  radiusInMeters: 200, // Base radius
);

🏎 ML-Powered Driving Telematics #

Detect harsh braking, rapid acceleration, and speeding natively using device IMU sensors (accelerometer & gyroscope). Perfect for insurance and ride-sharing apps.

final telematics = DrivingTelematicsEngine();
telematics.onDrivingEvent.listen((event) {
  print('Detected: ${event.type} (Severity: ${event.severity})');
});

📡 Real-Time WebSocket Telemetry #

Stop spamming REST APIs. Pipe your live locations directly to a WebSocket. We use Delta Encoding to only send the difference between coordinates, saving 70% of your data bills.

SyncEngine.enableLiveTelemetry('wss://your-fleet-server.com/socket');

📱 Running the Example App #

Our example app is a fully-fledged Sandbox featuring a G-Force meter, custom Map styling, and Background configurations!

cd example
flutter run

🛡 App Store & Play Store Compliance #

Background location is heavily scrutinized by Apple and Google. We wrote a dedicated guide to ensure your app gets approved on the first try. 👉 Read the Store Compliance Guide here