Skip to content

2gis/mobile-sdk-ios-demo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

2GIS iOS Native SDK

⚠️  iOS Native SDK находится в процессе разработки. Не подготовлен к использованию в реальных приложениях.

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

Полную документацию к SDK, включающую примеры использования и описание всех классов и методов, можно найти на сайте docs.2gis.com.

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

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

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

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

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

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

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

Установка

...

Запуск демо-приложения

Чтобы запустить демонстрационное приложение:

  1. Склонируйте этот репозиторий.

  2. Откройте проект app.xcodeproj и задайте ваши ключи API в файле Info.plist проекта:

    DGISMapAPIKey = YOUR_MAP_KEY
    DGISDirectoryAPIKey = YOUR_DIRECTORY_KEY
    

    Или создайте в корне репозитория файл Local.xcconfig с вашими ключами (файл включён в .gitignore):

    DGIS_MAP_API_KEY = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    DGIS_DIRECTORY_API_KEY = xxxxxxxxxx
    

    Если соответствующая функциональность не нужна, можно оставить эти значения.

  3. Дождитесь загрузки зависимостей через SwiftPM. Эта операция может занять длительное время.

    Вы не сможете собрать и запустить проект, пока не будут загружены зависимости.

  4. Соберите и запустите проект (⌘+R).