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

Выберите платформу: Android iOS

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

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

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

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

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

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

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation 'com.google.maps.android:android-maps-utils:3.8.0'
}

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

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

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

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

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.1.1'
}

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

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

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

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

  • Демонстрационное приложение в каталоге demo.
  • Библиотека утилит в каталоге library.
  • Файлы с информацией о лицензировании и соавторах и примечаниями.
  • Конфигурация сборки Gradle для использования с Android Studio.

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

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

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

  5. Добавьте в объект local.properties следующую строку:

    MAPS_API_KEY=YOUR_API_KEY

    Здесь переменная YOUR_API_KEY задает ключ API (как получить его читайте в статье Использование ключей API).

  6. Выполните сборку и запуск демонстрационного приложения.

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