Einrichtung

Auf dieser Seite wird beschrieben, was Sie tun müssen, um mit dem Maps 3D SDK for Android zu entwickeln. Dazu müssen Sie ein Google Cloud-Projekt und eine API für die Verwendung mit dem SDK konfigurieren und dann ein Android Studio-Projekt einrichten. Führen Sie diese Schritte aus, bevor Sie Ihrer App die erste 3D-Karte hinzufügen.

Vorbereitung

Wenn Sie das Maps 3D SDK for Android verwenden möchten, müssen Ihr Projekt und Ihre Zielgeräte die folgenden Anforderungen erfüllen:

  • Mindest-API-Level: Android API-Level 24 (Android 7.0) oder höher. Ihre App muss auf eine minSdk von 24 oder höher ausgerichtet sein.
  • Google Play-Dienste: Das Maps 3D SDK for Android ist von den Google Play-Diensten abhängig. Auf Zielgeräten (und Emulatoren mit Google APIs) müssen die Google Play-Dienste installiert sein.

Google Cloud-Projekt und API-Schlüssel einrichten

Bevor Sie mit dem Maps 3D SDK for Android entwickeln können, müssen Sie ein Google Cloud-Projekt und einen API-Schlüssel für die Verwendung mit dem Maps 3D SDK for Android einrichten. Gehen Sie dazu so vor:

Schritt 1

Console

  1. Klicken Sie in der Google Cloud Console auf der Seite für die Projektauswahl auf Projekt erstellen, um ein neues Cloud-Projekt einzurichten.

    Zur Projektauswahl

  2. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. Das können Sie hier überprüfen.

    Google Cloud bietet einen kostenlosen Testzeitraum. Dieser endet entweder nach 90 Tagen oder wenn im Konto Kosten in Höhe von 300 $ angefallen sind – je nachdem, welcher Fall zuerst eintritt. Eine Kündigung ist jederzeit möglich. Weitere Informationen finden Sie unter Guthaben auf dem Rechnungskonto und Abrechnung.

Cloud SDK

gcloud projects create "PROJECT"

Weitere Informationen zum Google Cloud SDK, zur Cloud SDK-Installation und zu folgenden Befehlen:

Schritt 2

Damit Sie die Google Maps Platform verwenden können, müssen Sie die APIs und SDKs aktivieren, die Sie in Ihrem Projekt nutzen möchten.

Bei einigen Integrationen musst du mehrere APIs und SDKs aktivieren. Wenn Sie sich nicht sicher sind, welche APIs oder SDKs Sie aktivieren sollen, können Sie den Capabilities Explorer oder die Dokumentation für die API bzw. das SDK zurate ziehen.

So aktivieren Sie eine oder mehrere APIs oder SDKs:

Console

  1. Welche APIs und SDKs der Google Maps Platform zur Verfügung stehen, sehen Sie auf der Seite der Google Maps-API-Bibliothek in der Cloud Console:

    Zur Maps API-Bibliothek

  2. Klicken Sie auf die API oder das SDK, das Sie aktivieren möchten.
    • Wenn der Button AKTIVIEREN angezeigt wird, kannst du die API oder das SDK mit einem Klick darauf aktivieren.
    • Ist hingegen der Button VERWALTEN zu sehen, bedeutet das, dass die API oder das SDK bereits aktiviert ist und Sie nichts weiter tun müssen.
    • Wenn Sie auf einen dieser beiden Buttons klicken, wird das Dashboard für die API oder das SDK angezeigt. Falls Sie die API oder das SDK aus dem Projekt entfernen möchten, klicken Sie auf DEAKTIVIEREN.

Cloud SDK

Mit dem folgenden Befehl werden alle Maps, Routes und Places APIs aktiviert:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Weitere Informationen zum Google Cloud SDK, zur Cloud SDK-Installation und zu folgenden Befehlen:

Verwenden Sie diesen Befehl, um die Environment APIs zu aktivieren:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

Schritt 3

Dieser Schritt behandelt nur die Erstellung des API-Schlüssels. Wenn Sie Ihren API-Schlüssel in der Produktionsumgebung verwenden, sollten Sie ihn außerdem unbedingt einschränken. Weitere Informationen zur Vorgehensweise finden Sie auf der Seite API-Schlüssel verwenden.

Der API-Schlüssel ist eine eindeutige Kennung. Damit werden die mit Ihrem Projekt verknüpften Anfragen zu Nutzungs- und Abrechnungszwecken authentifiziert. Mit Ihrem Projekt muss mindestens ein API-Schlüssel verknüpft sein.

So erstellen Sie einen API-Schlüssel:

Cloud Console

  1. Rufen Sie die Seite Google Maps Platform > Anmeldedaten auf.

    Zur Seite „Anmeldedaten“

  2. Klicken Sie auf der Seite Anmeldedaten auf Anmeldedaten erstellen > API-Schlüssel.
    Im Dialogfeld API-Schlüssel erstellt wird der neu erstellte API-Schlüssel angezeigt.
  3. Klicken Sie auf Schließen.
    Der neue API-Schlüssel wird auf der Seite Anmeldedaten unter API-Schlüssel aufgeführt.
    Es empfiehlt sich, den API-Schlüssel einzuschränken, bevor Sie ihn in der Produktionsumgebung verwenden.

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Weitere Informationen zum Google Cloud SDK, zur Cloud SDK-Installation und zu folgenden Befehlen:

Informationen zum Aktivieren des SDK finden Sie in der Google Cloud Console auf der Seite Maps 3D SDK for Android. Weitere Informationen zu diesen Schritten finden Sie unter Erste Schritte mit der Google Maps Platform.

Android Studio-Projekt einrichten

In diesem Abschnitt wird erläutert, wie Sie ein Android Studio-Projekt für die Verwendung mit dem Maps 3D SDK for Android erstellen und konfigurieren.

Teil 1: Projekt und Gradle-Konfiguration einrichten

  1. Erstellen Sie ein neues Android Studio-Projekt mit der Vorlage Empty Views Activity. Legen Sie in der Projektkonfiguration für Minimum SDK (Mindest-SDK) die Option API 24 oder höher fest.

  2. Wenn Sie Git für die Versionsverwaltung verwenden, ändern Sie die Datei .gitignore des Projekts, um zu verhindern, dass die Datei mit den Secrets in die Versionsverwaltung übernommen wird:

    • Öffnen Sie im Stammverzeichnis Ihres Projekts die Datei .gitignore.
    • Fügen Sie folgende Zeile hinzu:
    secrets.properties

  3. Aktualisieren Sie die Datei build.gradle.kts auf Projektebene:

    • Öffnen Sie im Stammverzeichnis Ihres Projekts die Datei build.gradle.kts.
    • Fügen Sie im Block plugins das Secrets Gradle-Plug-in hinzu:
    plugins {
  alias(libs.plugins.android.application) apply false
  alias(libs.plugins.kotlin.android) apply false
  alias(libs.plugins.secrets.gradle.plugin) apply false // Add this line
}

  4. Aktualisieren Sie die Datei gradle/libs.versions.toml:

    • Öffnen Sie die Datei gradle/libs.versions.toml, die sich normalerweise im Verzeichnis gradle im Stammverzeichnis des Projekts befindet.
    • Fügen Sie im Abschnitt [versions] die Versionen für das SDK und das Secrets Gradle-Plug-in hinzu:
    # See https://developers.google.com/android/guides/setup?device=phone-tablet for available releases
maps3dSdk = "16.0.1"
# See https://github.com/google/secrets-gradle-plugin/releases for available releases
secretsGradlePlugin = "2.0.1"
    • Fügen Sie im Abschnitt [library] die SDK-Bibliothek hinzu:
    play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }
    • Fügen Sie im Abschnitt [plugins] das Secrets Gradle-Plug-in hinzu:
    secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }

  5. Aktualisieren Sie die Datei app/build.gradle.kts auf Modulebene:

    • Öffnen Sie die Datei build.gradle.kts auf Modulebene, die sich normalerweise im Verzeichnis app befindet.
    • Fügen Sie oben in der Datei das Secrets Gradle-Plug-in zum Block plugins hinzu:
    plugins {
    alias(libs.plugins.android.application)
    alias(libs.plugins.kotlin.android)
    alias(libs.plugins.secrets.gradle.plugin) // Add this line
}
    • Fügen Sie im Block dependencies die Abhängigkeit für Google Play-Dienste für das Maps 3D SDK for Android hinzu:
    dependencies {
    // ... other dependencies
    implementation(libs.play.services.maps3d) // Add this line
}
    • Fügen Sie am Ende der Datei, außerhalb der Blöcke android und dependencies, die Secrets-Konfiguration hinzu:
    secrets {
    // Optionally specify a different filename containing your secrets.
    // The plugin defaults to "local.properties"
    propertiesFileName = "secrets.properties"

    // A properties file containing default secret values. This file can be
    // checked in version control.
    defaultPropertiesFileName = "local.defaults.properties"
}

Teil 2: API-Schlüssel zum Projekt hinzufügen

  1. secrets.properties-Datei erstellen:

    • Erstellen Sie im Stammverzeichnis des App-Moduls (normalerweise das Verzeichnis app) eine neue Datei mit dem Namen secrets.properties.
    • Fügen Sie der Datei Ihren API-Schlüssel hinzu:
    MAPS3D_API_KEY=YOUR_API_KEY_HERE

  2. Erstellen Sie eine local.defaults.properties-Datei: - Erstellen Sie im Stammverzeichnis des App-Moduls eine neue Datei mit dem Namen local.defaults.properties. - Fügen Sie der Datei einen Standard- oder Platzhalter-API-Schlüssel hinzu. Diese Datei kann in die Versionsverwaltung eingecheckt werden:

    MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER

Teil 3: AndroidManifest.xml-Datei aktualisieren

  1. Öffnen Sie die Datei app/src/main/AndroidManifest.xml.

  2. Fügen Sie im <application>-Tag vor dem <activity>-Tag das folgende <meta-data>-Element hinzu, um Ihren API-Schlüssel zu deklarieren:

    <application
    ...>

    <meta-data
        android:name="com.google.android.geo.maps3d.API_KEY"
        android:value="${MAPS3D_API_KEY}" />

    <activity
        ...>
    </activity>
</application>

    Während des Build-Prozesses ersetzt das Secrets Gradle-Plug-in den Platzhalter ${MAPS3D_API_KEY} durch den Schlüssel aus Ihrer secrets.properties-Datei.

Programmatische Ansichtsinitialisierung (optional)

Wenn Sie die Kartenansicht lieber programmatisch als in XML-Layouts initialisieren möchten, verwenden Sie Map3DInitConfig.

import com.google.android.gms.maps3d.Map3DInitConfig
import com.google.android.gms.maps3d.Map3DView
import com.google.android.gms.maps3d.model.Map3DMode

// Set configuration options using the factory method
val config = Map3DInitConfig.create(
    mapMode = Map3DMode.HYBRID,
    centerLat = 38.544012,
    centerLng = -107.670428
)

val map3DView = Map3DView(context, config)

Nächste Schritte

Nachdem Sie ein Google Cloud-Projekt, einen API-Schlüssel und ein Android Studio-Projekt für die Verwendung mit dem Maps 3D SDK for Android eingerichtet haben, können Sie Ihrer App eine 3D-Karte hinzufügen.