W tym dokumencie opisano czynności, które należy wykonać, aby zacząć korzystać z Navigation Connect.
Wymagania wstępne
Z tego przewodnika dowiesz się, jak skonfigurować konto Google Cloud i projekt w chmurze Google Cloud z włączonymi płatnościami. Musisz też wiedzieć, jak naliczane są opłaty za korzystanie z interfejsu Navigation Connect API.
- Sprawdź rozliczenia i koszty użytkowania w sekcji Użytkowanie i rozliczenia w Navigation Connect.
-
Sprawdź, czy masz konto Google Cloud.
Zaloguj się w konsoli Google Cloud -
Sprawdź, czy masz projekt Google Cloud z włączonymi płatnościami.
Otwórz stronę Płatności- Wybierz projekt, aby otworzyć stronę Płatności.
-
Na stronie Płatności:
- Jeśli płatności są już włączone w wybranym projekcie i masz tylko jedno konto rozliczeniowe, otworzy się strona Płatności.
- Jeśli masz kilka kont rozliczeniowych, kliknij Przejdź do połączonego konta, aby wyświetlić szczegóły konta rozliczeniowego powiązanego z projektem.
- Jeśli konto rozliczeniowe istnieje, ale nie jest powiązane z projektem, pojawi się prośba o połączenie konta rozliczeniowego z projektem.
- Jeśli nie masz konta rozliczeniowego lub chcesz utworzyć nowe, wybierz Zarządzaj kontami rozliczeniowymi, aby utworzyć nowe konto rozliczeniowe. Więcej informacji znajdziesz w artykule o tworzeniu nowego samoobsługowego konta rozliczeniowego Cloud.
Włączanie interfejsu API i weryfikowanie aplikacji
Ten przewodnik opisuje proces włączania interfejsu Navigation Connect API i weryfikowania aplikacji w konsoli Google Cloud, co umożliwia jej bezpieczną współpracę z Mapami Google i Waze. Aby korzystać z interfejsu Navigation Connect API, musisz przejść ten proces.
1. Włączanie interfejsu Navigation Connect API
Aby włączyć interfejs Navigation Connect API w projekcie w chmurze Google Cloud, użyj konsoli Google Cloud lub polecenia gcloud.
Aby włączyć interfejs API, wykonaj te czynności:
Konsola
Otwórz stronę produktu w konsoli Google Cloud:
Włączanie interfejsu Navigation Connect APIKliknij przycisk Włącz.
gcloud
gcloud services enable \ --project "PROJECT" \ "navigationconnect.googleapis.com"
Więcej informacji o pakiecie SDK Google Cloud, instalacji pakietu SDK Cloud i tych poleceniach:
2. Rozpocznij proces weryfikacji aplikacji
Po włączeniu interfejsu API musisz zweryfikować aplikację, aby aktywować interfejs Navigation Connect API. Samo włączenie interfejsu API nie daje dostępu. Zanim zaczniesz korzystać z interfejsu Navigation Connect API, musisz podać informacje o firmie i aplikacji do sprawdzenia.
Aby rozpocząć proces weryfikacji, użyj jednej z tych metod:
-
API Marketplace:
- W API Marketplace znajdź kartę Navigation Connect API.
- Kliknij niebieską ikonę Wymagana weryfikacja, aby rozpocząć proces weryfikacji.
-
Klucze i dane uwierzytelniające w konsoli Google Cloud:
- W konsoli Google Cloud otwórz stronę Klucze i dane logowania.
- Kliknij Klucze i dane uwierzytelniające Navigation Connect.
- Na banerze kliknij Rozpocznij weryfikację.
3. Podaj informacje o aplikacji, zbieraniu danych i prywatności
W tabeli poniżej znajdziesz informacje, które musisz podać na potrzeby weryfikacji aplikacji:
| Pole | Opis |
|---|---|
| Szczegóły aplikacji Podaj te informacje, aby aplikacja wyświetlała się prawidłowo w Mapach Google i Waze. |
|
| Nazwa firmy lub aplikacji | Wpisz nazwę, która będzie wyświetlana użytkownikom w Mapach Google i Waze. |
| Identyfikator aplikacji | Podaj nazwę pakietu na Androida lub identyfikator pakietu na iOS. |
| Uniwersalny link na iOS | Podaj uniwersalny link na iOS, który umożliwia użytkownikom powrót do Twojej aplikacji (dostępny tylko w Waze). |
| Logo aplikacji (tylko Waze) | (Opcjonalnie) Prześlij logo w formacie PNG lub JPG (od 32 x 32 do 128 x 128 pikseli), aby wyświetlać logo aplikacji w Waze podczas sesji nawigacji. |
| Zbieranie danych i szczegóły dotyczące prywatności Podaj te informacje, aby zapewnić przejrzystość, zaufanie kierowców i bezpieczeństwo danych. |
|
| Link do polityki prywatności | Podaj adres URL polityki prywatności aplikacji. Ten link pojawi się na ekranie zgody. |
| Dodatkowi administratorzy danych (opcjonalnie) | Podaj nazwę handlową i link do polityki prywatności wszystkich zewnętrznych administratorów danych, takich jak ISV. Te informacje są wyświetlane na ekranie zgody. |
| Zgodność danych z przepisami | Jeśli Twoja aplikacja działa w Stanach Zjednoczonych, zaznacz pole wyboru Ta aplikacja będzie używana podczas podróży w Stanach Zjednoczonych, aby zapewnić zgodność z lokalnymi przepisami. |
4. Sprawdź i prześlij
Przed przesłaniem aplikacji do weryfikacji sprawdź podsumowanie podanych informacji.
-
Dokładnie sprawdź nazwę aplikacji, platformę, identyfikatory i linki.
- Zaznacz pole wyboru Wszystkie informacje są prawidłowe.
- Kliknij Prześlij.
Po przesłaniu aplikacji do weryfikacji rozpocznie się faza sprawdzania.
- Czas: weryfikacja trwa zwykle 1–3 dni robocze.
- Powiadomienie: gdy stan weryfikacji się zmieni, otrzymasz e-maila. Otrzymasz też e-maila z prośbą o podanie identyfikatora profilu płatności lub identyfikatora dewelopera aplikacji na Androida. Jeśli potrzebujesz identyfikatora dewelopera aplikacji na Androida, zapoznaj się z artykułem Tworzenie konta dewelopera.
- Śledzenie stanu: postępy możesz sprawdzać na stronie Klucze i dane uwierzytelniające w konsoli Google Cloud.
- Pomoc: aby zaktualizować konfigurację po zatwierdzeniu bez wpływu na środowisko produkcyjne, utwórz zgłoszenie do zespołu pomocy.
Po zweryfikowaniu aplikacja będzie mogła używać interfejsu Navigation Connect API do generowania tokenów podróży, które autoryzują dostęp do sesji nawigacji i umożliwiają otrzymywanie szczegółów podróży z Map Google i Waze.
Usługi Google Maps Platform wymagają, aby wywołania interfejsu API zawierały token OAuth, co zapobiega nieautoryzowanemu użyciu.
Tworzenie tokena OAuth
Navigation Connect obsługuje uwierzytelnianie OAuth 2.0. Google obsługuje typowe scenariusze OAuth 2.0, takie jak scenariusze dotyczące 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 protokołu OAuth w środowisku produkcyjnym znajdziesz w artykule o metodach uwierzytelniania w Google.
Interfejsy API Map Google możesz wywoływać bezpośrednio, wysyłając żądania do interfejsu API do serwera, lub możesz używać bibliotek klienta, aby uprościć kod. Mapy Google udostępniają 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 zarządzać nimi za pomocą protokołu OAuth na kilka sposobów, w zależności od środowiska wdrażania.
Możesz używać protokołu OAuth 2.0 do interakcji między serwerami aplikacji i usługi Google. W tym scenariuszu używasz konta usługi powiązanego z aplikacją, a nie z konkretnym 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 o metodach uwierzytelniania w Google.
Możesz też zintegrować Navigation Connect z aplikacją mobilną na Androida lub iOS. Więcej informacji o używaniu protokołu 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.
zakresów protokołu OAuth
Aby używać protokołu OAuth z 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, i chcesz wypróbować Navigation Connect z tokenem OAuth, wykonaj czynności opisane w tej sekcji.
Ten przykład pokazuje, jak użyć tokena 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 na temat uwierzytelniania za pomocą bibliotek klienta.
Poniższej procedury REST używaj tylko do celów programistycznych lub testowych, a nie produkcyjnych.
Wymagania wstępne
Zanim wyślesz żądanie REST za pomocą domyślnych danych uwierzytelniających aplikacji, użyj interfejsu wiersza poleceń gcloud, aby przekazać dane uwierzytelniające do domyślnych danych uwierzytelniających aplikacji:
Zainstaluj i zainicjuj interfejs wiersza poleceń
gcloud. Więcej informacji znajdziesz w artykule o instalowaniu gcloud CLI.Uwierzytelnij się za pomocą interfejsu wiersza poleceń
gcloud:gcloud auth application-default login
Dokończ proces logowania, aby zapisać dane logowania w lokalnym pliku danych logowania używanym przez ADC.
Więcej informacji znajdziesz w artykule o konfigurowaniu 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-tokenZwrócony token ma zakres
https://www.googleapis.com/auth/cloud-platform.W nagłówku
X-Goog-User-Projectpodaj identyfikator lub nazwę projektu Google Cloud, który ma włączone rozliczenia.
Aby wywołać Navigation Connect za pomocą tokena OAuth, wykonaj te czynności:
W poniższym przykładowym kodzie zastąp obiekty zastępcze swoimi wartościami:
- PROJECT_ID: identyfikator Twojego projektu Google Cloud;
- ANDROID_APP_ID: nazwa pakietu aplikacji na Androida (jeśli dotyczy).
- 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", }'
Aby skopiować polecenie
curl, kliknij Kopiuj w przykładowym kodzie.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 długiej liczby całkowitej,
- TRIP_ID: identyfikator przejazdu UUIDv4 generowany przez backend.
- BASE64_ENCODED_TRIP_TOKEN: uwierzytelniony token zwracany przez metodę
createTripw celu rozpoczęcia śledzonej szczegółowej nawigacji w Mapach Google lub Waze.
Rozwiązywanie problemów
Jeśli żądanie zwróci 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 umożliwić bezpieczną komunikację między serwerami infrastruktury backendu, Map Google i Waze.