Android Documentation

v1.3.2

This is an example project demonstrating how to use the Cintric Android SDK. You can also use this project to test the functionality of the Android SDK on your device.

This project will track you throughout the day and save location updates to a text file. You can then see everywhere you went on a map, and view the times that your location was updated.

Open the project from github and run it on your Android Device. You should see your current location appear on the map. Try leaving the example project on your phone for a couple days and see how well it works.

Visit the GitHub project here.

Cintric SDK is an optimized Android Framework which tracks users locations in the background while using very little battery throughout the day.

Cintric's Android SDK can be integrated by following these steps:

  • Create a Cintric developer account and get your SDK Key.
  • Download the cintric.aar file and add it to your project as a module dependency
  • Add google play services to your build.gradle
  • Add your google play app id to your app's resources/values/strings.xml file
  • Add the required code to your main activity, using your Cintric SDK Key and Secret.

Head over to http://cintric.com/register and sign up. You can find your SDK Key and Secret under account settings.

Go to your project structure settings.

In the top left corner hit the plus icon to create a new module.

Select Import .JAR / .AAR Package and click next.

Type the path to the cintric.aar file you downloaded.

Click your app module, click dependencies and click the plus icon in the bottom left corner.

Select cintric and hit OK, then hit OK to leave your project structure settings.

To start Cintric, you must call:
Cintric.startCintricService(this, "YOUR-SDK-KEY", "YOUR-SECRET-KEY");

You should call this method in your Main Activity's onCreate method. Or if you're targeting android 6.0+ call this method when you're ready to request location premissions.

If your app's targetSdkVersion is 23 or higher (Android 6.0), you must also implement this method:

Optional: Location Callback

You can also implement CintricEventHandler if you want callbacks for location updates.
The following code shows an example of a MainActivity which fully implements the Cintric SDK.

Minimum version for the AAR is Android API 14 (Ice Cream Sandwich).

Cintric will use the following permissions:

However, including these in your manifest is optional, because they will automatically be mereged in from the cintric.aar manifest file.

Update History

Cintric Android SDK 1.3.2

  • Added function to sync a user custom id Cintric.setUserCustomId(getApplicationContext(), "example_custom_id");

Cintric Android SDK 1.3.0

  • Bug fixes and optimizations

Cintric Android SDK 1.2.04

  • Fixed a crash that may occur when not connected to a network

Cintric Android SDK 1.2.01

  • Added Ad ID functionality
  • Networking optimizations that prevent duplicate requests

Cintric Android SDK 1.1.04

  • Improved Location Tracking
  • Preformance Improvments
  • Bug Fixs