You are viewing an old version of this page. View the current version.
Way Finding (Static and Dynamic) Integrations
The following guide provides complete instructions and code snippets for the SDK integration for your Android LBS (Mapping) experience in your apps.
The first three sections are for both Routing and Blue Dot (static and dynamic way finding).
The last two sections exclusively are for Blue Dot (dynamic way finding or turn-by-turn).
Android Installation - Getting Started
This guide is a quick start to adding a Phunware Map to an Android app. Android Studio is the recommended development environment for building an app with the Phunware Mapping SDK.
Step 1- Add the Phunware Maven remote repository.
Insert this block into
Step 2 - Add the Mapping SDK as a dependency in your app's
This one line includes all dependencies necessary to use the Phunware Mapping SDK.
Step 3 - Add your Google Maps Api Key to
Create a string resource that contains your Google Maps API Key.
If you need help getting a Google Maps API Key, please find instructions here: Get a Google Maps API key
Step 4 - Add Phunware keys for App Id, Access Key, Signature Key and Encryption Key
Your App Id, Access Key, Signature Key and Encryption Key are found on the MaaS portal on the Applications tab.
Step 5 - Add MapFragment to your layout
This is where the Phunware Mapping SDK will render the map.
NOTE: the fragment will be found via the R.id.map id.
Step 6 - Get the Map asynchronously in your activity:
The PhunwareMapManager is created and the Phunware API keys are registered in this step.
Then the MapFragment is located and the map is loaded asynchronously.
Your implementation of OnPhunwareMapReadyCallback will be called when the map is ready.
Step 7 - Make sure your activity implements
Once the PhunwareMap is ready, set it in the PhunwareMapManager and add a building by id.
Building additions are also asynchronous, so a callback will notify you of success or failure.
Step 8 - Do something interesting with the Building
Once the map and building are loaded, move and zoom the view so you can see the initial floor.
Getting POI info from a Map Marker
The Mapping SDK associates a PointOptions object with its associated Google map marker object.
When setting up InfoWindow click listeners, you can access the POI info from the marker by calling the getTag() method on the marker and cast it to PointOptions.
Using a MapView in a Custom Layout
MapView is a subclass of the Google Maps MapView class. It can be used to place a map in any Android View.
Users of the MapView class must forward all the activity lifecycle methods to the corresponding methods in the MapView class. Examples of these methods include onCreate(), onDestroy(), onResume() and onPause().
Dynamic Way Finding Signal Provider Integrations
Integrating a Location Provider
In order to show the user's current location, you must add a Location Provider, which updates location information.
Phunware's location providers:
|Senion Lab BLE (bluetooth low energy) location provider|
|Cisco Hyperlocation (wifi) location provider|
|GPS location provider|
NOTE: Additional providers, Beacon Point and Mist are integrated as as Managed Providers.
NOTE:Managed Provider must be built and set on my MapManager after the the map is ready and the building has been loaded.
Step 1 - Add a location provider as a compile dependency
Step 2 - Set the Location Provider and Enable Location Updates
The PhunwareMapManager is told what provider is being used to get location updates.
As seen the code snippet, the Senion Location Provider requires a customer id and map id. The method getSenionFloorMap() returns a HashMap of Senion floor ids to MaaS floor ids.
The call to setMyLocationEnabled() allows you to control when the blue dot is rendered.
Step 3 - Manage Location Updates when in the Background
Constant location updating in the background will drain a signal device's battery. To prevent this, Phunware uses intercept activity lifecycle methods to disable and enable location updates.
Integrating a Managed Provider
Managed Providers offer a combination of signal location providers. This combination results in higher accuracy rates for location in dynamic way finding.
Step 1 - Add the Phunware Maven remote repository. Insert this block into
Step 2 - Add Phunware key resources to strings.xml for App Id, Access Key, Signature Key
Navigate to the MaaS portal, find your app, and add your access key and signature key to setup your application.
Step 3 - Add Phunware keys for App Id, Access Key, and Signature Key to Manifest
Step 4 - Add managed provider as a compile dependency.
Step 5 - Set the Location Provider on the PhunwareMapManager
The following values are needed to build a ManagedProvider:
- application: reference to the users application
- context: context of the application
- venueId: Id of the venue/building you currently have loaded
- (optional) Senion values
- slCustomerId: The customer ID provided by Senion
- slMapKey: the map key provided by senion
- (optional) Beacon Point values
- bpOrgId: the orgId provided by Beacon Point
Step 6 - Enable Location Updates
Enable location updates after setting the map, building and provider
Step 7 - Manage Location Updates when in the Background
In order to ensure that lifecycles are managed correctly, stop location updates must not be requested in the background.Updates must be requested in the foreground.