| implementation 'io.quadrant.sdk.locationdata:data-acquisition-sdk:<latest version>' |
Latest version: 1.0.0
| Client.getInstance().setup(MainActivity.this, true, false, INTEGRATION_KEY, new Client.ResultCallback() { @Override public void onSuccess(String result) { //start location data collection } @Override public void onError(String result) { //add error condition/ alert } }); |
Example:
Congratulations! You have successfully integrated the library into your android project!
STEP 1 - The library requires three permissions to run properly. Declare them in your app manifest.xml file.
| <uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> |
STEP 2 - And to start collecting, call this method
| Client.getInstance().startTrackingLocation(); |
Make sure to call the above method inside onSuccess() callback method Client.getInstance().setup() that we declared before. As shown below:
Congratulations! You have now configured everything required for location tracking!
STEP 1 - Installation using Cocoapods
Add this line in your Podfile:pod "QDPublisher", :git => 'https://github.com/datastreamx-plc/ios-data-acquisition-sdk.git' |
and then install by type pod install in your command line
Register your integration key after app launch, usually your AppDelegate.swift
import QDPublisher to use this framework
Setup your integration key and error handle in didFinishLaunchingWithOptions
| import QDPublisher @UIApplicationMain class AppDelegate: UIResponder, UIApplicationDelegate { let publisher = QDPublisher.service let integrationKey: String = "your integration key here" func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool { QDPublisher.service.setup(integrationKey) QDPublisher.service.connectionErrorHandler = { error in // handle error here } } } |
For location tracking, you can use this code QDPublisher.service.track(choosedLocation) in your location service, it usually looks like this:
| func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) { guard let choosedLocation: CLLocation = locations.first else { return } QDPublisher.service.track(choosedLocation) } |
