Android KTX – omówienie i konfiguracja miejsc

Places Android KTX to zbiór rozszerzeń Kotlin dla pakietu SDK Miejsc na Androida. Te rozszerzenia udostępniają funkcje języka Kotlin, które umożliwiają pisanie zwięzłego i idiomatycznego kodu Kotlin podczas tworzenia aplikacji na podstawie pakietu SDK Miejsc na Androida. Places KTX jest rozwiązaniem typu open source i jest dostępne w GitHub wraz z przykładami.

Instalowanie KTX dla pakietu SDK Miejsc

Aby zainstalować KTX dla pakietu SDK Miejsc na Androida, dodaj te zależności do pliku build.gradle.kts na poziomie aplikacji.

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")
}

Wypróbuj przykładową aplikację

Repozytorium GitHub tej biblioteki zawiera też aplikację demonstracyjną , która pokazuje, jak używać biblioteki Places KTX we własnej aplikacji.

Pierwszy ekran przykładowej aplikacji Places KTX z wybranymi opcjami
Ekran aplikacji demonstracyjnej wyszukiwania miejsc

Aby wypróbować aplikację demonstracyjną:

  1. Sklonuj repozytorium z GitHub, lub pobierz plik ZIP.
  2. W Android Studio wybierz Plik > Otwórz i przejdź do katalogu, a następnie otwórz folder, który został sklonowany lub pobrany.
  3. Dodaj klucz interfejsu API do aplikacji demonstracyjnej.
    1. Uzyskaj klucz interfejsu Places API.
    2. W katalogu głównym utwórz plik o nazwie secrets.properties. Aby chronić klucz interfejsu API, ten plik NIE powinien być objęty kontrolą wersji.
    3. Dodaj ten wiersz do pliku secrets.properties
      PLACES_API_KEY="YOUR_API_KEY"
       gdzie YOUR_API_KEY to rzeczywisty klucz interfejsu API uzyskany w pierwszym kroku. Możesz na przykład sprawdzić plik local.defaults.properties.
  4. W konfiguracji uruchomienia wybierz moduł app-places-ktx.
  5. Kliknij Uruchom „app-places-ktx”.