Android SDK Обзор | 2GIS Documentation
Android SDK

Android SDK

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

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

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

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

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

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

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

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

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

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

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

  1. Укажите пользовательский репозиторий в вашем файле build.gradle.
repositories {
    maven {
        url "https://artifactory.2gis.dev/sdk-maven-release"
    }
}
  1. Добавьте одну из следующих зависимостей.

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

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

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

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

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