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 Twojej firmy. Wykorzystuje tokeny autoryzacji przejazdu 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 przejazdu, możesz otrzymywać bieżące dane o lokalizacji w czasie rzeczywistym, takie jak lokalizacja na żywo, bardzo dokładne szacowane czasy dotarcia i stany cyklu życia przejazdu.

Navigation Connect API to uproszczona alternatywa dla Navigation SDK. Korzysta z samodzielnych aplikacji Mapy Google i Waze do wyznaczania tras, zamiast wymagać tworzenia i umieszczania w aplikacji niestandardowego interfejsu nawigacji. Bezpiecznie łączy sesję kierowcy z Twoim backendem. Gdy kierowca rozpocznie przejazd, zobaczy znany interfejs nawigacji z 2 dodatkowymi elementami: prośbą o zgodę na udostępnianie danych o podróży (wymaganą co 12 miesięcy) i przyciskiem wstecz z logo, który umożliwia powrót do Twojej aplikacji.

Dlaczego warto korzystać z interfejsu Navigation Connect API

Dzięki Navigation Connect API możesz zintegrować aktualizacje lokalizacji podróży i szacowanego czasu dotarcia na miejsce w czasie rzeczywistym z Map Google lub Waze bezpośrednio z procesami backendu. Dzięki temu możesz podejmować kluczowe decyzje biznesowe i udostępniać klientom aktualne informacje, a kierowcy mogą korzystać z ulubionej aplikacji do nawigacji, czyli Map Google lub Waze.

Przykładowe przypadki użycia:

  • Zwiększ przejrzystość usług przewozu osób: udostępniaj klientom i pasażerom usług przewozu osób dokładne informacje o lokalizacji kierowcy i szacowanym czasie przyjazdu w czasie rzeczywistym.
  • Ulepszone śledzenie dostawy: informuj klientów o dokładnym czasie dostawy przesyłki lub jedzenia na podstawie danych o aktualnym natężeniu ruchu i trasach w czasie rzeczywistym.
  • Usprawnij zarządzanie flotą i dysponowanie pojazdami: podejmuj świadome decyzje dotyczące dysponowania flotami lub mobilnymi zespołami pracowników świadczącymi usługi na żądanie (takie jak pomoc drogowa, konserwacja czy transport) dzięki śledzeniu lokalizacji kierowców na żywo.

Możliwości interfejsu Navigation Connect API

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

  • Śledzenie przejazdów w sposób nieinwazyjny: śledź przejazdy bez zmiany wyboru kierowcy dotyczącego korzystania z Map Google lub Waze ani modyfikowania jego wygody.
  • Dostęp do danych o lokalizacji w czasie rzeczywistym: podczas podróży możesz na bieżąco sprawdzać lokalizację kierowcy, pozostałą odległość i czas, który upłynął.
  • Monitorowanie cyklu życia przejazdu: skonfiguruj częstotliwość aktualizacji danych o podróży, aby śledzić dokładny stan przejazdu i natychmiast wiedzieć, kiedy kierowca jest w drodze, dotarł na miejsce lub zawiesił przejazd.
  • Wykorzystywanie i udostępnianie szacowanego czasu dotarcia: pobieraj bardzo dokładne aktualizacje szacowanego czasu dotarcia oparte na algorytmach Google do wyznaczania tras na żywo.
  • Śledzenie pozostałej części trasy i ruchu (tylko Waze): otrzymywanie pozostałej części trasy w postaci linii łamanej oraz informacji o warunkach na drodze 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ą polilinię trasy kierowcy (pełną trasę, po której obecnie porusza się aplikacja), aby zapewnić, że otrzymasz tylko pozostałą część trasy (odcinek od bieżącej pozycji kierowcy do miejsca docelowego).
    • Częstotliwość aktualizacji: trasa i warunki na drodze są aktualizowane automatycznie po ponownym obliczeniu trasy, aktywnym przekierowaniu po stronie klienta lub zmianach warunków na drodze.
  • Elastyczne pozyskiwanie danych: korzystaj z danych o przejazdach w czasie rzeczywistym za pomocą bezpośrednich wywołań interfejsu REST API lub przesyłaj strumieniowo aktualizacje w wydajny sposób za pomocą subskrypcji Google Cloud Pub/Sub.

Jak działa interfejs Navigation Connect API

Interfejs Navigation Connect API akceptuje CreateTrip zawierające identyfikatory aplikacji mobilnej i konfigurację sesji. Usługa generuje unikalną instancję przejazdu i zwraca token przejazdu. Ten token jest następnie dołączany do precyzyjnego linku do Map Google lub Waze. Gdy kierowca uruchomi nawigację i wyrazi zgodę, usługa przetworzy dane nawigacyjne w czasie rzeczywistym i zwróci aktualizacje telemetryczne, w tym lokalizację, szacowany czas dotarcia na miejsce i pozostałą odległość.

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w interfejsie Navigation Connect API wraz z danymi, które zwraca. Szczegółowe informacje znajdziesz w dokumentacji interfejsu Navigation Connect API.

Zasoby danych Zwrócone dane

Uwierzytelnianie i identyfikatory aplikacji mobilnych 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 przejazdu i metoda pobierania lub wysyłania w formacie JSON.

Zobacz Pobieranie danych o podróży.

dane telemetryczne dotyczące przejazdu w czasie rzeczywistym, w tym:

  • Stan przejazdu i metadane
  • Bieżąca lokalizacja (szerokość/długość geograficzna)
  • Szacowany czas dotarcia (ETA)
  • Pozostała odległość i czas

Zobacz Zarządzanie danymi o podróży.

Jak korzystać z interfejsu Navigation Connect API

1 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i postępuj zgodnie z dalszymi instrukcjami.
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 otwórz Mapy Google lub Waze, aby włączyć udostępnianie danych o podróży.
4 Pobieranie danych o podróży Wyślij wywołanie interfejsu Navigation Connect API, aby pobrać dane o podróży. Opcjonalnie możesz zasubskrybować aktualizacje za pomocą Google Cloud Pub/Sub.
5 Przetwarzanie danych o podróży Dowiedz się, jak zarządzać stanem podróży i innymi danymi o podróży.