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 Fahrttoken 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 Fahrttoken (authToken) abrufen möchten, das zum Autorisieren der Sitzung erforderlich ist, senden Sie eine CreateTripRequest-Nachricht an die Methode CreateTrip. Übergeben Sie das Fahrttoken an Ihre mobile App, damit es in die Start-URL für Google Maps oder Waze aufgenommen wird.

In diesem Leitfaden wird beschrieben, wie Sie diesen Vorgang abschließen, indem Sie eine eindeutige Fahrt-ID generieren und Ihre API-Anfrage senden.

CreateTripRequest-Nachricht erstellen

Führen Sie die folgenden Schritte aus, um eine Fahrt zu erstellen und ein Fahrttoken zu erhalten. Erstellen und senden Sie dazu eine CreateTripRequest-Nachricht:

  1. Authentifizieren: Verwenden Sie Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC), um ein Zugriffstoken zur Autorisierung 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, die Ihre App-IDs und Konfigurationseinstellungen enthält.
  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 anpassen:

Funktion Typ Beschreibung
Meldung der verbleibenden Route boolean

Wenn Sie die Polylinie der aktiven Route und die Echtzeit-Verkehrslage erhalten möchten, setzen Sie config.enableRemainingRouteReporting auf true.

Fahrer benötigen Waze-Version 5.20.0.2 oder höher für Android, 5.20.0.1 oder höher für iOS oder Google Maps für Android-Version 26.27 oder höher.

Meldung von Routenabweichungen (nur Waze) boolean

Wenn Sie nachverfolgen möchten, wann ein Fahrer von der Route abweicht, setzen Sie config.enableRouteDeviationReporting auf true.

Fahrer benötigen die Waze-Version 5.22 oder höher.

Häufigkeit der Fahrtaktualisierungen boolean

Standardmäßig werden die Fahrtdaten in 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öße verwalten und die Verarbeitungslast im Backend oder die Nutzungskosten für Google Cloud Pub/Sub reduzieren möchten, können Sie mit config.pubsubFieldMask große Felder (z. B. execution.remainingRoute) aus dem Ereignisstream ausschließen. Weitere Informationen zur Nutzlastgröße für verbleibende Routendaten finden Sie unter Verbleibende Routendaten verarbeiten.

Fahrttoken aus der Antwort abrufen

Die Methode CreateTrip gibt eine Antwort mit dem authentifizierten Fahrttoken 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. Diese unterscheidet sich von Ihrer alphanumerischen Projekt-ID, steht aber für dasselbe Google Cloud-Projekt.
  • TRIP_ID: Die von Ihrem Back-End im UUIDv4-Format generierte Fahrt-ID.
  • BASE64_ENCODED_TRIP_TOKEN: Das authentifizierte Fahrttoken (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