Das Navigation SDK ist derzeit nur für ausgewählte Kunden verfügbar. Weitere Informationen erhalten Sie vom Vertrieb.

In der Google Maps Platform stehen bald neue Kartenstile zur Verfügung. Dieses Update für die Kartenstile umfasst eine neue Standardfarbvorlage und Verbesserungen bei der Nutzerfreundlichkeit und Nutzerfreundlichkeit von Karten. Alle Kartenstile werden im März 2025 automatisch aktualisiert. Weitere Informationen zur Verfügbarkeit und zur früheren Aktivierung finden Sie unter Neuer Kartenstil für die Google Maps Platform.

Diese Seite wurde von der Cloud Translation API übersetzt.

Android Studio-Projekt einrichten

Auf dieser Seite wird die Integration des Navigation SDK erläutert. in Ihr Entwicklungsprojekt ein.

Dem Projekt das Navigation SDK hinzufügen

Das Navigation SDK ist über die Google Maven Repository. Du kannst das SDK mit deinem Gradle-Plug-in build.gradle oder Maven-pom.xml-Konfiguration

Fügen Sie Ihrer Gradle- oder Maven-Konfiguration die folgende Abhängigkeit hinzu: Dabei wird der Platzhalter VERSION_NUMBER für den gewünschte Version des Navigation SDK für Android.

Gradle

Fügen Sie der Datei build.gradle auf Modulebene Folgendes hinzu:
```
dependencies {
        ...
        implementation 'com.google.android.libraries.navigation:navigation:VERSION_NUMBER'
}
```
Maven

Fügen Sie zum pom.xml Folgendes hinzu:
```
<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
</dependencies>
```
Hinweis: Wenn Sie Mobility Services-Kunde sind und ein Upgrade vom ursprünglichen privaten Maven-Repository durchführen, beachten Sie, dass sich die Namen der Gruppe und des Artefakts geändert haben und das com.google.cloud.artifactregistry.gradle-plugin-Plug-in nicht mehr erforderlich ist.

Wenn Sie Abhängigkeiten haben, für die das Maps SDK verwendet wird, müssen Sie den Parameter Abhängigkeit in jeder deklarierten Abhängigkeit, die auf dem Maps SDK basiert.

Gradle

Fügen Sie Ihrem build.gradle auf oberster Ebene Folgendes hinzu:

allprojects {
        ...
        // Required: you must exclude the Google Play service Maps SDK from
        // your transitive dependencies. This is to ensure there won't be
        // multiple copies of Google Maps SDK in your binary, as the Navigation
        // SDK already bundles the Google Maps SDK.
        configurations {
            implementation {
                exclude group: 'com.google.android.gms', module: 'play-services-maps'
            }
        }
}

Maven

Fügen Sie zum pom.xml Folgendes hinzu:

<dependencies>
  <dependency>
  <groupId>project.that.brings.in.maps</groupId>
  <artifactId>MapsConsumer</artifactId>
  <version>1.0</version>
    <exclusions>
      <!-- Navigation SDK already bundles Maps SDK. You must exclude it to prevent duplication-->
      <exclusion>  <!-- declare the exclusion here -->
        <groupId>com.google.android.gms</groupId>
        <artifactId>play-services-maps</artifactId>
      </exclusion>
    </exclusions>
  </dependency>
</dependencies>

Build konfigurieren

Nachdem Sie das Projekt erstellt haben, können Sie die Einstellungen für einen erfolgreichen Build und die Verwendung des Navigation SDK konfigurieren.

Lokale Unterkünfte aktualisieren

Öffnen Sie im Ordner „Gradle Scripts“ die Datei local.properties und fügen Sie android.useDeprecatedNdk=true.

Gradle-Build-Skript aktualisieren

Öffne die Datei build.gradle (Module:app) und beachte die folgenden Richtlinien um die Einstellungen so zu aktualisieren, dass sie den Anforderungen für Navigation SDK und ziehen Sie erwägen, die Optimierungsoptionen an.

Erforderliche Einstellungen für das Navigation SDK
1. Setzen Sie minSdkVersion auf 23 oder höher.
2. Legen Sie targetSdkVersion auf 34 oder höher fest.
3. Fügen Sie eine dexOptions-Einstellung hinzu, die den javaMaxHeapSize erhöht.
4. Legen Sie den Speicherort für zusätzliche Bibliotheken fest.
5. Fügen Sie die repositories und dependencies für das Navigations-SDK hinzu.
6. Ersetzen Sie die Versionsnummern in den Abhängigkeiten durch die neuesten verfügbaren Versionen.
Optionale Einstellungen zur Verringerung der Build-Dauer
- Aktivieren Sie die Code- und Ressourcenkomprimierung mit R8/ProGuard, um nicht verwendeten Code und Ressourcen aus Abhängigkeiten zu entfernen. Wenn dass der Schritt R8/ProGuard zu viel Zeit in Anspruch nimmt. Erwägen Sie, multidex für und Entwicklungsarbeit.
- Anzahl der im Build enthaltenen Sprachübersetzungen reduzieren: Legen Sie während der Entwicklung resConfigs für eine Sprache fest. Für den endgültigen Build Legen Sie resConfigs für Sprachen fest, die Sie tatsächlich verwenden. Standardmäßig gibt Gradle enthält Ressourcen-Strings für alle vom Navigation SDK
Desugaring für Java 8-Unterstützung hinzufügen
- Wenn Sie Ihre App mit dem Android Gradle-Plug-in 4.0.0 oder höher erstellen, wird die Unterstützung für die Verwendung einer Reihe von Java 8-Sprach-APIs erweitert. Weitere Informationen finden Sie unter Unterstützung für die Desugaring-Funktion in Java 8. Im Beispiel-Build-Script-Snippet unten finden Sie Informationen zu den Optionen für die Kompilierung und Abhängigkeiten.
- Wir empfehlen, Gradle 8.4, das Android-Gradle-Plug-in in der Version 8.3.0 und die Desugar-Bibliothekcom.android.tools:desugar_jdk_libs_nio:2.0.3 zu verwenden. Diese Einrichtung ist kompatibel mit dem Navigation SDK for Android 6.0.0 und höher.
- Die Desugar-Bibliothek muss für das app-Modul und alle das direkt vom Navigation SDK abhängt.

Im Folgenden finden Sie ein Beispiel für das Gradle-Build-Skript für die Anwendung. Überprüfen Sie die Beispielanwendungen für aktualisierte Gruppen von Abhängigkeiten, als Version von Das von Ihnen verwendete Navigation SDK ist möglicherweise hinter dieser Dokumentation stehen.

apply plugin: 'com.android.application'

ext {
    navSdk = "__NAVSDK_VERSION__"
}

android {
    compileSdk 33
    buildToolsVersion='28.0.3'

    defaultConfig {
        applicationId "<your id>"
        // Navigation SDK supports SDK 23 and later.
        minSdkVersion 23
        targetSdkVersion 34
        versionCode 1
        versionName "1.0"
        // Set this to the languages you actually use, otherwise you'll include resource strings
        // for all languages supported by the Navigation SDK.
        resConfigs "en"
        multiDexEnabled true
    }

    dexOptions {
        // This increases the amount of memory available to the dexer. This is required to build
        // apps using the Navigation SDK.
        javaMaxHeapSize "4g"
    }
    buildTypes {
        // Run ProGuard. Note that the Navigation SDK includes its own ProGuard configuration.
        // The configuration is included transitively by depending on the Navigation SDK.
        // If the ProGuard step takes too long, consider enabling multidex for development work
        // instead.
        all {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        // Flag to enable support for the new language APIs
        coreLibraryDesugaringEnabled true
        // Sets Java compatibility to Java 8
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

repositories {
    // Navigation SDK for Android and other libraries are hosted on Google's Maven repository.
    google()
}

dependencies {
    // Include the Google Navigation SDK.
    // Note: remember to exclude Google Play service Maps SDK from your transitive
    // dependencies to avoid duplicate copies of the Google Maps SDK.
    api "com.google.android.libraries.navigation:navigation:${navSdk}"

    // Declare other dependencies for your app here.

    annotationProcessor "androidx.annotation:annotation:1.7.0"
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs_nio:2.0.3'
}

API-Schlüssel in die App einfügen

In diesem Abschnitt wird beschrieben, wie Sie Ihren API-Schlüssel speichern, damit er von Ihrer App sicher referenziert werden kann. Er sollte nicht in Ihrem Versionsverwaltungssystem eingecheckt werden. Stattdessen empfehlen wir, ihn im Stammverzeichnis Ihres Projekts in der Datei secrets.properties zu speichern. Weitere Informationen zur Datei secrets.properties finden Sie unter Gradle properties files.

Sie können das Secrets Gradle-Plug-in for Android verwenden, um diese Aufgabe zu optimieren.

So installieren Sie das Secrets Gradle-Plug-in für Android in Ihrem Google Maps-Projekt:

Öffnen Sie in Android Studio die Datei build.gradle.kts oder build.gradle auf oberster Ebene und fügen Sie den folgenden Code in das dependencies-Element unter buildscript ein.

Kotlin

buildscript {
    dependencies {
        classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1")
    }
}

Groovy

buildscript {
    dependencies {
        classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"
    }
}

Öffnen Sie die Datei build.gradle.kts oder build.gradle auf Modulebene und fügen Sie den folgenden Code in das plugins-Element ein.

Kotlin

plugins {
    // ...
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
}

Groovy

plugins {
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
}

In der Datei build.gradle.kts oder build.gradle auf Modulebene müssen targetSdk und compileSdk auf 34 gesetzt sein.
Speichern Sie die Datei und synchronisieren Sie Ihr Projekt mit Gradle.
Öffnen Sie die Datei secrets.properties im Verzeichnis der obersten Ebene und fügen Sie den folgenden Code ein. Ersetzen Sie dabei YOUR_API_KEY durch Ihren eigenen API-Schlüssel. Speichern Sie den Schlüssel in dieser Datei, da secrets.properties nicht in ein Versionsverwaltungssystem eingecheckt werden kann.
Hinweis: Sollte die Datei secrets.properties nicht vorhanden sein, erstellen Sie sie im selben Ordner wie die Datei local.properties.
```
NAV_API_KEY=YOUR_API_KEY
```
Speichern Sie die Datei.
Erstellen Sie die Datei local.defaults.properties im Verzeichnis der obersten Ebene, im selben Ordner wie die Datei secrets.properties, und fügen Sie folgenden Code ein.

Hinweis: Geben Sie den Code genau wie hier gezeigt ein. Ersetzen Sie DEFAULT_API_KEY nicht durch Ihren API-Schlüssel.
```
NAV_API_KEY=DEFAULT_API_KEY
```
Diese Datei ist ein Ersatzspeicherort für den API-Schlüssel, damit Builds nicht fehlschlagen, falls die Datei secrets.properties nicht gefunden wird. Das kann passieren, wenn Sie die App aus einem Versionsverwaltungssystem klonen, in dem secrets.properties nicht vorhanden ist, und noch keine lokale Datei secrets.properties erstellt haben, um Ihren API-Schlüssel bereitzustellen.
Speichern Sie die Datei.
Gehen Sie in der Datei AndroidManifest.xml zu com.google.android.geo.API_KEY und aktualisieren Sie das android:value attribute. Falls das <meta-data>-Tag nicht vorhanden ist, erstellen Sie es als untergeordnetes Element des <application>-Tags.
```
<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${MAPS_API_KEY}" />
```
Note: com.google.android.geo.API_KEY is the recommended metadata name for the API key. A key with this name can be used to authenticate to multiple Google Maps-based APIs on the Android platform, including the Navigation SDK for Android. For backwards compatibility, the API also supports the name com.google.android.maps.v2.API_KEY. This legacy name allows authentication to the Android Maps API v2 only. An application can specify only one of the API key metadata names. If both are specified, the API throws an exception.

In Android Studio, open your module-level build.gradle.kts or build.gradle file and edit the secrets property. If the secrets property does not exist, add it.

Edit the properties of the plugin to set propertiesFileName to secrets.properties, set defaultPropertiesFileName to local.defaults.properties, and set any other properties.

Kotlin

secrets {
    // To add your Maps API key to this project:
    // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
    // 2. Add this line, where YOUR_API_KEY is your API key:
    //        MAPS_API_KEY=YOUR_API_KEY
    propertiesFileName = "secrets.properties"

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

    // Configure which keys should be ignored by the plugin by providing regular expressions.
    // "sdk.dir" is ignored by default.
    ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
    ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
}

Groovy

secrets {
    // To add your Maps API key to this project:
    // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
    // 2. Add this line, where YOUR_API_KEY is your API key:
    //        MAPS_API_KEY=YOUR_API_KEY
    propertiesFileName = "secrets.properties"

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

    // Configure which keys should be ignored by the plugin by providing regular expressions.
    // "sdk.dir" is ignored by default.
    ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
    ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
}

Erforderliche Quellenangaben in Ihrer App angeben

Wenn Sie das Navigation SDK for Android in Ihrer App verwenden, müssen Sie Attributionstext und Open-Source-Lizenzen als Teil der rechtlichen Hinweise Ihrer App .

Den erforderlichen Quellenhinweis und die Open-Source-Lizenzen finden Sie in der ZIP-Datei „Navigation SDK for Android“:

NOTICE.txt
LICENSES.txt

Wenn Sie ein Mobility- oder Fleet Engine Deliveries-Kunde sind

Wenn Sie Mobility- oder Fleet Engine Deliveries-Kunde sind, finden Sie Informationen zur Abrechnung in der Mobility-Dokumentation. Weitere Informationen zum Aufzeichnen von Transaktionen finden Sie unter Abrechnung einrichten, Abrechenbare Transaktionen aufzeichnen, Berichterstellung und Abrechenbare Transaktionen aufzeichnen (Android).