Getting started | Mobile SDK | 2GIS Documentation

Getting started

First you need to contact 2GIS technical support to get a new key. Be sure to specify the appId of the application for which the key will be generated. The resulting key file dgissdk.key needs to be added to assets.

To begin working with the SDK, call the initialize() method of DGis and specify the application context.

class Application : Application() {
    lateinit var sdkContext: Context

    override fun onCreate() {

        sdkContext = DGis.initialize(

Note that you cannot create more than one Context instance.

Additionally, you can specify logging settings (LogOptions) and HTTP client settings (HttpOptions) such as caching.

// Logging settings
val logOptions = LogOptions(

// HTTP client settings
val httpOptions = HttpOptions(
    useCache = false

// Consent to personal data processing
val dataCollectConsent = PersonalDataCollectionConsent.GRANTED

sdkContext = DGis.initialize(
    appContext = this,
    dataCollectConsent = dataCollectConsent,
    logOptions = logOptions,
    httpOptions = httpOptions