start

actual fun start(geofences: List<AFGeofence>): AFGeofencingResult

Starts the geofencing service with the given list of geofences. Geofences are validated, persisted to disk, and registered with Google Play Services. A foreground service is started to ensure reliable background operation.

Parameters

geofences

The list of AFGeofence objects to monitor.

expect fun start(geofences: List<AFGeofence>): AFGeofencingResult

Starts monitoring a list of geofences.

Per-platform region limits (enforced by the OS, not the SDK):

  • iOS: maximum 20 monitored regions per app. If more are passed, the SDK truncates the list and logs a warning; the extras are dropped.

  • Android: maximum 100 geofences per app via Google Play Services. The SDK registers them in batches of 100; passing more will fail the excess batch with TOO_MANY_GEOFENCES.

Each AFGeofence is run through clampAndValidate before registration — radius is clamped to 50m, 5000m (Apple and Google recommend ≥100m for reliable triggering) and dwell time is clamped to 60s, 1h.

Return

AFGeofencingResult representing success or failure.

Parameters

geofences

A list of AFGeofence objects defining the regions to monitor.

actual fun start(geofences: List<AFGeofence>): AFGeofencingResult

Starts monitoring a list of geofences.

Per-platform region limits (enforced by the OS, not the SDK):

  • iOS: maximum 20 monitored regions per app. If more are passed, the SDK truncates the list and logs a warning; the extras are dropped.

  • Android: maximum 100 geofences per app via Google Play Services. The SDK registers them in batches of 100; passing more will fail the excess batch with TOO_MANY_GEOFENCES.

Each AFGeofence is run through clampAndValidate before registration — radius is clamped to 50m, 5000m (Apple and Google recommend ≥100m for reliable triggering) and dwell time is clamped to 60s, 1h.

Return

AFGeofencingResult representing success or failure.

Parameters

geofences

A list of AFGeofence objects defining the regions to monitor.

actual fun start(geofences: List<AFGeofence>): AFGeofencingResult

Starts monitoring a list of geofences.

Per-platform region limits (enforced by the OS, not the SDK):

  • iOS: maximum 20 monitored regions per app. If more are passed, the SDK truncates the list and logs a warning; the extras are dropped.

  • Android: maximum 100 geofences per app via Google Play Services. The SDK registers them in batches of 100; passing more will fail the excess batch with TOO_MANY_GEOFENCES.

Each AFGeofence is run through clampAndValidate before registration — radius is clamped to 50m, 5000m (Apple and Google recommend ≥100m for reliable triggering) and dwell time is clamped to 60s, 1h.

Return

AFGeofencingResult representing success or failure.

Parameters

geofences

A list of AFGeofence objects defining the regions to monitor.