Tworzenie podróży i uzyskiwanie tokena podróży

Aby bezpiecznie uruchomić sesję szczegółowych wskazówek dojazdu dla kierowcy, Twój backend musi utworzyć przejazd i uzyskać uwierzytelniony token przejazdu z interfejsu Navigation Connect API.

W Navigation Connect przejazd reprezentuje sesję nawigacji do jednego miejsca docelowego. Aby utworzyć przejazd i uzyskać uwierzytelniony token przejazdu (authToken) wymagany do autoryzacji sesji, wyślij wiadomość CreateTripRequest do metody CreateTrip. Przekaż token przejazdu do aplikacji mobilnej, aby uwzględnić go w adresie URL uruchamiania Map Google lub Waze.

Z tego przewodnika dowiesz się, jak przeprowadzić ten proces, generując unikalny identyfikator przejazdu i przesyłając żądanie do interfejsu API.

Utwórz wiadomość CreateTripRequest

Aby utworzyć przejazd i uzyskać token przejazdu, wykonaj te czynności, aby utworzyć i wysłać wiadomość CreateTripRequest:

  1. Uwierzytelnianie: użyj domyślnego uwierzytelniania aplikacji (ADC), aby uzyskać token dostępu do autoryzacji żądania. Więcej informacji znajdziesz w artykule Tworzenie tokena OAuth.
  2. Wygeneruj identyfikator przejazdu: utwórz unikalny identyfikator przejazdu (tripId) w formacie UUIDv4, aby zidentyfikować przejazd na serwerze.
  3. Utwórz ładunek: utwórz ładunek JSON zawierający identyfikatory aplikacji i ustawienia konfiguracji.
  4. Wywołaj metodę CreateTrip: wyślij żądanie POST do interfejsu API z tokenem dostępu w nagłówku i danymi w treści.

Z poniższego przykładu dowiesz się, jak utworzyć przejazd, wysyłając wiadomość CreateTripRequest:

#!/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}"

Konfiguracje opcjonalne

Możesz dostosować dane o podróży, zmieniając te ustawienia w wiadomości CreateTripRequest:

Funkcja Typ Opis
Raportowanie pozostałej trasy boolean

Aby otrzymywać informacje o aktywnej linii łamanej trasy i warunkach na drodze w czasie rzeczywistym, ustaw config.enableRemainingRouteReporting na true.

Kierowcy muszą mieć Waze w wersji 5.20.0.2 lub nowszej na Androidzie, 5.20.0.1 lub nowszej na iOS albo Mapy Google na Androida w wersji 26.27 lub nowszej.

Zgłaszanie zjechania z trasy (tylko Waze) boolean

Aby śledzić, kiedy kierowca zbacza z trasy, ustaw config.enableRouteDeviationReporting na true.

Kierowcy muszą mieć Waze w wersji 5.22 lub nowszej.

Częstotliwość aktualizacji przejazdów boolean

Domyślnie Navigation Connect aktualizuje dane o podróży co 60 sekund. Aby włączyć aktualizacje o wysokiej częstotliwości (co 5 sekund), ustaw dla parametru config.enableHighFrequencyUpdates wartość true.

Generowanie zdarzeń Google Cloud Pub/Sub boolean

Aby włączyć generowanie zdarzeń dotyczących przejazdów za pomocą Google Cloud Pub/Sub, ustaw config.enablePubsub na true. Domyślnie ta funkcja jest wyłączona.

Maska pola Google Cloud Pub/Sub FieldMask

Aby zarządzać rozmiarami ładunków i zmniejszyć obciążenie przetwarzania backendu lub koszty korzystania z Google Cloud Pub/Sub, użyj config.pubsubFieldMask, aby wykluczyć duże pola (takie jak execution.remainingRoute) ze strumienia zdarzeń. Więcej informacji o rozmiarze ładunku danych o pozostałej trasie znajdziesz w artykule Obsługa danych o pozostałej trasie.

Uzyskiwanie tokena przejazdu z odpowiedzi

Metoda CreateTrip zwraca odpowiedź zawierającą uwierzytelniony token przejazdu. Aby autoryzować sesję nawigacji, wyodrębnij ten token z odpowiedzi i przekaż go do aplikacji mobilnej, aby uwzględnić go w adresie URL uruchamiania.

Poniższy przykładowy kod pokazuje przykładową odpowiedź:

{
    "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"
}

Odpowiedź zawiera te wartości:

  • PROJECT_NUMBER: unikalny identyfikator liczbowy projektu. Różni się on od alfanumerycznego identyfikatora projektu, ale reprezentuje ten sam projekt w chmurze Google Cloud.
  • TRIP_ID: identyfikator przejazdu wygenerowany przez backend w formacie UUIDv4.
  • BASE64_ENCODED_TRIP_TOKEN: uwierzytelniony token przejazdu (authToken.token) zwracany przez metodę CreateTrip. Przekaż ten token do aplikacji mobilnej, aby rozpocząć śledzoną szczegółową nawigację w Mapach Google lub Waze.

Co dalej?

Użyj tokena przejazdu, aby uruchomić Mapy Google lub Waze.

Uruchamianie Map Google lub Waze