Начало работы

Сначала нужно обратиться в техническую поддержку 2ГИС для получения нового ключа. Обязательно нужно указать appId приложения, для которого будет создан ключ. Полученный файл ключа dgissdk.key нужно добавить в assets.

Для работы с SDK нужно вызвать метод initialize() объекта DGis, указав контекст приложения:

import 'package:dgis_mobile_sdk_map/dgis.dart' as sdk;

class SomeApp extends StatelessWidget {
    final sdkContext = sdk.DGis.initialize();
}

Обратите внимание, что нельзя создавать более одного экземпляра Context.

Дополнительно можно указать настройки журналирования LogOptions и настройки HTTP-клиента HttpOptions, например таймаут запроса:

import 'package:dgis_mobile_sdk_map/dgis.dart' as sdk;

class SomeApp extends StatelessWidget {

  final sdkContext = sdk.DGis.initialize(
    logOptions: const sdk.LogOptions(
      customLogLevel: sdk.LogLevel.verbose,
      logLevel: sdk.LogLevel.verbose,
    ),
    httpOptions: const sdk.HttpOptions(
      timeout: Duration(seconds: 5),
    ),
  );
}

Vendor Config

Для переопределения некоторых настроек работы SDK используется файл в формате VendorConfig, который передается при инициализации SDK.

Существует несколько способов создать экземпляр класса VendorConfig:

VendorConfigFromAsset — файл необходимо расположить в каталоге assets исходного кода приложения и указать имя файла в конструкторе.
VendorConfigFromFile — файл необходимо расположить в файловой системе устройства и указать абсолютный путь до него.
VendorConfigFromString — в конструктор необходимо передать строку с содержимым файла формата JSON.

Созданный экземпляр VendorConfig передается в метод DGis.initialize() параметром vendorConfig.