Estimote Indoor Location SDK allows real-time beacon-based mapping and indoor location.
Estimote Indoor Location is a sophisticated software solution that makes it incredibly easy and quick to map any location. Once done, you can use our SDK to visualize your approximate position within that space in real-time, in your own app.
Indoor Location creates a rich canvas upon which to build powerful new mobile experiences, from in-venue analytics and proximity marketing to frictionless payments and personalized shopping.
Estimote Indoor Location works exclusively with Estimote Beacons.
Add this line to your build.gradle file:
dependencies {
compile 'com.estimote:indoorsdk:1.0.1'
}Initialize Estimote SDK in your Application class onCreate() method:
// To get your AppId and AppToken you need to create a new application in Estimote Cloud.
EstimoteSDK.initialize(applicationContext, appId, appToken)
// Optional, debug logging.
EstimoteSDK.enableDebugLogging(true)Use IndoorCloudManagerFactory to get objects for communicating with our cloud.
You will need Location objects to start indoor positioning, so this step is really important.
// KOTLIN
val cloudManager = IndoorCloudManagerFactory().create(applicationContext)
cloudManager.getLocation("your location id here", object : CloudCallback<Location> {
override fun success(locations: Location?) {
// do something with your location here. You will need it to init IndoorManager and IndoorView
}
override fun failure(serverException: EstimoteCloudException?) {
// handle error here
}
})// JAVA
IndoorCloudManager cloudManager = new IndoorCloudManagerFactory().create(this);
cloudManager.getLocation("your-location-id-here", new CloudCallback<Location>() {
@Override
public void success(Location location) {
// do something with your Location object here.
// You will need it to initialise IndoorLocationManager!
indoorLocationView = (IndoorLocationView) findViewById(R.id.indoor_view);
indoorLocationView.setLocation(location);
}
@Override
public void failure(EstimoteCloudException e) {
// oops!
}
});Use IndoorLocationView to display your location on screen. You need to put it in your activity's XML layout file.
...
<com.estimote.indoorsdk.view.IndoorLocationView
android:id="@+id/indoor_view"
android:layout_height="match_parent"
android:layout_width="match_parent"
android:background="COLOR HERE/>
...Then you can simply bind this view to an object in your activity:
// KOTLIN
indoorLocationView = findViewById(R.id.indoor_view) as IndoorLocationView
// Don't forget to init view with your Location object!
indoorLocationView.setLocation(location)// JAVA
IndoorLocationView indoorLocationView = (IndoorLocationView) findViewById(R.id.indoor_view);
indoorLocationView.setLocation(location);IndoorLocationManager is the object that does all the magic to provide you with a user's estimated position.
You need to initialize it with your application Context and—of course—Location objects. Using withDefaultScanner() will allow it to scan for beacons by itself - no additional work for you!
// KOTLIN
indoorLocationManager = IndoorLocationManagerBuilder(this, mLocation)
.withDefaultScanner()
.build()// JAVA
ScanningIndoorLocationManager indoorLocationManager =
new IndoorLocationManagerBuilder(this, location)
.withDefaultScanner()
.build();And don't forget to set a listener for positioning events!
// KOTLIN
indoorLocationManager.setOnPositionUpdateListener(object : OnPositionUpdateListener {
override fun onPositionUpdate(locationPosition: LocationPosition) {
indoorLocationView.updatePosition(locationPosition)
}
override fun onPositionOutsideLocation() {
indoorLocationView.hidePosition()
}
})// JAVA
indoorLocationManager.setOnPositionUpdateListener(new OnPositionUpdateListener() {
@Override
public void onPositionUpdate(LocationPosition locationPosition) {
indoorLocationView.updatePosition(locationPosition);
}
@Override
public void onPositionOutsideLocation() {
indoorLocationView.hidePosition();
}
});Now we're ready to start positioning. Use code like this in your Activity's onStart method:
// KOTLIN
...
override fun onStart() {
super.onStart()
indoorLocationManager.startPositioning()
}
...// JAVA
...
@Override
protected void onStart() {
super.onStart();
indoorLocationManager.startPositioning();
}
...and don't forget to stop using the onStop method!
// KOTLIN
...
override fun onStop() {
super.onStop()
indoorLocationManager.stopPositioning()
}
...// JAVA
...
@Override
protected void onStop() {
super.onStop();
indoorLocationManager.stopPositioning();
}
...Javadoc documentation is available here
At Estimote we're massive believers in feedback! Here are some common ways to share your thoughts with us:
- Posting issue/question/enhancement on our issues page.
- Asking our community managers on our Estimote SDK for Android forum.
To see what has changed in recent versions of Estimote SDK for Android, see the CHANGELOG.