Navigation Connect einrichten

Entwickler im Europäischen Wirtschaftsraum (EWR)

In diesem Dokument werden die Schritte beschrieben, die erforderlich sind, um Navigation Connect zu verwenden.

Prüfen Sie, ob Sie die Voraussetzungen erfüllen.

Aktivieren Sie die API in Ihrem Google Cloud-Projekt.

Konfigurieren Sie OAuth, um eine authentifizierte API-Anfrage zu senden.

Google Maps Platform-Produkte sind vor unbefugter Nutzung geschützt, da API-Aufrufe ein OAuth-Token enthalten müssen.

OAuth-Token erstellen

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

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

OAuth

Es gibt viele Möglichkeiten, Zugriffstokens mit OAuth zu erstellen und zu verwalten, je nach Ihrer Bereitstellungsumgebung.

Das Google OAuth 2.0-System unterstützt beispielsweise Interaktionen zwischen Servern, z. B. zwischen Ihrer Anwendung und einem Google-Dienst. Für dieses Szenario benötigen Sie ein Dienstkonto. Ein Dienstkonto ist ein Konto, das nicht zu einem einzelnen Endnutzer, sondern zu Ihrer Anwendung gehört. Ihre Anwendung ruft Google APIs im Namen des Dienstkontos auf, sodass Nutzer nicht direkt beteiligt sind. Weitere Informationen zu Authentifizierungsmethoden finden Sie unter Authentifizierungsmethoden bei Google.

Alternativ können Sie Navigation Connect als Teil einer mobilen Android- oder iOS-App verwenden. Allgemeine Informationen zur Verwendung von OAuth mit Navigation Connect, einschließlich Informationen zur Verwaltung von Zugriffstokens für verschiedene Bereitstellungsumgebungen, finden Sie unter Mit OAuth 2.0 auf Google APIs zugreifen.

OAuth-Bereiche

Wenn Sie OAuth mit Navigation Connect verwenden möchten, muss dem OAuth-Token der folgende Bereich zugewiesen werden:

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

Beispiel: REST API-Aufrufe in Ihrer lokalen Entwicklungsumgebung testen

Wenn Sie Navigation Connect mit einem OAuth-Token testen möchten, aber keine Umgebung zum Generieren von Tokens eingerichtet haben, können Sie den Aufruf mit der in diesem Abschnitt beschriebenen Methode ausführen.

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

Vorbereitung

Bevor Sie eine REST-Anfrage mit ADC stellen können, müssen Sie ADC mit der Google Cloud CLI Anmeldedaten bereitstellen:

  1. Installieren und initialisieren Sie die gcloud CLI.

  2. Führen Sie den folgenden gcloud Befehl auf Ihrem lokalen Computer aus, um Ihre Anmeldedatendatei zu erstellen:

    gcloud auth application-default login
  3. Ein Anmeldebildschirm wird angezeigt. Nach der Anmeldung werden Ihre Anmeldedaten in der lokalen Anmeldedatendatei für ADC gespeichert.

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

REST-Anfrage stellen

In diesem Beispiel übergeben Sie zwei Anfrageheader:

  • Übergeben Sie das OAuth-Token im Authorization Header, indem Sie den folgenden Befehl verwenden, 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 aktiviert ist, im X-Goog-User-Project Header.

Im folgenden Beispiel wird ein Aufruf an Navigation Connect mit einem OAuth-Token ausgeführt.

  1. Bearbeiten Sie das Feld PROJECT_ID, um die ID Ihres Google Cloud-Projekts zu übergeben.

    Bearbeiten Sie außerdem Folgendes, falls zutreffend:

    • ANDROID_APP_ID: Der Android-Paketname Ihrer App.
    • IOS_APP_ID: Die iOS-Paket-ID Ihrer App.
    #!/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 das Kopiersymbol, Wählen Sie das Symbol zum Kopieren aus., um den curl Befehl 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 lange Ganzzahl-ID für das Projekt.
  • TRIP_ID: Die von Ihrem Backend generierte Fahrt-ID im UUIDv4-Format.
  • BASE64_ENCODED_TRIP_TOKEN: Das authentifizierte Token, das von der createTrip Methode zurückgegeben wird. Übergeben Sie dieses Token an Ihre mobile App, um die verfolgte detaillierte Routenführung in Google Maps oder Waze zu starten.

Fehlerbehebung

Wenn Ihre Anfrage eine Fehlermeldung zurückgibt, die angibt, dass Endnutzeranmeldedaten nicht von dieser API unterstützt werden, lesen Sie den Artikel Fehlerbehebung bei der ADC-Einrichtung.

Nächste Schritte

Der nächste Schritt beim Einrichten der Navigation Connect API besteht darin, Ihre Dienstkonten einzurichten, um eine sichere Server-zu-Server-Kommunikation zwischen Ihrer Backend-Infrastruktur und Google Maps und Waze zu ermöglichen.

Dienstkonto einrichten