Geofence API

{
  "user_id": USER_ID,
  "device_ip": DEVICE_IP,
  "geofence_id": "BR",
  "bet_id": CUSTOM_BET_ID,
  "session": SDK_SESSION
}

// User ID: Associate the current user with a UNIQUE ID. Max length is 64 characters
// Device IP: Get the user's device IP address and pass it on
// Geofence ID: For specific geofencing rules, currently Brazil
// Bet ID: The ID of the current (gaming) session, not required. Max length is 64 characters
// Session: Device Intelligence session, collected with `seon.getSession()

seon.getSession({
 // existing configurations
 geolocation: {
   enabled: true,
   highAccuracy: true,
   canPrompt: true,
   // set this to below the industry requirements to allow for some leverage (eg. Brazil should check every ~30mins, so we do 25 here)
   maxAgeSeconds: 25*60,
   timeoutMs: Infinity
 },
 // can do fix timeout here (eg. 10_000) if the application requires it, or if there's a problem with Infinity
 networkTimeoutMs: Infinity,
 fieldTimeoutMs: Infinity
})

// Prompt the user for appropriate location permission(s)
// ...

// Customize how geolocation is collected by modifying the default values of `SEONGeolocationConfig`
let config = SEONGeolocationConfig() // creates a config object with the default values
config.geolocationEnabled = true      // Enable the Geolocation feature
config.prefetchEnabled = false        // Disable pre-fetching a valid location
config.geolocationServiceTimeoutMs = 3000 // Timeout for the location service in milliseconds
config.maxGeoLocationCacheAgeSec = 60    // Maximum allowed age of a location object in seconds

// Set the geolocation config for the SEONFingerprint object
SEONFingerprint.sharedManager().setGeolocationConfig(config)

// It's highly advised but optional to use our extended fingerprinting capabilities via behaviour monitoring.
// Start behaviour monitoring where appropriate eg. when the user opens the app
SEONFingerprint.sharedManager().startBehaviourMonitoring()
do {    
    // Get the fingerprint or stop behaviour monitoring 
    let fingerprintResult = try await seonfp.getFingerprintBase64()
    // or
    let fingerprintResult = try await seonfp.stopBehaviourMonitoring()
    // Use the received value in your session property for your Geofence API or Fraud API request.
} catch {
     // Handle any errors
    print("Error fetching fingerprint: \(error.localizedDescription)")    
}

kotlin
// You should initialize the Seon SDK, enable geolocation collection, 
// and prompt the user for appropriate location permission(s) before 
// trying to retrieve a fingerprint with valid location data.
// Create an optional custom Geolocation Config object
val seonGeolocationConfig = SeonGeolocationConfigBuilder()
   .withPrefetchEnabled(true) // When enabled, prefetch location from the API on init for better performance
   .withGeolocationServiceTimeoutMs(3000) // The timeout in milliseconds for the location service
   .withMaxGeoLocationCacheAgeSec(600) // Maximum Location data age permitted in seconds
   .build()
// Pass the custom geolocation config object to SeonBuilder or use the default config values by omitting it.
val seon = SeonBuilder()
   .withContext(applicationContext)
   .withSessionId(UUID.randomUUID().toString())
   .withGeolocationEnabled() // must be explicitly enabled to turn on the Geolocation feature
   .withGeoLocationConfig(seonGeolocationConfig) // optional config
   .build()
// Geolocation and SeonGeolocationConfig can also be set later on the Seon object
seon.setGeolocationEnabled(true)
seon.setGeoLocationConfig(seonGeolocationConfig)
// It's highly advised but optional to use our extended fingerprinting capabilities via behaviour monitoring.
// Start behaviour monitoring where appropriate eg. when the user opens the app
seon.startBehaviourMonitoring()
/* ---- Relevant user journey happens here ----
* Note: The behaviour analysis needs time to collect signals on user behaviour,
* so it's advisable to run it at least for a few seconds.
*/

try {
   // When you want to collect the results, call stopBehaviourMonitoring() as you would getFingerprintBase64()
    val seonCallback = object : SeonCallbackWithGeo {
           override fun onComplete(response: String) {
               // Successfully received fingerprint response with device location data.
           }
           override fun onCompleteWithGeoFailure(response: String, geoStatusCode: Int) {
               // Successfully received fingerprint response, without valid location data and geolocation service status code.
           }
   }
   seon.stopBehaviourMonitoring(seonCallback)
   // OR
   seon.getFingerprintBase64(seonCallback)
} catch (e: BehaviouralMonitoringException) {
   // Handle behavioural monitoring failure
   e.printStackTrace()
} catch (e: SeonException) {
   e.printStackTrace()
}