#Android

Install the SDK to your project via Gradle in Android Studio and add the dependencies below in your app build.gradle file.

android { 
  ..... 
  compileOptions { 
        sourceCompatibility JavaVersion.VERSION_1_8 
        targetCompatibility JavaVersion.VERSION_1_8 
  } 
  ...... 
} 
dependencies { 
        implementation 'com.geospark.android:geospark:2.1.1' 
}

Initialize the SDK in your PublishKey.

//In onCreate method of your Application class 
//include the code below.

public void onCreate() {
    super.onCreate();
    GeoSpark.initialize(this, "PUBLISH_KEY");
    ...
}    

GeoSpark SDK needs a User ID object to identify the device.

GeoSpark.createUser(this,"User Description", new GeoSparkCallBack() {
    @Override
    public void onSuccess(GeoSparkUser geoSparkUser) {
                geoSparkUser.getUserId();
    }
    @Override
    public void onFailure(GeoSparkError geoSparkError) {
                geoSparkError.getErrorCode();
                geoSparkError.getErrorMessage();
    }
});

To start tracking the location.

//To enable location, call the requestLocationPermissions  
//and requestLocationServices method.

if(!GeoSpark.checkLocationPermission(this)) {
    GeoSpark.requestLocationPermission(this);
} else if (!GeoSpark.checkLocationServices(this)) {
    GeoSpark.requestLocationServices(this);
} else{
    //Call this method to start tracking the location.  
    GeoSpark.startTracking(this);
}      

Initialize the SDK in your PublishKey

GeoSpark.initialize(this, "PUBLISH_KEY");

GeoSpark SDK is capable of sending push notifications to your users. Add Firebase to your Android project to get device token.

GeoSpark.setDeviceToken(this, "FCM DeviceToken");

To get FCM DeviceToken from SDK.

GeoSpark.getDeviceToken(this);

GeoSpark SDK needs an User ID object to identify the device. The SDK has a convenience method createUser() to create a user which returns User ID.

GeoSpark.createUser(this,"User Description", new GeoSparkCallBack() {
  @Override
  public void onSuccess(GeoSparkUser geoSparkUser) {
              geoSparkUser.getUserId();
  }
  @Override
  public void onFailure(GeoSparkError geoSparkError) {
              geoSparkError.getErrorCode();
              geoSparkError.getErrorMessage();
  }
});

If you already have an User ID, then SDK has a convenience method getUser() to start the session for the existing user.

GeoSpark.getUser(this, "userId", new GeoSparkCallBack() {
  @Override
  public void onSuccess(GeoSparkUser geoSparkUser) {
              geoSparkUser.getUserId();
  }
  @Override
  public void onFailure(GeoSparkError geoSparkError) {
              geoSparkError.getErrorCode();
              geoSparkError.getErrorMessage();
  }
});    

Adding description for the user makes it easier for you to identify your users, while tracking them in SDK. GeoSpark SDKs provide you with the option to modify the description any time for a user. This can also help you in easily identifying users on dashboard simply via the description.

GeoSpark.setDescription(this, "User Description", new GeoSparkCallBack() {
  @Override
  public void onSuccess(GeoSparkUser geoSparkUser) {
        geoSparkUser.getUserId();
  }
  @Override
  public void onFailure(GeoSparkError geoSparkError) {
      geoSparkError.getErrorCode();
      geoSparkError.getErrorMessage();
  }
});    

Use this method after user creation to enable user events for geofence, activity and trips. By default, all user events will be disabled post user creation.

GeoSpark.toggleEvents(this, geofence, trip, activity, new
GeoSparkEventsCallback() {
      @Override
      public void onSuccess(GeoSparkEvents geoSparkEvents) {
            geoSparkEvents.isActivityEventsActive();
            geoSparkEvents.isGeofenceEventsActive();
            geoSparkEvents.isTripEventsActive();
      }
      @Override
      public void onFailure(GeoSparkError geoSparkError) {
            geoSparkError.getErrorCode();
            geoSparkError.getErrorMessage();
      }
});

Use this method after user creation to get the current status of user events for geofence, activity and trips

GeoSpark.getEventsStatus(this, new GeoSparkEventsCallback() {
  @Override
  public void onSuccess(GeoSparkEvents geoSparkEvents) {
      geoSparkEvents.isActivityEventsActive();
      geoSparkEvents.isGeofenceEventsActive();
      geoSparkEvents.isTripEventsActive();
  }
  @Override
  public void onFailure(GeoSparkError geoSparkError) {
      geoSparkError.getErrorCode();
      geoSparkError.getErrorMessage();
  }
});

Check whether your App has location permission. Returns a boolean, which is true if the location permission has been granted, and false otherwise.

GeoSpark.checkLocationPermission(this);

Check whether the device has location services enabled. Returns a boolean, which is true if the location location services is ON, and false otherwise.

GeoSpark.checkLocationServices(this);

Call this method to request user to enable location permissions.

GeoSpark.requestLocationPermission(this);

//Callback from request location permission method.

@Override
public void onRequestPermissionsResult(int requestCode, String permissions[], int[] grantResults) {
   switch (requestCode) {
      case GeoSpark.REQUEST_CODE_LOCATION_PERMISSION:
        if (grantResults.length > 0
          && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
          if (ContextCompat.checkSelfPermission(this,
            android.Manifest.permission.ACCESS_FINE_LOCATION)
            == PackageManager.PERMISSION_GRANTED) {
            }
        }
      break;
   }
}

Call this method to enable location services.

GeoSpark.requestLocationServices(this);

//Callback from request location services method.

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
   super.onActivityResult(requestCode, resultCode, data);
   if (requestCode == GeoSpark.REQUEST_CODE_LOCATION_ENABLED) {
   }
}

To start tracking the user location.

GeoSpark.startTracking(this);

Check whether location tracking is started or not. This method returns boolean value.

GeoSpark.isLocationTracking(this);

You can stop tracking the user location.

GeoSpark.stopTracking(this);

To listen for location in the background, create a class that implements GeoSparkReceiver. Then, register the receiver by adding a receiver element to the application element in your manifest.

public class MyGeoSparkReceiver extends GeoSparkReceiver {
  @Override
  public void onLocationUpdated(Context context, Location location,
              GeoSparkUser geoSparkUser, String activity){
        // do something with context, location, userId, activity
  }
  @Override
  public void onError(Context context, GeoSparkError geoSparkError) { 
          geoSparkError.getErrorCode();
          geoSparkError.getErrorMessage();
  }
}

<application>
    ...
 <receiver android:name=".MyGeoSparkReceiver"
                android:enabled="true"
                android:exported="false">
     <intent-filter>
     <action android:name="com.geospark.android.RECEIVED"/>
     </intent-filter>
 </receiver>
     ...
</application>

Get current location of the user. You can set the accuracy from 20 to 100 meters (default is 20).

GeoSpark.getCurrentLocation(this, accuracy, new GeoSparkLocationCallback(){
    @Override
    public void location(double latitude, double longitude, double accuracy) {

    }
    @Override
    public void onFailure(GeoSparkError geoSparkError) {
            geoSparkError.getErrorCode();
            geoSp arkError.getErrorMessage();
    }
});

Using updateCurrentLocation method, one can update user current location, you can set the accuracy from 15 to 100 meters (default is 15).

Note: This method should be used only if you need to update the current location of the device with better accuracy. Using this method often might consume battery.

GeoSpark.updateCurrentLocation(this, accuracy);

Start trips in Geospark SDK, using startTrip() method.

GeoSpark.startTrip(this, "tripId", "Description", new GeoSparkTripCallBack() {
  @Override public void onSuccess(GeoSparkTrip geoSparkTrip) {
      geoSparkTrip.getMsg();
  }
  @Override public void onFailure(GeoSparkError geoSparkError) {
      geoSparkError.getErrorCode();
      geoSparkError.getErrorMessage();
  }
});

End trips in Geospark SDK, using endTrip() method.

GeoSpark.endTrip(this, "tripId", new GeoSparkTripCallBack() {
  @Override
  public void onSuccess(GeoSparkTrip geoSparkTrip) {
              geoSparkTrip.getMsg();
  }
  @Override
  public void onFailure(GeoSparkError geoSparkError) {
              geoSparkError.getErrorCode();
              geoSparkError.getErrorMessage();
  }
});        

Get active trips in GeoSpark SDK, using activeTrips() method.

GeoSpark.activeTrips(this, new GeoSparkTripsCallBack() {
  @Override
  public void onSuccess(List geoSparkActiveTrips) {
              geoSparkActiveTrips;
  }
  @Override
  public void onFailure(GeoSparkError geoSparkError) {
              geoSparkError.getErrorCode();
              geoSparkError.getErrorMessage();
  }
});      

Call this method to configure GeoSpark SDK settings for enabling location tracking during given app states.

GeoSpark.setTrackingInAppState(this, new GeoSpark.Type[]{Settings}); 

Call this method to configure GeoSpark SDK settings for enabling location tracking during given motion tracking.

GeoSpark.setTrackingInMotion(this, new GeoSpark.Type[]{Settings});

By using this method inside FirebaseMessagingService class, track the campaigns impressions and counts.

@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
    super.onMessageReceived(remoteMessage);
    NotificationManager notificationManager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
    ...
    intent.putExtra(GeoSpark.EXTRA, GeoSpark.notificationReceiveHandler(remoteMessage.getData()));
    ...
    notificationManager.notify(NotificationID, builder.build());
}


//MainActivity.java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    GeoSpark.notificationOpenedHandler(this, getIntent());
}

Logout from GeoSpark SDK, using logout() method.

GeoSpark.logout(this, new GeoSparkLogoutCallBack() {
  @Override
  public void onSuccess(String message) {
            ...
  }
  @Override
  public void onFailure(GeoSparkError geoSparkError) {
        geoSparkError.getErrorCode();
        geoSparkError.getErrorMessage();
  }
});     

When running the SDK on Android 6 (and higher), it is recommended to ask the user to disable battery optimization for your application. This makes sure that detections continue to work properly when the device is in Doze mode. Moreover, on Android Pie, it prevents Adaptive Battery from bucketing your app based on usage and restricting background processing, all of which that can impact the detection quality of the SDK.

After explaining to the user about the benefits of disabling battery optimization, call the disableBatteryOptimization() method of the GeoSpark class.

This will trigger a system dialog asking the user to allow disabling battery optimization for your app.

GeoSpark.disableBatteryOptimization(this);

Check battery optimization

GeoSpark.isBatteryOptimizationEnabled(this);

• Android 4.2 (API level 16) and above.
• Devices that support GPS. Devices with only A-GPS are not supported.

Download and unzip the GeoSpark SDK.

The package contains an aar file. In Android Studio, add the SDK as a module using File > New Module > Import .JAR/.AAR Package. Once Gradle is finished, click File > Project Structure again. Click on App, then Dependencies tab, then click the plus icon in the bottom left, select Module Dependency, click on GeoSpark, then press Ok and wait for Gradle to sync again and include the dependencies separately and sync your project.

android {
  .....
  compileOptions { 
      sourceCompatibility JavaVersion.VERSION_1_8 
      targetCompatibility JavaVersion.VERSION_1_8 
  }
  ......
}
          
dependencies { 
    implementation 'androidx.work:work-runtime:2.0.1' 
    implementation 'com.google.android.gms:play-services-location:15.0.1' 
    implementation 'com.squareup.retrofit2:retrofit:2.4.0' 
    implementation 'com.google.code.gson:gson:2.8.5'
    implementation 'com.squareup.retrofit2:converter-gson:2.1.0'
    implementation 'ch.acra:acra-http:5.2.0'
}
  

Download and unzip the GeoSpark SDK.

If you haven't already, then add Firebase to your Android project.

public class MyFireBaseMessagingService extends FirebaseMessagingService {
  @Override
  public void onNewToken(String token) {
      super.onNewToken(token);
      if (token != null) {
            GeoSpark.setDeviceToken(this, token);
      }
  }
            
  @Override
  public void onMessageReceived(RemoteMessage remoteMessage) {
        super.onMessageReceived(remoteMessage);
        .......
    }
}

<application>
    ...
    <service
            android:name=".MyFireBaseMessagingService"
            android:exported="false">
            <intent-filter>
              <action android:name="com.google.firebase.MESSAGING_EVENT"/>
            </intent-filter>
    </service>
    ...
  </application>
  

Android O is coming up with restrictions on background updates, GeoSpark SDK needs use of Foreground service to send location updates. This will not lead to a persistent Foreground notification in the status bar. You can customize small icon and title in this notification.

GeoSpark.setNotificationIconAndText(this, smallIconId, title);
  

Added

• New utility method to toggle user events and get user events status.

Modified

• Minor bug fixes and preformation updates.

Added

• New utility method Notification Opened Handler.

Modified

• Redesigns the SDK under the hood to maximize reliability, efficiency, and making integration simple.

Added

• Update SDK Method for Trips V2.

Added

• New utility method to update user's current location.
• New utility method to check if location tracking is started.

Added

• Added a new method onError under GeoSparkReceiver which will receive all the error codes with description.

Removed

• Removed the method isMockEnabledinDevice which was used to check if mock application is enabled in the device. This method is replace with receiver for errors.

Added

• New utility method to disable battery optimization.
• New utility method to check battery optimization.
• New utility method to check mock enabled.

Added

• New utility method to get user’s current location.

Modified

• To customize the service notification.

Fixed

• Improved location tracking.

Modified

• Improvement in location tracking with better crash log support.

Fixed

• Minor and major bug fixes.

Added

• Added DeleteGeofence method.
• Added Logout method.
• Added SetDescription method.

Fixed

• Minor and major bug fixes.

Fixed

• Major and minor bug fixes.

Offline Location Updates Method

• We reliably track location offline and upload to server whenever connection is established back to internet. This feature helps to provide seamless tracking irrespective of internet connectivity issues.

Trips

• Manage trips through SDK using 'Start Trip' & 'End Trip'.
• Also track your trips as well using trip routes.

Geofence

• Using SDK can create personalized geofence & get those geofence list.