Настройка библиотеки утилит Maps SDK для Android

В этой статье рассказывается, как настроить библиотеку утилит Maps SDK для Android и как запустить демонстрационное приложение, включенное в эту библиотеку.

Требования и примечания

Библиотека утилит Maps SDK для Android поддерживает уровни Android API 15 и выше. В качестве целевой версии API для сборки своего проекта всегда выбирайте Android API самого последнего уровня.

Справочная документация доступна на сайте GitHub.

Шаг 1. Установите библиотеку утилит Maps SDK для Android

Добавьте в файл build.gradle своего приложения следующую зависимость:

dependencies {
    implementation 'com.google.maps.android:android-maps-utils:2.2.3'
}

Укажите одну из утилит библиотеки, например для кластеризации маркеров, создания тепловых карт или из прочих утилит.

Шаг 2. Необязательно: установите библиотеку утилит KTX Maps SDK для Android

Для библиотеки Maps SDK для Android доступна библиотека расширений Kotlin (KTX). В ней реализованы функции языка Kotlin (например, функции-расширения, именованные и стандартные аргументы), позволяющие создавать лаконичный и идиоматичный код Kotlin. Если вы не используете язык Kotlin при разработке, этот шаг можно пропустить.

Чтобы воспользоваться этой библиотекой, добавьте в файл build.gradle своего приложения следующую зависимость (помимо зависимости android-maps-utils):

dependencies {
    implementation 'com.google.maps.android:maps-utils-ktx:3.2.0'
}

Дополнительная информация приведена на странице сайта GitHub о библиотеке Maps KTX.

Шаг 3. Просмотрите исходный код библиотеки утилит Maps SDK для Android

Поскольку библиотека утилит является ПО с открытым исходным кодом, вы можете скачать код android-maps-utils, чтобы изменить его, просмотреть демонстрационное приложение или просто понять, как работает библиотека. Для этого либо клонируйте репозиторий (рекомендуется, чтобы получать автоматические обновления), либо скачайте ZIP-файл. Если вы хотите изменить код библиотеки, создайте ответвление репозитория.

В репозитории содержатся следующие компоненты:

  • Демонстрационное приложение в каталоге demo.
  • Библиотека утилит в каталоге library.
  • Библиотека утилит для Maps SDK для версии 3 (БЕТА) в каталоге library-v3.
  • Различные файлы с информацией о лицензировании, списками соавторов и примечаниями.
  • Конфигурация сборки Gradle для использования с Android Studio.

Как запустить демонстрационное приложение

Репозиторий библиотеки утилит на GitHub содержит демонстрационное приложение с примером реализации для каждой утилиты. Чтобы запустить демонстрационное приложение на устройстве Android, выполните следующие действия:

  1. Скачайте репозиторий любым из указанных выше способов.
  2. В Android Studio выберите Файл > Создать > Импортировать проект.
  3. Найдите каталог android-maps-utils, созданный при клонировании библиотеки утилит, и выберите его двойным кликом. Теперь Android Studio создаст проект.
  4. Если вы используете устройство Android, а не эмулятор, включите режим разработчика. Затем подключите это устройство к компьютеру.
  5. Выполните сборку и запуск демонстрационного приложения.

Приложение должно запуститься на устройстве Android и вывести список утилит, в том числе clustering, polyutil, heatmap и пр. Приложение также можно найти в списке приложений (оно будет иметь название Maps Utils Demo).