Navigation Connect einrichten

Entwickler im Europäischen Wirtschaftsraum (EWR)

In diesem Dokument wird beschrieben, wie Sie Navigation Connect verwenden können.

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

Aktivieren Sie die API in Ihrem Google Cloud-Projekt.

OAuth konfigurieren, um eine authentifizierte API-Anfrage zu stellen

Für Google Maps Platform-Produkte müssen API-Aufrufe ein OAuth-Token enthalten, um eine unbefugte 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. für einen Webserver.

In diesem Dokument wird beschrieben, wie Sie ein OAuth-Token in Ihrer Entwicklungsumgebung an einen Navigation Connect-Aufruf ü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 haben Sie mehrere Möglichkeiten, Zugriffstokens mit OAuth zu erstellen und zu verwalten.

Sie können OAuth 2.0 für Server-zu-Server-Interaktionen zwischen Ihrer Anwendung und einem Google-Dienst verwenden. In diesem Fall verwenden Sie ein Dienstkonto, das mit Ihrer Anwendung verknüpft ist, und nicht mit einem einzelnen Nutzer. Sie können API-Anfragen mit dem Dienstkonto stellen, ohne Nutzer direkt einzubinden. 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, in der Tokens generiert werden, und Sie Navigation Connect mit einem OAuth-Token ausprobieren möchten, folgen Sie der Anleitung in diesem Abschnitt.

In diesem Beispiel wird beschrieben, wie Sie das von Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) bereitgestellte OAuth-Token für den Aufruf verwenden. 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 zum Testen, nicht für die Produktion.

Vorbereitung

Bevor Sie eine REST-Anfrage mit ADC stellen, müssen Sie mit der gcloud-CLI Anmeldedaten für ADC bereitstellen:

  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 ADC für eine lokale Entwicklungsumgebung einrichten.

REST-Anfrage stellen

In diesem Beispiel werden zwei Anfrageheader übergeben:

  • Ü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 aktiviert ist, im X-Goog-User-Project-Header.

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, sofern 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. Wenn Sie den curl-Befehl kopieren möchten, klicken Sie im Codebeispiel auf 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-Kennung für das Projekt
  • TRIP_ID: die UUIDv4-Fahrt-ID, die von Ihrem Backend generiert wird
  • BASE64_ENCODED_TRIP_TOKEN: Das authentifizierte Token, das von der Methode createTrip zurückgegeben wird, um die detaillierte Routenführung in Google Maps oder Waze zu starten.

Fehlerbehebung

Wenn Ihre Anfrage eine Fehlermeldung zurückgibt, die angibt, dass diese API keine Endnutzeranmeldedaten unterstützt, lesen Sie den Abschnitt 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