Обзор
Введение
Android MapGL SDK от 2GIS позволяет добавить карту 2GIS в ваше приложение под Android. С его помощью вы можете отображать карту на экране, добавлять на карту пользовательские маркеры, а также выделять на карте различные объекты, такие как здания, дороги и т. д.
Для рендера карты этот SDK использует Android WebView. Если вам нужно более нативное решение, например, если вы не хотите отображать веб-контент внутри вашего приложения или если вам нужно поддерживать старые версии Android, обратите внимание на Android Native SDK
.
Получение ключа доступа
Чтобы использовать этот SDK, необходим ключ API для подключения к серверам 2GIS и получения географических данных. Этот ключ доступа API уникален для конкретного SDK и не может быть использован с другими SDK от 2GIS.
Кроме того, если вы планируете прокладывать маршруты на карте, то для вычисления и отображения оптимального маршрута вам понадобится отдельный ключ API - для Directions API.
Чтобы получить любой из этих ключей API, заполните форму на dev.2gis.ru.
Установка
Для установки SDK:
- Укажите пользовательский репозиторий в вашем файле build.gradle:
repositories {
maven {
url "https://artifactory.2gis.dev/sdk-maven-release"
}
}
- Добавьте зависимость:
dependencies {
implementation 'ru.dublgis.dgismobile.mapsdk:mapsdk:latest.release'
}
После этого всё должно быть готово к работе. В разделе Примеры вы можете посмотреть, как добавить карту к вашему приложению. Или загляните в описание API, чтобы узнать больше о конкретных классах и методах.
Также доступен GitHub-репозиторий, в котором можно познакомиться с SDK и демонстрационным проектом.
Лицензия
2GIS Android MapGL распространяется под упрощённой лицензией BSD 2-Clause. Дополнительную информацию можно найти в файле LICENSE.