kiosk-ops-sdk/com.sarastarquant.kioskops.sdk.geofence/GeofenceManager

GeofenceManager

open class GeofenceManager(context: Context, policyProvider: () -> GeofencePolicy, profileProvider: (String) -> PolicyProfile?, auditTrail: AuditTrail?, clock: Clock = Clock.systemUTC())

Manages geofence monitoring and policy profile switching.

Security (BSI SYS.3.2.2.A8): Uses Android Geofencing API with configurable responsiveness to balance accuracy and battery life.

Privacy (GDPR Art. 5): No location data is persisted or transmitted. Only region membership state is tracked for policy switching.

Since

0.4.0

Constructors

GeofenceManager

constructor(context: Context, policyProvider: () -> GeofencePolicy, profileProvider: (String) -> PolicyProfile?, auditTrail: AuditTrail?, clock: Clock = Clock.systemUTC())

Functions

addTransitionListener

fun addTransitionListener(listener: GeofenceTransitionListener)

Add a geofence transition listener.

getActiveRegionIds

fun getActiveRegionIds(): List<String>

Get all currently active region IDs.

getCurrentProfile

fun getCurrentProfile(): PolicyProfile?

Get current policy profile.

getCurrentProfileName

fun getCurrentProfileName(): String

Get current policy profile name.

getCurrentRegion

fun getCurrentRegion(): GeofenceRegion?

Get current active region (highest priority if multiple).

fun isInRegion(regionId: String): Boolean

Check if currently inside a specific region.

fun isMonitoring(): Boolean

Check if monitoring is active.

removeTransitionListener

fun removeTransitionListener(listener: GeofenceTransitionListener)

Remove a geofence transition listener.

startMonitoring

@RequiresPermission(value = "android.permission.ACCESS_FINE_LOCATION")

suspend fun startMonitoring(): GeofenceStartResult

Start geofence monitoring.

suspend fun stopMonitoring()

Stop geofence monitoring.