Konfigurowanie Navigation Connect

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Z tego dokumentu dowiesz się, jak zacząć korzystać z Navigation Connect.

Sprawdź, czy spełniasz wymagania wstępne.

Włącz interfejs API w projekcie Google Cloud.

Skonfiguruj OAuth, aby wysłać uwierzytelnione żądanie do interfejsu API.

Usługi Google Maps Platform wymagają, aby wywołania interfejsu API zawierały token OAuth, co zapobiega nieautoryzowanemu użyciu.

Tworzenie tokena OAuth

Interfejs Navigation Connect obsługuje uwierzytelnianie OAuth 2.0. Google obsługuje typowe scenariusze OAuth 2.0, takie jak scenariusze dla serwera WWW.

Z tego dokumentu dowiesz się, jak przekazać token OAuth do wywołania Navigation Connect w środowisku programistycznym. Więcej informacji o używaniu OAuth w środowisku produkcyjnym znajdziesz w artykule Metody uwierzytelniania w Google.

Interfejsy API Map Google możesz wywoływać bezpośrednio, wysyłając żądania API do serwera, lub możesz używać bibliotek klienta, aby uprościć kod. Google Maps udostępnia biblioteki klienta dla języków Go, Java, Node.js i Python. Więcej informacji znajdziesz w artykule Biblioteki klienta Navigation Connect.

Omówienie protokołu OAuth

Tokeny dostępu możesz tworzyć i nimi zarządzać za pomocą protokołu OAuth na kilka sposobów, w zależności od środowiska wdrożenia.

Możesz używać OAuth 2.0 do interakcji między serwerami aplikacji a usługą Google. W tym scenariuszu używasz konta usługi powiązanego z aplikacją, a nie z użytkownikiem. Możesz wysyłać żądania do interfejsu API za pomocą konta usługi bez bezpośredniego angażowania użytkowników. Więcej informacji o metodach uwierzytelniania znajdziesz w artykule Metody uwierzytelniania w Google.

Możesz też zintegrować Navigation Connect z aplikacją mobilną na Androida lub iOS. Więcej informacji o używaniu OAuth i zarządzaniu tokenami dostępu w różnych środowiskach wdrażania znajdziesz w artykule Używanie OAuth 2.0 do korzystania z interfejsów API Google.

Zakresy protokołu OAuth

Aby używać protokołu OAuth z interfejsem Navigation Connect, musisz przypisać tokenowi OAuth ten zakres:

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

Przykład: wypróbuj wywołania interfejsu API REST w lokalnym środowisku programistycznym

Jeśli nie masz środowiska, które generuje tokeny, a chcesz wypróbować Navigation Connect z tokenem OAuth, wykonaj procedurę opisaną w tej sekcji.

W tym przykładzie opisujemy, jak użyć tokena protokołu OAuth dostarczonego przez domyślne uwierzytelnianie aplikacji (ADC) do wykonania wywołania. Więcej informacji o używaniu ADC do wywoływania interfejsów API Google za pomocą bibliotek klienta znajdziesz w artykule Uwierzytelnianie za pomocą bibliotek klienta.

Poniższej procedury REST używaj tylko w środowisku deweloperskim lub testowym, a nie w środowisku produkcyjnym.

Wymagania wstępne

Zanim wyślesz żądanie REST przy użyciu ADC, użyj interfejsu wiersza poleceń gcloud, aby przekazać dane logowania do ADC:

  1. Zainstaluj i zainicjuj interfejs wiersza poleceń gcloud. Więcej informacji znajdziesz w artykule Instalowanie gcloud CLI.

  2. Uwierzytelnij się za pomocą interfejsu wiersza poleceń gcloud:

    gcloud auth application-default login

  3. Dokończ proces logowania, aby zapisać dane logowania w lokalnym pliku danych logowania używanym przez ADC.

Więcej informacji znajdziesz w artykule Konfigurowanie ADC w lokalnym środowisku programistycznym.

Wysyłanie żądania REST

W tym przykładzie przekazujesz 2 nagłówki żądania:

  • Przekaż token OAuth w nagłówku Authorization, używając tego polecenia do wygenerowania tokena:

    gcloud auth application-default print-access-token

    Zwrócony token ma zakres https://www.googleapis.com/auth/cloud-platform.

  • Przekaż identyfikator lub nazwę projektu Google Cloud, w którym włączono płatności, w nagłówku X-Goog-User-Project.

Aby wywołać Navigation Connect za pomocą tokena OAuth, wykonaj te czynności:

  1. W przykładzie kodu poniżej zastąp symbole zastępcze własnymi wartościami:

    • PROJECT_ID: identyfikator Twojego projektu Google Cloud;
    • ANDROID_APP_ID: nazwa pakietu Androida Twojej aplikacji, jeśli ma to zastosowanie
    • IOS_APP_ID: identyfikator pakietu na iOS Twojej aplikacji (jeśli dotyczy).
    #!/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. Aby skopiować polecenie curl, w przykładowym kodzie kliknij Kopiuj.

  3. Wklej polecenie w oknie terminala, a następnie je uruchom.

Odpowiedzią jest obiekt JSON:

{
  "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 projektu w postaci liczby całkowitej długiej.
  • TRIP_ID: identyfikator przejazdu UUIDv4 wygenerowany przez Twój backend.
  • BASE64_ENCODED_TRIP_TOKEN: uwierzytelniony token, który metoda createTrip zwraca w celu rozpoczęcia śledzonej nawigacji krok po kroku w Mapach Google lub Waze.

Rozwiązywanie problemów

Jeśli w odpowiedzi na Twoje żądanie pojawi się komunikat o błędzie informujący, że ten interfejs API nie obsługuje danych logowania użytkownika, zapoznaj się z artykułem Rozwiązywanie problemów z konfiguracją ADC.

Co dalej?

Następnie skonfiguruj konta usługi dla interfejsu Navigation Connect API, aby obsługiwać bezpieczną komunikację między serwerami w infrastrukturze backendu, Mapami Google i Waze.

Konfigurowanie konta usługi