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

Places Android KTX — это набор расширений Kotlin для SDK Places для Android. Эти расширения предоставляют возможности языка Kotlin, позволяющие писать лаконичные и идиоматические коды Kotlin при разработке для SDK Places для 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. С GitHub клонируйте репозиторий или скачайте ZIP-файл.
  2. В Android Studio выберите File -> Open , перейдите в каталог и откройте папку, которую вы только что клонировали или скачали.
  3. Добавьте ключ API в демонстрационное приложение.
    1. Получите ключ API Places .
    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. Выберите «Выполнить» 'app-places-ktx'.