Reise erstellen und Reise-Token erhalten

Damit Sie eine detaillierte Routenführung für einen Fahrer sicher starten können, muss Ihr Backend eine Fahrt erstellen und ein authentifiziertes Fahrt-Token von der Navigation Connect API abrufen.

In Navigation Connect steht eine Fahrt für eine Navigationssitzung zu einem einzelnen Ziel. Wenn Sie eine Fahrt erstellen und das authentifizierte Fahrt-Token (authToken) abrufen möchten, das zum Autorisieren der Sitzung erforderlich ist, senden Sie eine CreateTripRequest-Nachricht an die Methode CreateTrip. Übergeben Sie das Fahrt-Token an Ihre mobile App, damit es in die Start-URL für Google Maps oder Waze aufgenommen werden kann.

In dieser Anleitung wird beschrieben, wie Sie diesen Prozess abschließen, indem Sie eine eindeutige Fahrt-ID generieren und Ihre API-Anfrage senden.

CreateTripRequest-Nachricht erstellen

So erstellen Sie eine Fahrt und rufen ein Fahrt-Token ab CreateTripRequest:

  1. Authentifizieren: Verwenden Sie Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC), um ein Zugriffstoken zum Autorisieren Ihrer Anfrage zu erhalten. Weitere Informationen finden Sie unter OAuth-Token erstellen.
  2. Fahrt-ID generieren: Erstellen Sie eine eindeutige Fahrt-ID (tripId) im UUIDv4-Format, um die Fahrt auf Ihrem Server zu identifizieren.
  3. Nutzlast erstellen: Erstellen Sie eine JSON-Nutzlast mit Ihren App-IDs und Konfigurationseinstellungen.
  4. Methode CreateTrip aufrufen: Senden Sie eine POST-Anfrage an die API mit dem Zugriffstoken im Header und der Nutzlast im Text.

Im folgenden Beispiel wird gezeigt, wie Sie eine Fahrt erstellen, indem Sie eine CreateTripRequest-Nachricht senden:

#!/bin/bash

# Authenticate with ADC
access_token="$(gcloud auth application-default login --impersonate-service-account=SERVICE_ACCOUNT_EMAIL)"

# Generate a unique Trip ID
trip_id="$(uuidgen)"

# Construct the payload
payload=$(cat <<EOF
{
  "androidAppId": "ANDROID_APP_ID",
  "iosAppId": "IOS_APP_ID",
  "config": {
    "enablePubsub": true
  }
}
EOF
)

# Call the CreateTrip method to request a trip 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 "${payload}"

Optionale Konfigurationen

Sie können die Fahrtdaten anpassen, indem Sie die folgenden Einstellungen in der CreateTripRequest-Nachricht ändern:

Funktion Typ Beschreibung
Meldungen zur verbleibenden Route (nur Waze) boolean

Wenn Sie die Polylinie der aktiven Route und Echtzeit-Verkehrslage erhalten möchten, legen Sie config.enableRemainingRouteReporting auf true fest.
Meldung von Routenabweichungen (nur Waze) boolean

Wenn Sie erfassen möchten, wann ein Fahrer von der Route abweicht, setzen Sie config.enableRouteDeviationReporting auf true.
Updatehäufigkeit für Fahrten boolean

Standardmäßig werden die Fahrtdaten von Navigation Connect alle 60 Sekunden aktualisiert. Wenn Sie häufige Aktualisierungen (alle 5 Sekunden) aktivieren möchten, setzen Sie config.enableHighFrequencyUpdates auf true.
Google Cloud Pub/Sub-Ereignisgenerierung boolean

Wenn Sie die Generierung von Fahrtereignissen mit Google Cloud Pub/Sub aktivieren möchten, setzen Sie config.enablePubsub auf true. Diese Funktion ist standardmäßig deaktiviert.

.
Google Cloud Pub/Sub-Feldmaske FieldMask

Wenn Sie die Nutzlastgrößen verwalten und die Backend-Verarbeitungslast oder die Google Cloud Pub/Sub-Nutzungskosten reduzieren möchten, verwenden Sie config.pubsubFieldMask, um umfangreiche Felder (z. B. execution.remainingRoute) aus Ihrem Ereignisstream auszuschließen. Weitere Informationen zur Nutzlastgröße für verbleibende Routendaten finden Sie unter Verbleibende Routendaten verarbeiten.

Fahrt-Token aus der Antwort abrufen

Die Methode CreateTrip gibt eine Antwort mit dem authentifizierten Fahrt-Token zurück. Um die Navigationssitzung zu autorisieren, extrahieren Sie dieses Token aus der Antwort und übergeben Sie es an Ihre mobile App, damit es in die Start-URL aufgenommen wird.

Das folgende Codebeispiel zeigt eine Beispielantwort:

{
    "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: Eine eindeutige numerische Kennung für Ihr Projekt. Sie unterscheidet sich von Ihrer alphanumerischen Projekt-ID, steht aber für dasselbe Google Cloud-Projekt.
  • TRIP_ID: Die von Ihrem Backend generierte Fahrt-ID im UUIDv4-Format.
  • BASE64_ENCODED_TRIP_TOKEN: Das authentifizierte Fahrt-Token (authToken.token), das von der Methode CreateTrip zurückgegeben wird. Übergeben Sie dieses Token an Ihre mobile App, um die detaillierte Routenführung mit Tracking in Google Maps oder Waze zu starten.

Nächste Schritte

Verwenden Sie das Fahrt-Token, um Google Maps oder Waze zu starten.

Google Maps oder Waze starten