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-пакетов можно прочитать в официальной документации.

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

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

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

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

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