Начало работы
Начало работы
Сначала нужно обратиться в техническую поддержку 2ГИС для получения нового ключа. Обязательно нужно указать appId
приложения, для которого будет создан ключ.
Для работы с SDK нужно создать специальный объект Container, который будет хранить все сущности, связанные с картой.
Чтобы его создать, нужно указать путь до файла ключа через объект структуры ApiKeyOptions. При указании ApiKeyOptions.default файл должен быть добавлен в корень приложения.
// Файл ключа для доступа к сервисам.
let apiKeyOptions = ApiKeyOptions(apiKeyFile: File(path: "Path to key info file"))
// Создание контейнера для доступа к возможностям SDK.
let sdk = DGis.Container(apiKeyOptions: apiKeyOptions)
Обратите внимание, DGis.Container может быть создан только в единственном экземпляре.
Дополнительно можно указать настройки журналирования (LogOptions) и настройки HTTP-клиента (HTTPOptions), такие как время ожидания ответа и кеширование.
// Настройки журналирования.
let logOptions = LogOptions(osLogLevel: .info)
// Настройки HTTP-клиента.
let httpOptions = HTTPOptions.default
// Сервисы геопозиционирования.
let positioningServices: IPositioningServicesFactory = CustomPositioningServicesFactory()
// Настройки сбора анонимной статистики использования.
let dataCollectionOptions = DataCollectionOptions(dataCollectionStatus: .agree)
// Создание контейнера.
let sdk = DGis.Container(
apiKeyOptions: apiKeyOptions,
logOptions: logOptions,
httpOptions: httpOptions,
positioningServices: positioningServices,
dataCollectionOptions: dataCollectionOptions
)