Simple Asset Tracking

This example provides step by step guidance on:

Initializing Configurations with Default Values: Learn how to set up the SDK with default configuration settings, ensuring a straightforward integration process.
Creating and Binding a Simple Asset: Discover how to create and bind an asset within your application, enabling you to associate assets with your tracking system.
Starting Tracking and Uploading Location Data with Default Values: Gain insights into how to initiate tracking and the automatic uploading of location data using default parameters, simplifying the process of monitoring asset locations.

For all code examples, refer to Asset Tracking Android Code Examples

activity_simple_tracking.xml view source

1
<?xml version="1.0" encoding="utf-8"?>
2
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
3
   xmlns:app="http://schemas.android.com/apk/res-auto"
4
   xmlns:tools="http://schemas.android.com/tools"
5
   android:layout_width="match_parent"
6
   android:layout_height="match_parent"
7
   android:orientation="vertical"
8
   android:padding="10dp"
9
   tools:context=".codeexample.SimpleTrackingExample">
10

11
   <Button
12
       android:id="@+id/start_tracking_simple"
13
       android:layout_width="wrap_content"
14
       android:layout_height="wrap_content"
15
       android:text="@string/start_tracking"
16
       />
17

18
   <TextView
19
       android:id="@+id/asset_id_info"
20
       android:layout_marginTop="10dp"
21
       android:layout_width="wrap_content"
22
       android:layout_height="wrap_content"/>
23

24
   <TextView
25
       android:id="@+id/tracking_status_simple"
26
       android:layout_marginTop="10dp"
27
       android:layout_width="wrap_content"
28
       android:layout_height="wrap_content"/>
29

30
</LinearLayout>

SimpleTrackingExample view source

1
class SimpleTrackingExample : AppCompatActivity() {
2
    private lateinit var startTrackingButton: Button
3
    private lateinit var trackingStatusView: TextView
4
    private lateinit var assetIdView: TextView
5

6
    var permissionsManager: LocationPermissionsManager? = null
7
    private var assetId = ""
8

9
    override fun onCreate(savedInstanceState: Bundle?) {
10
        super.onCreate(savedInstanceState)
11
        setContentView(R.layout.activity_simple_tracking)
12
        initView()
13

14
        // initialize the Asset Tracking SDK
15
         initialize("PUT YOUR API KEY HERE")
16

17
        createAsset()
18
    }
19

20
    override fun onDestroy() {
21
        super.onDestroy()
22
        // add this to avoid blocking other example, could remove in real usage
23
        assetTrackingStop()
24
    }
25

26
    private fun initView() {
27
        startTrackingButton = findViewById(R.id.start_tracking_simple)
28
        startTrackingButton.setOnClickListener {
29
            bindAssetAndStartTracking()
30
        }
31

32
        trackingStatusView = findViewById(R.id.tracking_status_simple)
33
        assetIdView = findViewById(R.id.asset_id_info)
34
    }
35

36
    private fun createAsset() {
37
        val assetAttributes: Map<String, String> = mapOf("attribute 1" to "test 1", "attribute 2" to "test 2")
38
        val assetProfile = AssetProfile.Builder().setCustomId(UUID.randomUUID().toString()).setName("testName")
39
            .setDescription("testDescription").setAttributes(assetAttributes).build()
40

41
        createNewAsset(assetProfile, object : AssetApiCallback<AssetCreationResponse> {
42
            @SuppressLint("SetTextI18n")
43
            override fun onSuccess(result: AssetCreationResponse) {
44
                assetId = result.data.id
45
                Toast.makeText(
46
                    this@SimpleTrackingExample,
47
                    "create asset successfully with asset id: $assetId",
48
                    Toast.LENGTH_LONG
49
                ).show()
50

51
                assetIdView.text = "current asset id is: $assetId"
52
            }
53

54
            override fun onFailure(exception: Exception) {
55
                Toast.makeText(
56
                    this@SimpleTrackingExample,
57
                    "create asset failed with error: " + exception.message,
58
                    Toast.LENGTH_LONG
59
                ).show()
60
            }
61
        })
62
    }
63

64
    private fun bindAssetAndStartTracking() {
65
        bindAsset(assetId, object : AssetApiCallback<Unit> {
66
            @SuppressLint("SetTextI18n")
67
            override fun onSuccess(result: Unit) {
68
                Toast.makeText(
69
                    this@SimpleTrackingExample,
70
                    String.format(
71
                        "bind asset successfully with assetId: %s",
72
                        assetId
73
                    ),
74
                    Toast.LENGTH_LONG
75
                ).show()
76
                checkPermissionsAndStartTracking()
77
            }
78

79
            override fun onFailure(exception: Exception) {
80
                val exceptionMessage = exception.message ?: ""
81
                Toast.makeText(
82
                    this@SimpleTrackingExample,
83
                    "bind asset failed: $exceptionMessage",
84
                    Toast.LENGTH_LONG
85
                ).show()
86
            }
87
        })
88
    }
89

90
    private fun checkPermissionsAndStartTracking() {
91
        if (LocationPermissionsManager.areAllLocationPermissionGranted(this)) {
92
            startTracking()
93
        } else if (!LocationPermissionsManager.isLocationServiceEnabled(this)) {
94
            showLocationServiceOffDialog()
95
        } else {
96
            permissionsManager = LocationPermissionsManager(object : LocationPermissionsListener {
97
                override fun onExplanationNeeded(permissionsToExplain: List<String>?) {
98
                    Toast.makeText(
99
                        this@SimpleTrackingExample, "You need to accept location permissions.",
100
                        Toast.LENGTH_SHORT
101
                    ).show()
102
                }
103

104
                override fun onPermissionResult(granted: Boolean) {
105
                    if (granted) {
106
                        if (LocationPermissionsManager.isBackgroundLocationPermissionGranted(this@SimpleTrackingExample)) {
107
                            startTracking()
108
                        } else {
109
                            permissionsManager?.requestBackgroundLocationPermissions(this@SimpleTrackingExample)
110
                        }
111
                    } else {
112
                        Toast.makeText(
113
                            this@SimpleTrackingExample, "You need to accept location permissions.$granted",
114
                            Toast.LENGTH_SHORT
115
                        ).show()
116
                    }
117
                }
118
            })
119
            permissionsManager?.requestLocationPermissions(this)
120
        }
121
    }
122

123
    @SuppressLint("MissingPermission", "SetTextI18n")
124
    fun startTracking() {
125
        assetTrackingStart()
126
        trackingStatusView.text = "Asset Tracking is running"
127
    }
128

129
    private fun showLocationServiceOffDialog() {
130
        val alertDialogBuilder = AlertDialog.Builder(this)
131

132
        alertDialogBuilder.setTitle("Location Services Disabled")
133
        alertDialogBuilder.setMessage("To enable location services, please go to Settings > Privacy > Location Services.")
134

135
        alertDialogBuilder.setPositiveButton("OK") { dialogInterface: DialogInterface, _: Int ->
136
            dialogInterface.dismiss() // Close the dialog
137
        }
138

139
        val alertDialog = alertDialogBuilder.create()
140
        alertDialog.show()
141
    }
142

143
}

Upon executing the code example provided above, your app's appearance will resemble the following snippet:

Code Highlights

The above code snippet is for an Android activity that demonstrates how to start tracking an asset using the Asset Tracking SDK. The activity has the following main steps:

Initialize the Asset Tracking SDK.
Create an asset.
Bind the asset to the device.
Check for location permissions and start tracking.

The following is a description of each step:

To initialize the Asset Tracking SDK, the activity calls the initialize() method with your API key.
To create an asset, the activity creates an AssetProfile object and sets its properties. The AssetProfile object specifies the asset's custom ID, name, description, and attributes.
To bind the asset to the device, the activity calls the bindAsset() method with the asset ID.
To check for location permissions and start tracking, the activity calls the checkPermissionsAndStartTracking() method. This method first checks if all location permissions are granted. If they are, the method starts tracking the asset. If they are not granted, the method shows a dialog to the user asking them to grant the permissions.

The code snippet also includes a few helper functions:

showLocationServiceOffDialog(): This function shows a dialog to the user if location services are disabled.
startTracking(): This function starts tracking and uploading the location data of the asset.