Mapy na Androida KTX

Rozszerzenia Kotlina na Androida (KTX) to zbiór rozszerzeń Kotlina do pakietu Maps SDK na Androida i do biblioteki narzędziowej Maps SDK na Androida. Te rozszerzenia udostępniają funkcje w języku Kotlin, które pozwalają pisać zwięzłe i idiomatyczne teksty w Kotlin podczas programowania na pakiet SDK Map Google na Androida. KTX Maps jest dostępny w wersji open source i znajdziesz go na GitHubie wraz z przykładami.

Instalacja

Aby zainstalować KTX dla pakietu Maps SDK na Androida i opcjonalnie z biblioteki narzędziowej pakietu Maps SDK na Androida, dodaj poniższe zależności do pliku build.gradle.kts.

dependencies {

    // KTX for the Maps SDK for Android library
    implementation("com.google.maps.android:maps-ktx:5.1.1")
}

Przykłady użycia

Dzięki bibliotece KTX możesz korzystać z kilku funkcji języka Kotlin, takich jak funkcje rozszerzeń, parametry nazwane i domyślne, deklaracje destrukturyzujące i koroboty.

Pobieranie mapy Google za pomocą coroutine

Dostęp do GoogleMap można uzyskać za pomocą coroutines.

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    val mapFragment: SupportMapFragment? =
      supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
    val googleMap: GoogleMap? = mapFragment?.awaitMap()
  }
}

Dodawanie znacznika

Znaczniki można dodawać za pomocą metody addMarker() (czyli stylu DSL).

val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
  position(sydney)
  title("Marker in Sydney")
}

Zbieranie zdarzeń dotyczących kamer

Zdarzenia, takie jak ruchy kamery, można rejestrować za pomocą narzędzia Kotlin Flow.

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    googleMap.cameraMoveEvents().collect {
      print("Received camera move event")
    }
  }
}

Pełną listę obsługiwanych funkcji znajdziesz w dokumentacji.

Wypróbuj przykładową aplikację

Repozytorium GitHub tej biblioteki zawiera też aplikację demonstracyjną, która pokazuje, jak korzystać z biblioteki Maps KTX w własnej aplikacji.

Aby wypróbować aplikację demonstracyjną, wykonaj te czynności:

  1. Na GitHub sklonuj lub pobierz plik ZIP.
  2. W Android Studio wybierz Plik -> Otwórz, przejdź do katalogu i otwórz nowo sklonowany lub pobrany folder.
  3. Dodaj klucz interfejsu API do aplikacji w wersji demonstracyjnej.
    1. Uzyskaj klucz Maps SDK na Androida
    2. W katalogu głównym utwórz plik o nazwie secrets.properties. Aby chronić klucz interfejsu API, ten plik NIE powinien podlegać kontroli wersji.
    3. Dodaj ten pojedynczy wiersz do pliku secrets.properties
      MAPS_API_KEY="YOUR_API_KEY"
      gdzie YOUR_API_KEY to rzeczywisty klucz interfejsu API uzyskany w pierwszym kroku. Przykładem może być żądanie secrets.defaults.properties.
  4. W sekcji Konfiguracja uruchomienia wybierz moduł app-ktx.
  5. Kliknij Uruchom „app-ktx”.

Co dalej?

Możesz też zainteresować się innymi bibliotekami rozszerzeń Kotlina do platformy Mapy Google:

  • KTX w przypadku pakietu SDK Map na potrzeby biblioteki narzędziowej na Androida.
  • KTX dla pakietu Places SDK na Androida.