Omówienie interfejsu Navigation Connect API

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Navigation Connect API to usługa, która łączy korzystanie przez kierowcę z nawigacji w Mapach Google i Waze z systemami firmowymi. Używa tokenów autoryzacji podróży wraz z precyzyjnym linkiem w aplikacji, dzięki czemu kierowca może kliknąć link lub przycisk, aby rozpocząć nawigację w wybranej przez siebie aplikacji użytkownika. Gdy kierowca korzysta z nawigacji podczas podróży, możesz otrzymywać bieżące dane o lokalizacji w czasie rzeczywistym, takie jak lokalizacje na żywo, bardzo dokładne szacowane czasy dotarcia i stany cyklu życia podróży.

Navigation Connect API to uproszczona alternatywa dla Navigation SDK. Do wyznaczania trasy używa samodzielnych aplikacji Mapy Google i Waze, dzięki czemu nie musisz tworzyć i umieszczać w aplikacji niestandardowego interfejsu nawigacji. Bezpiecznie łączy sesję kierowcy z Twoim backendem. Gdy kierowca rozpoczyna podróż, widzi znany sobie interfejs nawigacji z 2 dodatkami: prośbą o zgodę na udostępnianie danych o podróży (wymaganą co 12 miesięcy) oraz markowym przyciskiem Wstecz, aby powrócić do Twojej aplikacji.

Dlaczego warto używać Navigation Connect API

Dzięki Navigation Connect API możesz zintegrować aktualizacje lokalizacji i szacowanego czasu dotarcia na miejsce w czasie rzeczywistym z Map Google lub Waze bezpośrednio z procesami backendu. Pomaga to podejmować ważne decyzje biznesowe i udostępniać klientom dokładne aktualizacje, a kierowcy mogą korzystać z preferowanej aplikacji nawigacyjnej – Map Google lub Waze.

Przykładowe przypadki użycia:

  • Zwiększenie przejrzystości w zakresie wspólnych przejazdów: udostępniaj klientom i pasażerom dokładne informacje o lokalizacji kierowcy i szacowanym czasie dotarcia w czasie rzeczywistym.
  • Ulepszenie śledzenia dostaw: informuj klientów o dokładnych czasach dostawy przesyłki lub jedzenia na podstawie danych o aktualnym natężeniu ruchu i wyznaczaniu trasy w czasie rzeczywistym.
  • Ulepszenie zarządzania flotą i dysponowania pojazdami: podejmuj świadome decyzje dotyczące dysponowania flotą lub pracownikami mobilnymi świadczącymi usługi na żądanie (np. pomoc drogową, konserwację lub transport) dzięki śledzeniu lokalizacji kierowców w czasie rzeczywistym.

Co możesz robić za pomocą Navigation Connect API

Navigation Connect API umożliwia otrzymywanie aktualizacji lokalizacji i szacowanego czasu dotarcia w czasie rzeczywistym z Map Google lub Waze bezpośrednio w backendzie.

  • Nienachalne śledzenie podróży: śledź podróże bez zmiany wyboru kierowcy dotyczącego korzystania z Map Google lub Waze ani modyfikowania jego komfortu użytkowania.
  • Dostęp do bieżącej lokalizacji: przez cały czas trwania podróży otrzymuj informacje o bieżącej lokalizacji kierowcy, pozostałym dystansie i czasie, który upłynął.
  • Monitorowanie cyklu życia podróży: skonfiguruj częstotliwość aktualizacji danych o podróży, aby śledzić dokładny stan podróży i natychmiast wiedzieć, kiedy kierowca jest w drodze, dotarł na miejsce lub zawiesił podróż.
  • Wykorzystywanie i udostępnianie szacowanych czasów dotarcia: pobieraj bardzo dokładne szacowane czasy dotarcia generowane przez algorytmy wyznaczania trasy w czasie rzeczywistym Google.
  • Śledzenie pozostałej trasy i natężenia ruchu (tylko Waze): otrzymuj aktywną linię łamaną trasy i informacje o natężeniu ruchu w czasie rzeczywistym od bieżącej lokalizacji kierowcy do miejsca docelowego, dokładnie tak jak są one wyświetlane w Waze.
    • Dynamiczne przycinanie: gdy pojazd się porusza, Navigation Connect automatycznie przycina aktywną linię łamaną trasy, aby zapewnić, że otrzymujesz tylko pozostałą część podróży.
    • Częstotliwość aktualizacji: trasa i warunki na drodze są aktualizowane automatycznie po ponownym obliczeniu trasy, proaktywnym przekierowaniu po stronie klienta lub zmianie warunków na drodze.
  • Elastyczne pozyskiwanie danych: korzystaj z danych o podróży w czasie rzeczywistym za pomocą bezpośrednich wywołań REST API lub przesyłaj strumieniowo aktualizacje za pomocą subskrypcji Google Cloud Pub/Sub.

Jak działa Navigation Connect API

Navigation Connect API akceptuje żądanie CreateTrip zawierające identyfikatory aplikacji mobilnej i konfigurację sesji. Usługa generuje unikalną instancję podróży i zwraca token podróży. Ten token jest następnie dołączany do precyzyjnego linku Map Google lub Waze. Gdy kierowca uruchomi nawigację i wyrazi zgodę, usługa przetwarza dane nawigacyjne w czasie rzeczywistym i zwraca aktualizacje telemetryczne, w tym lokalizację, szacowany czas dotarcia i pozostały dystans.

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych za pomocą Navigation Connect API oraz zwracanych przez nie danych. Szczegółowe informacje znajdziesz w dokumentacji Navigation Connect API.

Zasoby danych Zwracane dane

Identyfikatory uwierzytelniania i aplikacji mobilnej w formacie JSON.

Zobacz Tworzenie podróży.

Unikalny token podróży używany do inicjowania połączenia w Mapach Google lub Waze.

Zobacz Uruchamianie Map Google lub Waze.

Unikalny identyfikator podróży oraz metoda pull lub push w formacie JSON.

Zobacz Pobieranie danych o podróży.

Dane telemetryczne o podróży w czasie rzeczywistym, w tym:

  • stan podróży i metadane;
  • bieżąca lokalizacja (szerokość i długość geograficzna);
  • szacowany czas dotarcia na miejsce;
  • pozostały dystans i czas.

Zobacz Obsługa danych o podróży.

Jak korzystać z Navigation Connect API

1 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i wykonaj kolejne instrukcje.
2 Tworzenie podróży Wyślij wywołanie interfejsu Navigation Connect API, aby utworzyć podróż z unikalnym identyfikatorem, i zapisz token.
3 Uruchamianie Map Google lub Waze Przekaż token podróży i uruchom Mapy Google lub Waze, aby włączyć udostępnianie danych o podróży.
4 Pobieranie danych o podróży Wyślij wywołanie Navigation Connect API, aby pobrać dane o podróży. Opcjonalnie możesz zasubskrybować aktualizacje za pomocą Google Cloud Pub/Sub.
5 Obsługa danych o podróży Dowiedz się, jak obsługiwać stan podróży i inne dane o podróży.