Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Einrichtung

Auf dieser Seite wird beschrieben, was Sie tun müssen, um mit dem Maps 3D SDK for Android zu arbeiten. 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

Damit Sie das Maps 3D SDK for Android verwenden können, 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 minSdk von 24 oder höher ausgerichtet sein.
Google Play-Dienste: Das Maps 3D SDK for Android ist von 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 arbeiten 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. Führen Sie dazu die folgenden Schritte aus:

Schritt 1

Console

Klicken Sie in der Google Cloud Console auf der Projektauswahlseite auf Projekt erstellen , um ein neues Cloud -Projekt einzurichten.

Rufen Sie die Seite zur Projektauswahl auf.
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:

gcloud projects create

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 müssen Sie 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

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 Google Maps-API-Bibliothek Seite
Klicken Sie auf die API oder das SDK, das Sie aktivieren möchten.
- Wenn der Button AKTIVIEREN angezeigt wird, können Sie 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:

Mit diesem Befehl aktivieren Sie die Environment APIs:

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:

Console

Rufen Sie die Seite Google Maps Platform > Anmeldedaten auf.

Zur Seite „Anmeldedaten“
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.
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:

gcloud services api-keys create

Informationen zum Aktivieren des SDK finden Sie in der Google Cloud Console auf der Maps 3D SDK for Android Seite. 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

Erstellen Sie ein neues Android Studio-Projekt mit der Vorlage Empty Views Activity. Legen Sie in der Projektkonfiguration Minimum SDK auf API 24 oder höher fest.
Wenn Sie Git für die Quellcodeverwaltung verwenden, ändern Sie die Datei .gitignore des Projekts, damit Ihre Secret-Datei nicht in die Versionsverwaltung eingecheckt wird:
- Öffnen Sie im Stammverzeichnis Ihres Projekts die Datei .gitignore.
- Fügen Sie folgende Zeile hinzu:
```
secrets.properties
```

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
}

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

Öffnen Sie die Datei gradle/libs.versions.toml. Sie befindet sich normalerweise im Verzeichnis gradle im Stammverzeichnis des Projekts.
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.0"
# 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" }

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

Öffnen Sie die Datei build.gradle.kts auf Modulebene. Sie befindet sich normalerweise im Verzeichnis app.
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 Secret-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

Erstellen Sie eine Datei secrets.properties:
- 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
```
Hinweis: Ersetzen Sie YOUR_API_KEY_HERE durch den API-Schlüssel, den Sie für die Verwendung mit dem Maps 3D SDK für Android konfiguriert haben.
Erstellen Sie eine Datei local.defaults.properties: - 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: Datei `AndroidManifest.xml` aktualisieren

Öffnen Sie die Datei app/src/main/AndroidManifest.xml.
Fügen Sie im Tag <application> vor dem Tag <activity> 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 Datei secrets.properties.

Programmatische Ansicht initialisieren (optional)

Wenn Sie Ihre 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.

Einrichtung Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Vorbereitung

Google Cloud-Projekt und API-Schlüssel einrichten

Schritt 1

Console

Cloud SDK

Schritt 2

Console

Cloud SDK

Schritt 3

Console

Cloud SDK

Android Studio-Projekt einrichten

Teil 1: Projekt und Gradle-Konfiguration einrichten

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

Teil 3: Datei AndroidManifest.xml aktualisieren

Programmatische Ansicht initialisieren (optional)

Nächste Schritte

Einrichtung

Teil 3: Datei `AndroidManifest.xml` aktualisieren