Android SDK

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

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

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

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

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

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

Полученный файл ключа нужно добавить в assets приложения.

Установка

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

Для установки SDK:

Укажите пользовательский репозиторий в вашем файле build.gradle.

repositories {
    maven {
        url "https://artifactory.2gis.dev/sdk-maven-release"
    }
}

Добавьте одну из следующих зависимостей.

Для получения облегченной версии SDK:

dependencies {
    implementation 'ru.dgis.sdk:sdk-map:latest.release'
}

Для получения полной версии SDK:

dependencies {
    implementation 'ru.dgis.sdk:sdk-full:latest.release'
}

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

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