Android KTX – omówienie i konfiguracja miejsc

Places Android KTX to kolekcja 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 w tym języku podczas tworzenia aplikacji na pakiet SDK Miejsc na Androida. Biblioteka Places KTX jest dostępna jako open source na GitHub wraz z przykładami.

Instalowanie KTX dla pakietu SDK Miejsc

Aby zainstalować KTX dla pakietu Places SDK for Android, 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 dostępnymi 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 Plik -> Otwórz, przejdź do katalogu i 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 pojedynczy 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 uruchamiania wybierz moduł app-places-ktx.
  5. Kliknij Run 'app-places-ktx' (Uruchom „app-places-ktx”).