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-репозитории.