All-in-One

Getting Started

Prerequisites

You need a Mapsted account or Mapsted trial account for the Mobile SDK. Please contact sales for more information.

App Registration

You must register your app on your Mapsted account page. From there, you can access your mobile app licence file from the Mapsted developer portal.

Importing the Mapsted UI SDK

After downloading your Android licence files, please follow the steps below to begin importing the Mapsted SDK

Include Licence Files

Place the Mapsted Android licence file (android_licence.key), in the assets folder located at $(ProjectPath)/app/src/main/assets (create one if it does not exist).

Place the Mapsted basemap layer file (baselayer.mbtiles), in the assets folder, as well.

Import the Mapsted UI SDK

Basic integration with Mapsted's Core Positioning All-in-One is outlined below.

Add the following code into your project's gradle file:

allprojects {
    repositories {
        google()
        jcenter()
        maven {
            url "http://sdk.mapsted.com:8081/artifactory/gradle-mapsted"
            credentials {
                username = "<UserName>"
                password = "<Password>"
            }
        }
    }
}

Make sure you have all the settings below in the app level build.gradle file.

    //Apply androidX navigation safeargs plugin
    apply plugin: 'androidx.navigation.safeargs'

    //Required! Make sure the minSdkVersion is 24 in defaultConfig
    defaultConfig {
        minSdkVersion 24
    }

    //Required! Add databinding enabled to true under the android section
    dataBinding {
        enabled = true
    }

    //Required! Add dependencies for enabling the usage of Mapsted UI Sdk
    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
    annotationProcessor 'androidx.lifecycle:lifecycle-compiler:2.2.0-rc02'
    annotationProcessor 'androidx.room:room-compiler:2.2.1'

    //Add dependencies for using Mapsted UI Sdk
    implementation 'com.mapsted:core-positioning-all-in-one:3.4.4.2'

Initialization for Mapsted UI SDK

You can start using Mapsted UI Sdk just by opening the Intent for MapstedActivity and get all the below features:

  • Map Plotting
  • Map Search
  • Routing
  • Navigation
  • Instructions
  • Entity Selection
  • Floor Detection
  • User Positioning
  • Tag Creation and Tag Routing

Add the following tags to your AndroidManifest.xml inside your Application's body.

     // AndroidManifest.xml
     <application ...>
         ...

        <activity android:name="com.mapsted.ui.map.MapstedMapActivity" />
        <service android:name="com.mapsted.positioning.cppObjects.modules.foreground_service.MapstedForegroundService"/>
    </application>

Use the code below to get started with UI Sdk:

     // MainActivity.java
    import com.mapsted.ui.map.MapstedMapActivity;
    // ...
    @Override
    public void onCreate(Bundle savedInstanceState) {
        ...

        Intent intent = new Intent(this, MapstedMapActivity.class);
        intent.setFlags(Intent.FLAG_ACTIVITY_REORDER_TO_FRONT);
        startActivity(intent);
    }