Android SDK

Android SDK позволяет добавить карту 2GIS в ваше Android-приложение. С помощью этого 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.

Полученный файл ключа нужно добавить в 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-репозитории.