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 korzystających z pakietu Places SDK na Androida. Biblioteka Places KTX jest dostępna na licencji open source 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ę

W repozytorium GitHub tej biblioteki znajduje się też aplikacja demonstracyjna, 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ą, wykonaj te czynności:

  1. Sklonuj lub pobierz plik ZIP z GitHub.
  2. W Android Studio wybierz File -> Open (Plik –> Otwórz) i przejdź do katalogu, a następnie otwórz folder, który został przed chwilą sklonowany lub pobrany.
  3. Dodaj klucz interfejsu API do aplikacji w wersji 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 zapoznać się z local.defaults.properties.
  4. W konfiguracji uruchomienia wybierz moduł app-places-ktx.
  5. Wybierz Uruchom „app-places-ktx”.