Maps Android KTX ist eine Sammlung von Kotlin-Erweiterungen für das Maps SDK for Android und die zugehörige Dienstprogrammbibliothek. Mit den Kotlin-Sprachfunktionen dieser Erweiterungen können Sie bei der Entwicklung für das Maps SDK for Android prägnanten und idiomatischen Kotlin-Code schreiben. Maps KTX ist eine Open-Source-Bibliothek und mit entsprechenden Beispielen auf GitHub verfügbar.
Installation
Fügen Sie die folgenden Abhängigkeiten in Ihre build.gradle
-Datei ein, um KTX für die Maps SDK for Android-Dienstprogrammbibliothek zu installieren:
dependencies {
// KTX for the Maps SDK for Android
implementation 'com.google.maps.android:maps-ktx:3.2.1'
// (Optional) KTX for the Maps SDK for Android Utility Library
implementation 'com.google.maps.android:maps-utils-ktx:3.2.1'
}
Beispiele für die Nutzung
Die KTX-Bibliothek bietet verschiedene Kotlin-Sprachfunktionen wie Erweiterungsfunktionen, benannte Parameter, Standardargumente, destrukturierende Deklarationen und Koroutinen.
GoogleMap-Objekt mithilfe von Koroutinen abrufen
Ein GoogleMap
-Objekt kann mithilfe von Koroutinen abgerufen werden.
lifecycleScope.launchWhenCreated { val mapFragment: SupportMapFragment? = supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment val googleMap: GoogleMap? = mapFragment?.awaitMap() }
Markierung hinzufügen
Markierungen lassen sich mithilfe der DSL-Stil-Methode addMarker()
hinzufügen.
val sydney = LatLng(-33.852, 151.211) val marker = googleMap.addMarker { position(sydney) title("Marker in Sydney") }
Kamera-Ereignisse erfassen
Ereignisse wie Kamerabewegungen können über einen Kotlin-Ablauf erfasst werden.
lifecycleScope.launchWhenCreated { googleMap.cameraMoveEvents().collect { print("Received camera move event") } }
Eine vollständige Liste der unterstützten Funktionen finden Sie in der Referenzdokumentation.