smart_location 3.4.0

Smart Location is a powerful, battery-conscious Flutter plugin for continuous background geolocation tracking, advanced geofencing, and motion-aware updates.

Smart Location 🌍

The absolute most scalable, resilient location tracking package for Flutter. Whether you are building a simple weather app or a military-grade delivery logistics platform, smart_location scales perfectly with your needs.

---

🚀 Two Tiers of Power

To keep things simple, smart_location is designed with two tiers. Use Tier 1 if you are a beginner or just need simple tracking. Use Tier 2 if you are building an enterprise application.

🟢 Tier 1: SmartLocationLite (Beginners & Simple Apps)

If you are building a weather app, dating app, or simple run tracker, use SmartLocationLite. It is incredibly lightweight, battery-friendly, and simple to use.

import 'package:smart_location/smart_location.dart';

// Get a single location
final myLocation = await SmartLocationLite.getCurrentLocation();
print("I am at: ${myLocation.latitude}, ${myLocation.longitude}");

// Track movement in the foreground
final sub = SmartLocationLite.trackMovement().listen((location) {
  print("I am moving: ${location.latitude}");
});

That's it! No complex managers, no battery drain.

---

🔴 Tier 2: Enterprise Logistics (Delivery, Ride-Sharing)

If you are building Uber, Doordash, or a fleet tracking system, you need the heavy artillery. The SmartLocation enterprise managers provide Anti-Spoofing, Dead Reckoning, Headless Background Sync, and more.

1. Unkillable Background Tracking

No more disappearing drivers. Our engine automatically resists aggressive battery savers (like Xiaomi/Samsung) and instantly resurrects your tracking service if the OS ever tries to force-kill it.

2. True Zero-Overhead Battery Saver

Track for days without draining the user's battery. We smooth out noisy GPS data natively before it ever wakes up your app, saving massive amounts of power on long drives.

3. Massive Geofencing (10,000+ Zones)

Instantly track a user against tens of thousands of geofences without any lag or battery drain. Supports Time-Gated Geofences (active only during certain hours) and Predictive Geofencing (spawning zones based on where the user is going).

4. Military-Grade Location Security

Ensure your location data is 100% tamper-proof. Secure sensitive tracking data so it can only be decrypted when the driver physically reaches the authorized destination. Automatically generate GDPR/CCPA compliance reports.

5. Driver Safety & Telematics

Automatically detect severe vehicle impacts without false positives. Monitor speeding, distracted driving, and accurately classify whether the user is driving or just riding as a passenger.

6. Smart Sync & Offline Mode

If a driver enters a dead zone, data is encrypted and saved offline. When the network returns, it uses ultra-compressed data transfers and smart retries to sync everything back to your server while saving up to 80% of their cellular data plan.

7. Dead Reckoning (Tunnel Tracking)

When a driver enters a tunnel and loses GPS, the engine seamlessly maintains their tracking position.

8. Anti-Spoofing Engine

Automatically detect and block fraudulent or mocked location data.

9. Indoor Positioning

Maintain highly accurate tracking even when deep inside warehouses, parking garages, or multi-story malls.

10. Live Diagnostic Developer Tools

Use our Smart Location Doctor UI overlay to instantly view GPS health, active geofences, sync queues, and battery drain in real-time right on the device while testing.

---

🛠 Troubleshooting & Friction

Are you facing Android Battery Killers, Gradle conflicts, or iOS Podfile issues? We have solved them all!

👉 Read the TROUBLESHOOTING.md Guide

---

License

MIT License