Maps SDK for Android-Dienstprogramm einrichten

Plattform auswählen: Android iOS

Auf dieser Seite wird beschrieben, wie die Google Maps SDK for Android-Dienstprogrammbibliothek eingerichtet und die darin enthaltene Demo-App ausgeführt wird.

Voraussetzungen und Hinweise

Die Maps SDK for Android-Dienstprogrammbibliothek unterstützt Android API-Level 15 und höher. Achten Sie beim Einrichten des gewünschten Projektbuilds darauf, dass Sie das neueste Android API-Level verwenden.

Die Referenzdokumentation ist auf GitHub verfügbar.

Schritt 1: Maps SDK for Android-Dienstprogrammbibliothek installieren

Fügen Sie der Datei build.gradle Ihrer App die folgende Abhängigkeit hinzu:

dependencies {
    implementation 'com.google.maps.android:android-maps-utils:2.3.0'

}

Verwenden Sie eines der Dienstprogramme aus der Bibliothek, z. B. das Markierungs-Clustering-Dienstprogramm, das Heatmap-Dienstprogramm oder ein anderes Dienstprogramm.

Schritt 2: Optional: Maps for Android-Dienstprogrammbibliothek „KTX“ installieren

Die Maps SDK for Android-Dienstprogrammbibliothek enthält eine entsprechende Bibliothek mit Kotlin-Erweiterungen (KTX). Diese Bibliothek bietet Kotlin-Sprachfunktionen wie Erweiterungsfunktionen sowie benannte und Standardargumente. Damit können Sie prägnanten und idiomatischen Kotlin-Code schreiben. Falls Sie nicht in Kotlin entwickeln, können Sie diesen Schritt überspringen.

Wenn Sie diese Bibliothek verwenden möchten, fügen Sie der Datei build.gradle Ihrer App zusätzlich zur android-maps-utils-Abhängigkeit die folgende hinzu:

dependencies {
    implementation 'com.google.maps.android:maps-utils-ktx:3.4.0'
}

Weitere Informationen zu dieser Bibliothek finden Sie auf der GitHub-Seite zu Maps KTX.

Schritt 3: Quellcode der Maps SDK for Android-Dienstprogrammbibliothek ansehen

Die Dienstprogrammbibliothek ist als Open Source verfügbar. Deshalb können Sie die Bibliothek android-maps-utils auf Ihren Computer herunterladen, um sie anzupassen, die Demo-App anzusehen oder einfach nur zu verstehen, wie die Bibliothek funktioniert. Entweder klonen Sie dazu das Repository (empfohlen, um automatische Updates zu erhalten) oder laden Sie eine ZIP-Datei herunter. Wenn Sie die Bibliothek anpassen möchten, sollten Sie das Repository verzweigen.

Das Repository enthält Folgendes:

  • Eine Demo-App im Verzeichnis demo.
  • Die Dienstprogrammbibliothek im Verzeichnis library.
  • Die Dienstprogrammbibliothek für die Betaversion 3 des Maps SDK im Verzeichnis library-v3.
  • Verschiedene Dateien mit Lizenz, Mitwirkenden und Readme-Informationen.
  • Gradle-Build-Konfiguration für die Verwendung mit Android Studio.

Demo-App der Dienstprogrammbibliothek ausführen

Das GitHub-Repository für die Dienstprogrammbibliothek wird mit einer Demo-App ausgeliefert, die Beispielimplementierungen für jedes Dienstprogramm enthält. So führen Sie die Demo-App auf Ihrem Android-Gerät aus:

  1. Laden Sie das Repository mit einer der oben genannten Optionen herunter.
  2. Wählen Sie in Android Studio File > New > Import Project aus.
  3. Wechseln Sie zum Verzeichnis android-maps-utils, das beim Klonen der Dienstprogrammbibliothek erstellt wurde, und wählen Sie es durch Doppelklicken aus. In Android Studio wird jetzt Ihr Projekt erstellt.
  4. Wenn Sie ein Android-Gerät anstelle eines Emulators verwenden, aktivieren Sie den Entwicklermodus. Verbinden Sie dann das Android-Gerät mit Ihrem Computer.
  5. Fügen Sie local.properties eine einzelne Zeile hinzu, die so aussieht:

    MAPS_API_KEY=YOUR_API_KEY

    Dabei ist YOUR_API_KEY der API-Schlüssel, den Sie wie unter API-Schlüssel verwenden beschrieben abgerufen haben.

  6. Erstellen Sie die Demo-App und führen Sie sie aus.

Die App sollte auf dem Android-Gerät ausgeführt werden und eine Liste der Dienstprogramme enthalten, darunter Clustering, PolyUtil, Heatmap usw. Sie finden die App auch in der App-Liste unter dem Namen Maps Utils Demo.