iOS SDK
iOS SDK позволяет добавить карту 2GIS в ваше iOS-приложение. С помощью этого SDK можно отобразить карту на экране, добавить на неё маркеры, рисовать геометрические фигуры, получать информацию об объектах, управлять камерой и так далее.
Примеры использования SDK можно найти в разделе Примеры. Описание всех классов и методов можно найти в разделе Справочник API.
Картографические данные поддерживают стандарты OGC.
Получение ключей доступа
Для работы с SDK нужно получить файл ключа dgissdk.key
с обязательным указанием appId
приложения, для которого этот ключ создается. Ключ будет использоваться для подключения к серверам 2ГИС, получения географических данных, а также для использования офлайна и навигатора. Этот ключ уникален для этого типа SDK и не может быть использован с другими SDK от 2ГИС.
Чтобы получить файл ключа, заполните форму на dev.2gis.ru.
После активации ключа вы можете зарегистрироваться в личном кабинете Platform Manager и просматривать статистику распределения запросов.
Требования к устройствам
- Xcode 14.
- iOS 13 и выше / iPadOS 13 и выше (это обусловлено использованием SwiftUI в проекте).
Установка
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-full-swift-package
- полная версия.https://github.com/2gis/mobile-sdk-map-swift-package
- облегченная версия.
В файле Package.swift
будет указан URL, ведущий на загрузку архива с SDK по прямой ссылке. Для навигации по версиям используейте тэги git.
Демонстрационный проект
Демонстрационное приложение с исходным кодом можно найти в нашем GitHub-репозитории.