Omówienie konfiguracji i wymagania

W tym dokumencie opisujemy proces konfigurowania interfejsu Navigation Connect API i wymieniamy wymagania dotyczące urządzenia kierowcy, które musi on spełniać, aby korzystać z tego interfejsu.

Proces konfiguracji Navigation Connect

Zanim zaczniesz korzystać z interfejsu Navigation Connect API, musisz wykonać te czynności konfiguracyjne:

  1. Utwórz i skonfiguruj projekt w chmurze Google.
  2. Włącz interfejs Navigation Connect API i zweryfikuj aplikację.
  3. Skonfiguruj OAuth, aby utworzyć tokeny OAuth.
  4. Skonfiguruj konto usługi, aby umożliwić komunikację między infrastrukturą backendu a Mapami Google lub Waze.

Minimalne wymagania dotyczące urządzeń do korzystania z Navigation Connect

Te wymagania są niezbędne, aby urządzenie kierowcy mogło pomyślnie uruchomić sesję Navigation Connect. Sesja używa interfejsu Navigation Connect API do wysyłania do serwera backendu danych o podróży w czasie rzeczywistym, takich jak lokalizacja i szacowany czas dotarcia.

Obsługiwane wersje aplikacji

Na urządzeniu musi być zainstalowana aplikacja Waze lub Mapy Google na Androida. W tabeli poniżej znajdziesz minimalną wersję każdej aplikacji wymaganą do korzystania z Navigation Connect i funkcji, które wymagają nowszej wersji.

Aplikacja Wersja minimalna Raportowanie pozostałej trasy Zgłaszanie zjechania z trasy
Waze na Androida 5.15.5 5.20.0.2 5.22
Waze na iOS 5.15.5 5.20.0.1 5.22
Mapy Google na Androida 26.14 26,27 Nieobsługiwane

Dokładna lokalizacja jest włączona

Poproś kierowcę o włączenie na urządzeniu uprawnień do dokładnej lokalizacji. Waze i Mapy Google wymagają dokładnej lokalizacji, aby rozpocząć nawigację.

Okno z prośbą o zgodę na przetwarzanie danych osobowych kierowcy.

Navigation Connect wymaga zgody kierowcy na udostępnianie danych o podróży. Nie musisz wywoływać okna z prośbą o zgodę na przetwarzanie danych osobowych – Mapy Google lub Waze automatycznie obsługują ten interfejs użytkownika.

Podczas pierwszej podróży rozpoczętej w Twojej aplikacji Mapy Google lub Waze poproszą kierowcę o udostępnienie danych o podróży.

  • Jeśli kierowca kliknie Zezwól, Navigation Connect zacznie udostępniać Twojemu backendowi bieżącą lokalizację i szacowany czas dotarcia na miejsce.
  • Jeśli kierowca kliknie Nie zezwalaj lub później wycofa zgodę, Mapy Google lub Waze będą podawać szczegółowe wskazówki dojazdu, ale Navigation Connect nie będzie wysyłać danych. Backend otrzyma stan CLIENT_ERROR w ładunku danych o przejeździe.

Kierowcy muszą ponownie potwierdzać tę zgodę co 12 miesięcy.

Co dalej?

Pierwszym krokiem podczas konfigurowania interfejsu Navigation Connect API jest utworzenie i skonfigurowanie projektu w chmurze Google.