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.kts
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:
- Skopiuj lub pobierz plik ZIP z GitHub.
- W Android Studio wybierz kolejno Plik -> Otwórz, przejdź do katalogu i otwórz folder, który został przed chwilą sklonowany lub pobrany.
- Dodaj klucz interfejsu API do aplikacji w wersji demonstracyjnej.
- Pobierz klucz Maps SDK na Androida.
- W katalogu głównym utwórz plik o nazwie
secrets.properties
. Aby chronić klucz interfejsu API, ten plik NIE powinien podlegać kontroli wersji. - Dodaj ten pojedynczy wiersz do pola
secrets.properties
gdzieMAPS_API_KEY="YOUR_API_KEY"
YOUR_API_KEY
to rzeczywisty klucz interfejsu API uzyskany w pierwszym kroku. Zerknij nasecrets.defaults.properties
. - W konfiguracji uruchamiania wybierz moduł app-ktx.
- Kliknij Uruchom aplikację „app-ktx”.
Co dalej?
Być może zainteresują Cię również inne biblioteki rozszerzeń Kotlin do Map Google Platforma: