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:

gcloud projects create "PROJECT"

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"

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

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

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

1. 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.

2. 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
   

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. 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" }
   

5. 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

1. 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
   

2. 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

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

2. 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.