Maps Android KTX

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 library
    implementation 'com.google.maps.android:maps-ktx:5.0.0'
}

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.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    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.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    googleMap.cameraMoveEvents().collect {
      print("Received camera move event")
    }
  }
}

Eine vollständige Liste der unterstützten Funktionen finden Sie in der Referenzdokumentation.

Beispiel-App ausprobieren

Das GitHub-Repository für diese Bibliothek enthält auch eine Demo-App, die zeigt, wie Sie die Maps KTX-Bibliothek in Ihrer App verwenden können.

Gehen Sie folgendermaßen vor, um die Demo-App auszuprobieren:

  1. Klonen Sie die ZIP-Datei aus GitHub oder laden Sie sie herunter.
  2. Wählen Sie in Android Studio File (Datei) -> Open (Öffnen) aus und öffnen Sie im Verzeichnis den Ordner, den Sie gerade geklont oder heruntergeladen haben.
  3. Fügen Sie der Demo-App einen API-Schlüssel hinzu.
    1. Fordern Sie einen Schlüssel für das Maps SDK for Android an.
    2. Erstellen Sie im Stammverzeichnis eine Datei mit dem Namen secrets.properties. Zum Schutz Ihres API-Schlüssels sollte diese Datei NICHT der Versionsverwaltung unterliegen.
    3. Fügen Sie in secrets.properties diese Zeile ein:
      MAPS_API_KEY="YOUR_API_KEY"
      Dabei ist YOUR_API_KEY der API-Schlüssel, den Sie im ersten Schritt erhalten haben. Sie können sich secrets.defaults.properties als Beispiel ansehen.
  4. Wählen Sie unter der Ausführungskonfiguration das Modul app-ktx aus.
  5. Wählen Sie Run 'app-ktx' ('app-ktx' ausführen) aus.

Weiteres Vorgehen

Diese Kotlin-Erweiterungsbibliotheken für die Google Maps Platform könnten ebenfalls interessant für Sie sein: