iOS SDK

iOS SDK позволяет добавить карту 2GIS в ваше iOS-приложение. С помощью этого SDK можно отобразить карту на экране, добавить на неё маркеры, рисовать геометрические фигуры, получать информацию об объектах, управлять камерой и так далее.

Примеры использования SDK можно найти в разделе Примеры. Описание всех классов и методов можно найти в разделе Справочник API.

Картографические данные поддерживают стандарты OGC.

Получение ключей доступа

Для работы с SDK нужно получить файл ключа dgissdk.key с обязательным указанием appId приложения, для которого этот ключ создается. Ключ будет использоваться для подключения к серверам 2GIS, получения географических данных, а также для использования офлайна и навигатора. Этот ключ уникален для этого типа SDK и не может быть использован с другими SDK от 2GIS.

Чтобы получить файл ключа, заполните форму на dev.2gis.ru.

Требования к устройствам

Xcode 12
iOS 13.0+ или iPadOS 13.0+ (это обусловлено использованием в проекте SwiftUI)

При необходимости можно использовать xcframework для сборки проекта под iOS 12.

Установка

iOS SDK доступен в двух версиях: полной и облегченной. Облегченная версия не включает навигатор и не позволяет строить маршруты.

Swift Package Manager

Чтобы установить iOS SDK, нужно добавить в проект пакетную зависимость. Подробнее про установку Swift-пакетов можно прочитать в официальной документации.

Для подключения SDK нужно указать один из следующих URL:

https://github.com/2gis/mobile-sdk-map-swift-package - для установки облегченной версии.
https://github.com/2gis/mobile-sdk-full-swift-package - для установки полной версии.

Cocoapods

Для подключения через Cocoapods необходимо добавить в зависимости DGisMobileSDK.

Версионирование соответствует тому, что используется в Swift PM, однако необходимо добавлять постфикс -map или -full в зависимости от необходимого варианта SDK.

Спецификацию пода можно посмотреть по одному из следующих URL:

https://github.com/2gis/mobile-sdk-full-swift-package/blob/master/DGisMobileSDK.podspec - полная версия.
https://github.com/2gis/mobile-sdk-map-swift-package/blob/master/DGisMobileSDK.podspec - облегченная версия.

Бинарный артефакт

Фреймворки можно загрузить напрямую, минуя пакетные менеджеры. Для этого нужно обратиться к репозиторию, содержащему спецификацию пакетов для Cocapods или Swift Package manager:

https://github.com/2gis/mobile-sdk-map-swift-package - полная версия.
https://github.com/2gis/mobile-sdk-full-swift-package - облегченная версия.

В файле Package.swift будет указан URL, ведущий на загрузку архива с SDK по прямой ссылке. Для навигации по версиям используейте тэги git.

Демонстрационный проект

Демонстрационное приложение с исходным кодом можно найти в нашем GitHub-репозитории.