Navigation Connect einrichten

Entwickler im Europäischen Wirtschaftsraum (EWR)

In diesem Dokument werden die Schritte beschrieben, die Sie ausführen müssen, um Navigation Connect zu verwenden.

Vorbereitung

In diesem Leitfaden wird beschrieben, wie Sie Ihr Google Cloud-Konto und Ihr Google Cloud-Projekt mit aktivierter Abrechnung einrichten. Außerdem sollten Sie sich mit den Kosten für die Verwendung der Navigation Connect API vertraut machen.

  1. Prüfen Sie die Abrechnung und die Kosten für die Nutzung unter Navigation Connect – Nutzung und Abrechnung.
  2. Prüfen Sie, ob Sie ein Google Cloud-Konto haben.

    In der Google Cloud Console anmelden
  3. Prüfen Sie, ob Sie ein Google Cloud-Projekt mit aktivierter Abrechnung haben.

    Zur Seite „Abrechnung“
    1. Wählen Sie Ihr Projekt aus, um die Seite Abrechnung zu öffnen.
    2. Auf der Seite Abrechnung:

      • Wenn die Abrechnung für das ausgewählte Projekt bereits aktiviert ist und Sie nur ein einziges Rechnungskonto haben, wird die Seite Abrechnung geöffnet.
      • Wenn Sie mehrere Rechnungskonten haben, wählen Sie Zum verknüpften Rechnungskonto aus, um die Details zum Rechnungskonto aufzurufen, das mit dem Projekt verknüpft ist.
      • Wenn ein Rechnungskonto vorhanden, aber nicht mit dem Projekt verknüpft ist, werden Sie aufgefordert, ein Rechnungskonto mit dem Projekt zu verknüpfen.
      • Wenn kein Rechnungskonto vorhanden ist oder Sie ein neues Rechnungskonto erstellen möchten, wählen Sie Rechnungskonten verwalten aus, um ein neues Rechnungskonto zu erstellen. Weitere Informationen finden Sie unter Neues Selfservice-Cloud-Rechnungskonto erstellen.

API aktivieren und App bestätigen

In diesem Leitfaden wird beschrieben, wie Sie die Navigation Connect API aktivieren und Ihre App in der Google Cloud Console bestätigen, damit sie sicher mit Google Maps und Waze interagieren kann. Sie müssen diesen Vorgang abschließen, um die Navigation Connect API verwenden zu können.

1. Navigation Connect API aktivieren

Verwenden Sie die Google Cloud Console oder den Befehl gcloud, um die Navigation Connect API in Ihrem Google Cloud-Projekt zu aktivieren.

So aktivieren Sie die API:

Console

  1. Öffnen Sie die Produktseite in der Google Cloud Console:

    Navigation Connect API aktivieren
  2. Klicken Sie auf Aktivieren.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "navigationconnect.googleapis.com"

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

2. App-Überprüfung starten

Nachdem Sie die API aktiviert haben, müssen Sie Ihre App bestätigen, um die Navigation Connect API zu aktivieren. Durch die Aktivierung der API allein wird kein Zugriff gewährt. Sie müssen Unternehmens- und App-Details zur Überprüfung angeben, bevor Sie die Navigation Connect API verwenden können.

Sie haben folgende Möglichkeiten, die Überprüfung zu starten:

  • API Marketplace:
    1. Suchen Sie im API Marketplace nach der Karte Navigation Connect API.
    2. Klicken Sie auf das blaue Symbol Bestätigung erforderlich, um den Bestätigungsvorgang zu starten.
  • Schlüssel und Anmeldedaten in der Google Cloud Console:
    1. Rufen Sie in der Google Cloud Console die Seite Schlüssel und Anmeldedaten auf.
    2. Klicken Sie auf Navigation Connect-Schlüssel und ‑Anmeldedaten.
    3. Klicken Sie im Banner auf Bestätigung starten.

3. Details zur App, Datenerhebung und zum Datenschutz angeben

In der folgenden Tabelle werden die Details beschrieben, die Sie für die App-Überprüfung angeben müssen:

Feld Beschreibung
App-Details

Geben Sie die folgenden Details an, damit Ihre App in Google Maps und Waze korrekt angezeigt wird.

Name des Unternehmens oder der App Geben Sie den Namen ein, der Nutzern in Google Maps und Waze angezeigt werden soll.
Anwendungskennung Geben Sie den Android-Paketnamen oder die iOS-Paket-ID an.
Universeller iOS-Link Geben Sie den universellen iOS-Link an, über den Nutzer zu Ihrer App zurückkehren können (nur in Waze verfügbar).
App-Logo (nur Waze) Optional: Laden Sie ein Logo im PNG- oder JPG-Format (32 × 32 bis 128 × 128 Pixel) hoch, um das Logo Ihrer App während der Navigation in Waze anzuzeigen.
Datenerhebung und Datenschutz

Geben Sie die folgenden Informationen ein, um Transparenz, Vertrauen der Fahrer und Datensicherheit zu gewährleisten.

Link zur Datenschutzerklärung Geben Sie die URL zur Datenschutzerklärung Ihrer App an. Dieser Link wird auf dem Zustimmungsbildschirm angezeigt.
Zusätzliche Datenverantwortliche (optional) Geben Sie den Firmennamen und den Link zur Datenschutzerklärung für alle Drittanbieter-Datenmanager an, z. B. ISVs. Diese Details werden auf dem Zustimmungsbildschirm angezeigt.
Datencompliance Wenn Ihre App in den USA verwendet wird, setzen Sie ein Häkchen bei Diese App wird für Fahrten in den USA verwendet, um die Einhaltung lokaler Vorschriften zu gewährleisten.

4. Überprüfen und senden

Überprüfen Sie die Zusammenfassung der von Ihnen angegebenen Informationen, bevor Sie Ihre App zur Überprüfung einreichen.

  1. Prüfen Sie den Namen, die Plattform, die IDs und die Links Ihrer App sorgfältig.

  2. Markieren Sie das Kästchen Alle Informationen sind korrekt.
  3. Klicken Sie auf Senden.

Nachdem Sie Ihre App zur Überprüfung eingereicht haben, beginnt die Überprüfungsphase.

  • Dauer: Die Überprüfung dauert in der Regel 1–3 Arbeitstage.
  • Benachrichtigung: Sie erhalten eine E‑Mail, wenn sich der Bestätigungsstatus ändert. Außerdem erhalten Sie eine E‑Mail, in der Sie nach Ihrer Zahlungsprofil-ID oder Android-Entwickler-ID gefragt werden. Wenn Sie eine Android-Entwickler-ID benötigen, lesen Sie den Hilfeartikel Entwicklerkonto erstellen.
  • Statusverfolgung: Sie können Ihren Fortschritt auf der Seite Schlüssel und Anmeldedaten in der Google Cloud Console verfolgen.
  • Support: Wenn Sie Ihre Konfiguration nach der Genehmigung aktualisieren möchten, ohne die Produktion zu beeinträchtigen, erstellen Sie ein Support-Ticket.

Nach der Überprüfung ist Ihre App berechtigt, die Navigation Connect API zu verwenden, um Fahrt-Tokens zu generieren, die den Zugriff auf eine Navigationssitzung autorisieren und es Ihnen ermöglichen, Fahrtdetails von Google Maps und Waze zu erhalten.

Für Google Maps Platform-Produkte ist ein OAuth-Token erforderlich, um die nicht autorisierte Nutzung zu verhindern.

OAuth-Token erstellen

Navigation Connect unterstützt OAuth 2.0 für die Authentifizierung. Google unterstützt gängige OAuth 2.0-Szenarien, z. B. Szenarien für einen Webserver.

In diesem Dokument wird beschrieben, wie Sie ein OAuth-Token an einen Navigation Connect-Aufruf in Ihrer Entwicklungsumgebung übergeben. Weitere Informationen zur Verwendung von OAuth in einer Produktionsumgebung finden Sie unter Authentifizierungsmethoden bei Google.

Sie können Google Maps APIs direkt aufrufen, indem Sie API-Anfragen an den Server senden, oder Sie können Clientbibliotheken verwenden, um Ihren Code zu vereinfachen. Google Maps bietet Clientbibliotheken für Go, Java, Node.js und Python. Weitere Informationen finden Sie unter Navigation Connect-Clientbibliotheken.

OAuth-Übersicht

Je nach Bereitstellungsumgebung können Sie Zugriffstokens mit OAuth auf verschiedene Arten erstellen und verwalten.

Sie können OAuth 2.0 für Server-zu-Server-Interaktionen zwischen Ihrer Anwendung und einem Google-Dienst verwenden. In diesem Szenario verwenden Sie ein Dienstkonto, das mit Ihrer Anwendung und nicht mit einem einzelnen Nutzer verknüpft ist. Sie können API-Anfragen mit dem Dienstkonto stellen, ohne Nutzer direkt einzubeziehen. Weitere Informationen zu Authentifizierungsmethoden finden Sie unter Authentifizierungsmethoden bei Google.

Alternativ können Sie Navigation Connect in eine mobile Android- oder iOS-App einbinden. Weitere Informationen zur Verwendung von OAuth und zur Verwaltung von Zugriffstokens für verschiedene Bereitstellungsumgebungen finden Sie unter OAuth 2.0 für den Zugriff auf Google APIs verwenden.

OAuth-Bereiche

Wenn Sie OAuth mit Navigation Connect verwenden möchten, müssen Sie dem OAuth-Token den folgenden Bereich zuweisen:

https://www.googleapis.com/auth/cloud-platform

Beispiel: REST API-Aufrufe in Ihrer lokalen Entwicklungsumgebung testen

Wenn Sie keine Umgebung haben, die Tokens generiert, und Navigation Connect mit einem OAuth-Token ausprobieren möchten, gehen Sie wie in diesem Abschnitt beschrieben vor.

In diesem Beispiel wird beschrieben, wie Sie das OAuth-Token verwenden, das von Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) bereitgestellt wird, um den Aufruf auszuführen. Weitere Informationen zur Verwendung von ADC zum Aufrufen von Google APIs mit Clientbibliotheken finden Sie unter Mit Clientbibliotheken authentifizieren.

Verwenden Sie das folgende REST-Verfahren nur für die Entwicklung oder für Tests, nicht für die Produktion.

Vorbereitung

Bevor Sie eine REST-Anfrage mit ADC stellen, verwenden Sie die gcloud-Befehlszeile, um Anmeldedaten für ADC bereitzustellen:

  1. Installieren und initialisieren Sie gcloud CLI. Weitere Informationen finden Sie unter gcloud CLI installieren.

  2. Authentifizieren Sie sich mit der gcloud-Befehlszeile:

    gcloud auth application-default login
  3. Schließen Sie die Anmeldung ab, um Ihre Anmeldedaten in der lokalen Anmeldedatendatei für ADC zu speichern.

Weitere Informationen finden Sie unter Standardanmeldedaten für Anwendungen für eine lokale Entwicklungsumgebung einrichten.

REST-Anfrage stellen

In diesem Beispiel übergeben Sie zwei Anfrageheader:

  • Übergeben Sie das OAuth-Token im Authorization-Header. Verwenden Sie dazu den folgenden Befehl, um das Token zu generieren:

    gcloud auth application-default print-access-token

    Das zurückgegebene Token hat den Bereich https://www.googleapis.com/auth/cloud-platform.

  • Übergeben Sie die ID oder den Namen Ihres Google Cloud-Projekts, für das die Abrechnung im Header X-Goog-User-Project aktiviert ist.

So rufen Sie Navigation Connect mit einem OAuth-Token auf:

  1. Ersetzen Sie im folgenden Codebeispiel die Platzhalter durch Ihre Werte:

    • PROJECT_ID: Ihre Google Cloud-Projekt-ID
    • ANDROID_APP_ID: der Android-Paketname Ihrer App, falls zutreffend
    • IOS_APP_ID: die iOS-Paket-ID Ihrer App, falls zutreffend
    #!/bin/bash
    trip_id="$(uuidgen)"
    access_token="$(gcloud auth application-default print-access-token)"
    curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \
    -H "Authorization: Bearer ${access_token}" \
    -H "Content-Type: application/json" \
    -d '{
    "androidAppId": "ANDROID_APP_ID",
    "iosAppId": "IOS_APP_ID",
    }'
  2. Klicken Sie im Codebeispiel auf Kopieren, um den Befehl curl zu kopieren.

  3. Fügen Sie den Befehl in ein Terminalfenster ein und führen Sie ihn aus.

Die Antwort ist ein JSON-Objekt:

{
  "name": "projects/PROJECT_NUMBER/trips/TRIP_ID",
  "authToken": {
    "token": "BASE64_ENCODED_TRIP_TOKEN",
    "expireTime": "2026-03-06T11:09:47.476942Z"
  },
  "state": "NEW",
  "execution": {
    "traveledDistanceMeters": 0,
    "stopAddedInRoute": false
  },
  "createTime": "2026-03-05T23:09:50.768959Z",
  "updateTime": "2026-03-05T23:09:50.768959Z",
}

Diese Antwort enthält die folgenden Werte:

  • PROJECT_NUMBER: die eindeutige Long-Integer-ID für das Projekt
  • TRIP_ID: die UUIDv4-Fahrt-ID, die Ihr Back-End generiert
  • BASE64_ENCODED_TRIP_TOKEN: das authentifizierte Token, das die Methode createTrip zurückgibt, um die detaillierte Routenführung mit Tracking in Google Maps oder Waze zu starten

Fehlerbehebung

Wenn Ihre Anfrage eine Fehlermeldung zurückgibt, die angibt, dass diese API keine Endnutzeranmeldedaten unterstützt, finden Sie weitere Informationen unter Fehlerbehebung für die ADC-Einrichtung.

Nächste Schritte

Konfigurieren Sie als Nächstes Ihre Dienstkonten für die Navigation Connect API, um eine sichere Server-zu-Server-Kommunikation zwischen Ihrer Backend-Infrastruktur, Google Maps und Waze zu ermöglichen.

Dienstkonto einrichten