Services
API Interface / Android
Update Config
Change the config originally passed in setup.
Occasionally this functionality is needed for deployed apps when a projects configuration is updated on the backend.
Detection Services
Start Automatic Detection
Starts the required detection services stated in the MoveConfig passed on initialization. Starting the service will set the MoveSdkState to Running
.
Precondition: MOVE SDK must be inREADY
MoveSdkState.
Stop Automatic Detection
Stops the automatic detection service, including all MOVE SDK services like driving detection, points of interest, walking and places. Stopping the service will set the MoveSdkState back to Ready
.
Precondition: MOVE SDK must be inRunning
MoveSdkState.
Trip Services
Force Trip Recognition
Temporarily calibrates the MOVE SDK to the highest detection mode.
In order to optimize battery consumption, the MOVE SDK goes through different detection modes with different battery consumption levels, depending on the user's current behavior and activity. In general, the MOVE SDK is responsible for alternating between those different detection modes.
The MOVE SDK also provides hosting apps this API to call if they have their own reasons (like buttons, sensors or beacons) to believe that the user is starting a trip. This will make sure the MOVE SDK is on the highest detection state to detect the trip faster.
Precondition: SDK must be inRUNNING
MoveSdkState.
Finish Current Trip
Ends the current ongoing trip.
This API will end the ongoing trip and set MoveTripState back to .idle
. The MOVE SDK is responsible for detecting the trip start and end points. The MOVE SDK also provides hosting apps this API to call if they have their own reasons (like sensors or beacons) to believe that the user's trip has ended.
Precondition: MoveTripState should be in an active trip.
If this API is called while the user is active on a driving trip, a new trip will start again right away. If the intention is to un-track the ongoing trip, call ignoreCurrentTrip
API.
More information about trip states can be found in MoveTripState.
Ignore Current Trip
Ignores the current ongoing trip.
This API will set the ongoing MoveTripState to .ignored
. Data of ignored trips is purged and not sent to the server.
Precondition: MoveTripState should be in an active trip.
Set Trip Start Listener
Provides a block to be invoked when a trip actually begins.
In comparison to the tripStateListener (only state changes) the tripStartListener will provide you with the start time of the actual trip.
Processing Services
Keep in foreground
When an Android application is in the background it may receive limited data (location, sensors, etc.). To improve this behavior, it is possible to put the application always in the foreground with a visible notification that cannot be discarded. Just because it's visible it doesn't mean that it is performing any data collection at all. So this should not have any significant battery impact at all.
Disabled by default.
Since it may be annoying to the user, it should only be enabled in case of problems.
Keep active
To save battery consumption, the MOVE SDK is using several triggers to start its data listeners. In case of trouble, these triggers can be circumvented by allowing the MOVE SDK to stay active all the time. In that case the MOVE SDK is always monitoring required data and is therefore consuming more battery. Depending on the configuration, it may happen that the notification (see notification handling) is always visible to the user.
Disabled by default.
Since this is consuming more battery, it should only be enabled in case of problems.
Console logging
Toggles whether the MOVE SDK is allowed to log into the console or not.
Enabled by default.
Mock locations
In Android it is possible to use simulated location by enabling it in the device developer mode. If you want the MOVE SDK to support those locations, you need to specify it. By default this is disabled to prevent wrong data.
Points of Interests are not supported with mock locations. Keep in mind that mock locations may have negative impact on trip recognition afterwards.
Rooted devices are still able to send mock locations without allowing mock locations.
Get MOVE SDK State
Gets the current MoveSdkState.
Get Trip State
Gets the current MoveTripState.
Get Device Status
Gets the current MoveDeviceStatus.
Get Service Failures
Gets the current MoveServiceFailures.
Set Service Error Listener
Provide a block to be invoked every time MoveServiceFailures will change.
Get Service Warnings
Gets the current MoveServiceWarnings.
Set Service Warning Listener
Provide a block to be invoked every time MoveServiceWarnings will change.
Delete Local Data
Deletes all the collected user MOVE SDK data stored on the device. This doesn't affect the MoveSdkState.
Precondition: MOVE SDK must be initialized.
Shutdown SDK
Shutdown SDK shared instance.
Stops SDK services, send the queued user data, and de-initializes the MOVE SDK. After .shutdown() is executed, the MoveSdkState will transit to Uninitialised
.
Precondition: MOVE SDK must be initialized.
Geocoding
Geo-coordinate address lookup.
Geocode will try a reverseGeocodeLocation or fallback to contacting the MOVE backend to attempt a geo-lookup.
Throttle: Geocode is limited to a maximum of 100 lookups per hour.
Delete Local Data
Deletes all the collected user MOVE SDK data stored on the device. This doesn't affect the MoveSDKState.
Precondition: MoveSDKState should be initialized.
Synchronize User Data
Used to force synchronizing user data with the MOVE backend. Limited to once per 2 minutes.
The result Returns FALSE in case there are Timeline-relevant packages in the queue that remain to be sent to the MOVE backend; and it returns TRUE in case the queue is empty.
Other services
Initiate Assistance Call
New feature in MOVE SDK 2.x; configuration in MOVE dashboard pending - please get in touch.
Initiate an assistance call to emergency services.
Precondition: The assistance call service needs to be configured. The MOVE SDK needs to be in ready or running state.
Set Assistance MetaData
New feature in MOVE SDK 2.1.
Before SDK 2.4 Android returns null.
Get a unique qualifier to identify the individual device.
The metadata string is set once, and then sent to the server with each and every manual assistance call and with AID report. The contents of the string can be anything, e.g. JSON data. The assistance data is persisted once set.
Get Device Qualifier
Get a unique qualifier to identify the individual device. For Android returns null
The device qualifier should be passed to the backend during user registration. See Move backend.
Set Device Discovery Listener
Set a device discovery listener to be fired when registered MoveDevice's are scanned. It returns a list of the devices registered during registerDevice.
If stopScanOnFirstDiscovered of the DeviceDiscovery object is set to true the list may be incomplete.
Register Device
Please note that MoveDevices can only be registered if the SDK has been configured with .setup()
Register MoveDevice's / add more MoveDevice's:
Unregister Device
Unregister a MoveDevice:
All devices are unregistered after shutdown.
Get Registered Devices
Get current registered MoveDevice's.
Alternative it is possible to subscribe to registered devices changes.
Additional device discovery methods
Converts android.bluetooth.le.ScanResult into a MOVE SDK specific MoveDevice.
Converts android.bluetooth.BluetoothDevice into a MOVE SDK specific MoveDevice.
Configuration services
Update authentication
Deprecated: Token expiry is no longer a valid auth state forwarded to the app and does not need to be handled.
Updates MOVE SDK MoveAuth. The host app was expected to fetch a new MoveAuth using its project API key and pass it to the MoveSDK using the following API:
Set Remote Config Change Listener
Since MOVE SDK v2.5
Provides a block to be invoked every time MoveConfig was successfully fetched from the server.
If the MoveConfig object couldn't be fetched from the server then a MoveConfigurationError ServiceUnreachable will be triggered.
Last updated