traceku_platform_interface 3.4.2

A common platform interface for the Traceku background geolocation plugin. Used by traceku_android and traceku_ios implementations.

traceku_platform_interface

📚 Official Documentation: traceku.carku.ir

A common platform interface for the Traceku background geolocation plugin.

This package provides the abstract classes and types that the platform-specific implementations (traceku_android, traceku_ios, traceku_web) implement.

It also contains shared Dart algorithms used by all platforms: LocationProcessor (distance/accuracy/speed/mock filtering), KalmanLocationFilter (GPS smoothing), AdaptiveSamplingEngine (activity/battery/speed-based distance filter), GeofenceEvaluator, TripManager, ScheduleParser, PersistDecider, and GeoUtils. See MockDetectionLevel enum and LocationProcessor mock detection for cross-platform spoof rejection.

New in 1.1.0

• BatteryBudgetEngine — feedback control loop that adjusts distanceFilter, desiredAccuracy, and periodic interval to maintain a configurable battery budget (%/hr). Emits BudgetAdjustmentEvent with current drain, target, and new parameters.
• CarbonEstimator — per-trip and cumulative CO₂ emission calculator using mode-specific factors (gCO₂/km). Returns TripCarbonSummary with emissions and distance by transport mode.
• DeltaEncoder — batch location compression codec achieving 60–80% payload reduction via delta encoding with configurable coordinate precision.
• RTree<T> — generic R-tree spatial index for O(log n) geofence proximity queries. Supports queryCircle() and queryBBox() with Haversine post-filtering.

The OEM Compatibility API (getSettingsHealth(), openOemSettings()) is defined here as abstract methods, with platform implementations providing manufacturer-specific behavior.

Usage

You should not depend on this package directly. Instead, depend on traceku which automatically includes the correct platform implementation.

This package is only relevant if you are writing a custom platform implementation for Traceku.

Related Packages

Package	Description
traceku	App-facing Dart API — the only package you depend on
traceku_android	Android implementation
traceku_ios	iOS implementation
traceku_web	Web implementation

More Information

• GitHub Repository
• Documentation
• Issue Tracker