Обзор и настройка Places Android KTX

Places Android KTX – это набор расширений Kotlin для Places SDK для Android. Эти расширения предоставляют функции языка Kotlin, которые позволяют создавать лаконичный и идиоматичный код при разработке для Places SDK для Android. Places KTX – это ПО с открытым кодом. Вы можете скачать его вместе с примерами на сайте GitHub.

Как установить KTX для Places SDK

Чтобы установить KTX для Places SDK для Android, добавьте в файл build.gradle.kts на уровне приложения следующие зависимости:

dependencies {

    // Modern Android projects use version catalogs to manage dependencies. To include the Places SDK for Android,
    // first add the following to your gradle/libs.versions.toml file:
    //
    // [versions]
    // places = "5.3.0"
    //
    // [libraries]
    // places = { group = "com.google.android.libraries.places", name = "places", version.ref = "places" }
    //
    // Places SDK for Android (Kotlin extensions and coroutines are built directly into the Places SDK)
    implementation(libs.places)

    // If your project does not use a version catalog, you can use the following dependency instead:
    //
    //    implementation("com.google.android.libraries.places:places:5.3.0")
}

Образец приложения

В хранилище на GitHub для этой библиотеки также есть демонстрационное приложение. Вы можете посмотреть, как именно используется Places KTX.

Первый экран примера приложения Places KTX с доступными вариантами
Экран демонстрационного приложения "Поиск мест"

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

  1. Клонируйте или скачайте ZIP-файл с GitHub.
  2. В Android Studio нажмите File (Файл) > Open (Открыть), перейдите в нужный каталог и откройте папку, которую клонировали или скачали.
  3. Добавьте в демонстрационное приложение ключ API.
    1. Получите ключ Places API.
    2. В корневом каталоге создайте файл с названием secrets.properties. Чтобы защитить ваш ключ API, этот файл НЕ ДОЛЖЕН храниться в системе контроля версий.
    3. Добавьте в объект secrets.properties
      следующую строку: 
      PLACES_API_KEY="YOUR_API_KEY"
       Вместо YOUR_API_KEY укажите ключ API, который вы получили на первом шаге. Пример можно найти здесь: local.defaults.properties.
  4. В режиме конфигурации запуска выберите модуль app-places-ktx.
  5. Выберите Run 'app-places-ktx' (Запуск app-places-ktx).