Mapy na Androida KTX

Rozszerzenia Maps Android Kotlin (KTX) to zbiór rozszerzeń Kotlin dla pakietu Maps SDK na Androida i bibliotekę narzędzi pakietu Maps SDK na Androida. Te rozszerzenia zapewniają Funkcje językowe w języku Kotlin umożliwiają zwięzłe i idiomatyczne pisanie w języku Kotlin. przy tworzeniu pakietu SDK Map Google na Androida. Mapy KTX to oprogramowanie open source dostępne w GitHub wraz z przykłady.

Instalacja

Aby zainstalować KTX dla pakietu Maps SDK na Androida i opcjonalnie dla Maps SDK na Biblioteka narzędzi na Androida, dodaj do build.gradle te zależności .

dependencies {

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

Przykładowe zastosowania

Dzięki bibliotece KTX możesz posługiwać się kilkoma językami Kotlina, takie jak funkcje rozszerzeń, parametry nazwane i argumenty domyślne, destrukcyjne deklaracje i współrzędne.

Pobieranie mapy Google przy użyciu współrzędnych

Dostęp do elementu GoogleMap można przywrócić przy użyciu współrzędnych.

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

Rejestrowanie zdarzeń kamery

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 referencyjnej.

Wypróbuj przykładową aplikację

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

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

1. Skopiuj lub pobierz plik ZIP z GitHub.
2. W Android Studio wybierz kolejno Plik -> Otwórz, przejdź do katalogu i otwórz folder, który został przed chwilą sklonowany lub pobrany.
3. Dodaj klucz interfejsu API do aplikacji w wersji demonstracyjnej.
1. Pobierz 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 pola secrets.properties
   

   MAPS_API_KEY="YOUR_API_KEY"

   gdzie YOUR_API_KEY to rzeczywisty klucz interfejsu API uzyskany w pierwszym kroku. Zerknij na secrets.defaults.properties .
4. W konfiguracji uruchamiania wybierz moduł app-ktx.
5. Kliknij Uruchom aplikację „app-ktx”.

Co dalej?

Być może zainteresują Cię również inne biblioteki rozszerzeń Kotlin do Map Google Platforma:

• KTX dla pakietu Map SDK: Biblioteka narzędzi do Androida
• KTX dla pakietu Places SDK na Androida