iOS SDK

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

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

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

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

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

Кроме этого, если вы планируете прокладывать маршруты на карте или использовать справочник для получения информации об объектах, то вам нужно получить дополнительные ключи.

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

Получение ключей доступа с версии 4.x

Для работы с 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-репозитории.