Skip to content

Create Data Connector

To use the Data Connector service and its features, the DataConnectorService needs to be initialized and a DataConnectorClient instance needs to be created. The initialize() method will only need to be called once.

Create Data Connector Client

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
import android.content.Context;
import com.telenav.sdk.core.SDKOptions;

try {
    SDKOptions sdkOptions = SDKOptions.builder()
            .setApiKey("#API_KEY_PROVIDED_BY_TELENAV#")
            .setApiSecret("#API_SECRET_PROVIDED_BY_TELENAV#")
            .setCloudEndPoint("#CLOUD_ENDPOINT_PROVIDED_BY_TELENAV#")
            .setSdkCacheDataDir("#PATH_TO_WRITE_DATA#")
            .setUserId("#USER_ID#")
            .setDeviceGuid("#DEVICE_ID#")
            .setApplicationInfo(ApplicationInfo.builder("#APPLICATION_NAME#", "#APPLICATION_VERSION#").build())
            .build();
    // Context MUST be like FragmentActivity.this that called android.os.Looper.prepare()
    DataConnectorService.initialize(MainActivity.this, sdkOptions);
} catch (DataConnectorException e) {
    // SDK init error, check your API key/secret, cloud endpoint and lib dependencies
}
DataConnectorClient dataConnectorClient = DataConnectorService.getClient();
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
import android.content.Context;
import com.telenav.sdk.core.SDKOptions;

try {
    val sdkOptions = SDKOptions.builder()
            .setApiKey("#API_KEY_PROVIDED_BY_TELENAV#")
            .setApiSecret("#API_SECRET_PROVIDED_BY_TELENAV#")
            .setCloudEndPoint("#CLOUD_ENDPOINT_PROVIDED_BY_TELENAV#")
            .setSdkCacheDataDir("#PATH_TO_WRITE_DATA#")
            .setUserId("#USER_ID#")
            .setDeviceGuid("#DEVICE_ID#")
            .setApplicationInfo(ApplicationInfo.builder("#APPLICATION_NAME#", "#APPLICATION_VERSION#").build())
            .build()
    // Context MUST be like FragmentActivity.this that called android.os.Looper.prepare()        
    DataConnectorService.initialize(MainActivity.this, sdkOptions)
} catch (e: DataConnectorException) {
    // SDK init error, check your API key/secret, cloud endpoint and lib dependencies
}
val dataConnectorClient = DataConnectorService.getClient()

Warning

The fields ApiKey, ApiSecret, CloudEndPoint, SdkCacheDataDir, UserId, DeviceGuid, ApplicationInfo of SDKOptions must be populated as they are mandatory for data connector functionality.


The SDK is now ready to use!