Обзор

Введение

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.