Flutter SDK

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

Примеры использования SDK см. в разделе Примеры.

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

Получение ключей доступа

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

Чтобы получить файл ключа:

Заполните форму на dev.2gis.ru.
Добавьте полученный файл ключа в assets приложения.

После активации ключа вы можете зарегистрироваться в личном кабинете Менеджер Платформы и просматривать статистику распределения запросов.

Версии SDK

Пакеты Flutter SDK доступны в pub.dev в двух версиях:

Full — полная версия, которая позволяет:
- Добавлять карту в приложение и управлять ей: добавлять маркеры и геометрические фигуры, управлять движением камеры, отображать слои (например, пробки), работать со стилями карты и т. д.
- Искать объекты в справочнике: организации, здания, места и другие.
- Работать с навигатором в приложении в трёх режимах: свободная навигация, ведение по маршруту и симуляция ведения.
- Строить оптимальные маршруты на карте, в том числе внутри зданий.
- Использовать офлайн-данные.
Map — облегчённая версия, которая позволяет:
- Добавлять карту в приложение и управлять ей: добавлять маркеры и геометрические фигуры, управлять движением камеры, отображать слои (например, пробки), работать со стилями карты и т. д.
- Искать объекты в справочнике: организации, здания, места и другие.

Важно

Использовать совместно Full и Map нельзя: это приведёт к ошибке сборки.

Установка

Android

При сборке под Android используется бинарный артефакт в формате .aar. Для правильного подключения необходимо добавить репозиторий с этим артефактом в build.gradle вашего приложения:

repositories {
    maven {
        url "https://artifactory.2gis.dev/sdk-maven-release"
    }
}