Omówienie konfiguracji i wymagania

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

Proces konfiguracji Navigation Connect

Aby 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 tworzyć 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ądzenia, aby korzystać z Navigation Connect

Te wymagania są niezbędne, aby sesja Navigation Connect mogła działać na urządzeniu kierowcy. 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 Waze w wersji 5.15.5 lub nowszej albo Mapy Google w wersji 26.14 lub nowszej.

Włączona dokładna lokalizacja

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

Okno z prośbą o zgodę 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 zainicjowanej z 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ć backendowi dane o lokalizacji i szacowanym czasie przybycia w czasie rzeczywistym.
  • Jeśli kierowca kliknie Nie zezwalaj lub później wycofa zgodę, Mapy Google lub Waze będą wyświetlać wskazówki nawigacyjne, ale Navigation Connect nie będzie wysyłać danych. Backend otrzyma w ładunku danych o podróży stan CLIENT_ERROR.

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

Co dalej?

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