Maps Android KTX

Maps Android KTX ist eine Sammlung von Kotlin-Erweiterungen für das Maps SDK for Android und die entsprechende 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 Zuweisungen 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-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 Features finden Sie in der Referenzdokumentation.