Getting started - Android

Basic steps to start using Woosmap Mobile SDK for Android
  1. Installation
    1. Gradle Config
    2. AndroidManifest.xml Configuration
  2. Initialization
  3. Tracking


The easiest way to use Woosmap Mobile in your Android project is with Gradle. Woosmap Mobile Android SDK is hosted on GitHub. You need to contact us to get access to the repository and download the SDK.

Gradle Config

Once downloaded, you’ll need to put the file woosmap-mobile-sdk.aar in your libs directory. Add dependencies of '*.aar' libraries (for Woosmap Mobile) in app/build.gradle file.

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])

AndroidManifest.xml Configuration

Create, if it’s not already done, a Woosmap Mobile Private key through the Woosmap Console. Woosmap Create a Private Key

And set up the private key newly created inside your the <application> block of your AndroidManifest.xml file.

<meta-data android:name="woosmap_private_key" android:value="Your_Woosmap_Private_key"/>


Import Woosmap Mobile package in your Application class.

import com.webgeoservices.woosmap_mobile_sdk.Woosmap;

Initialize Woosmap Mobile from onCreate callback of your Application class as shown below.

public Woosmap woosmap;
protected void onCreate(Bundle savedInstanceState) {
    this.woosmap = Woosmap.getInstance().initializeWoosmap(this);


You'll need to request permission from user and set user tracking to true or false from permission request callback depending on whether permission is granted or not. Check next topic to see how.

Woosmap Mobile SDK automatically starts tracking user data by calling woosmap.updateUserTracking(true). Data are stored on the device in a local database and synced when the network connectivity is available.

Please, follow steps described in the Location Tracking section to complete the Woosmap Mobile integration in your Android app.