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 rozpoczyna podróż, widzi znajomy interfejs nawigacji z 2 dodatkami: prośbą o zgodę na udostępnianie danych o podróży (wymaganą co 12 miesięcy) i oznaczonym przyciskiem Wstecz, który umożliwia powrót do aplikacji.
Dlaczego warto korzystać z interfejsu Navigation Connect API
Dzięki Navigation Connect API możesz zintegrować aktualizacje lokalizacji przejazdu 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ększenie przejrzystości usług przewozu osób: zapewnij klientom i pasażerom usług przewozu osób dokładne aktualizacje w czasie rzeczywistym dotyczące lokalizacji kierowcy i szacowanego czasu przyjazdu.
- 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 (np. pomoc drogową, konserwację lub transport) dzięki śledzeniu lokalizacji kierowców na żywo.
Możliwości interfejsu Navigation Connect API
Interfejs Navigation Connect API umożliwia otrzymywanie aktualizacji dotyczących bieżącej lokalizacji i szacowanego czasu dotarcia na miejsce z Map Google lub Waze bezpośrednio w backendzie.
- Ś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 przejazdu, aby śledzić dokładny stan przejazdu i natychmiast otrzymywać informacje o tym, kiedy kierowca jest w drodze, dotarł na miejsce lub zawiesił przejazd.
- Wykorzystywanie i udostępnianie szacowanego czasu dotarcia na miejsce: otrzymuj informacje o szacowanym czasie dotarcia na miejsce z wysoką dokładnością dzięki algorytmom Google do wyznaczania tras na żywo.
- Śledzenie pozostałej części trasy i warunków na drodze:
otrzymuj linię łamaną pozostałej części trasy i informacje o warunkach na drodze w czasie rzeczywistym od
bieżącej lokalizacji kierowcy do miejsca docelowego, dokładnie tak jak
są one wyświetlane w Mapach Google lub Waze. Ta funkcja aktywuje SKU Navigation Connect Enterprise.
- Dynamiczne przycinanie: gdy pojazd się porusza, Navigation Connect automatycznie przycina aktywną polilinię trasy kierowcy (całą trasę, którą kierowca pokonuje w aplikacji), aby zapewnić, że otrzymasz tylko pozostałą trasę (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 zmianie warunków na drodze.
- Śledzenie odchyleń od trasy (tylko Waze): wykrywaj, kiedy kierowca zbacza z trasy, określaj dokładną lokalizację i czas odchylenia oraz sprawdzaj, czy odchylenie zostało zainicjowane przez kierowcę (np. niewłaściwy skręt) czy przez system (np. zmiana trasy z powodu korka). Ta funkcja aktywuje SKU Navigation Connect Enterprise.
- Elastyczne pozyskiwanie danych: korzystaj z danych o podróży w czasie rzeczywistym za pomocą bezpośrednich wywołań interfejsu REST API lub wydajnie przesyłaj aktualizacje strumieniowo 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 przetwarza dane nawigacyjne w czasie rzeczywistym i zwraca 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 przejazdu. |
Unikalny token podróży używany do inicjowania połączenia w Mapach Google lub Waze. Zobacz Uruchamianie Map Google lub Waze. |
|
Unikalny identyfikator przejazdu oraz metoda pobierania lub wysyłania w formacie JSON. Zobacz Pobieranie danych o podróży. |
telemetria podróży w czasie rzeczywistym, w tym:
Zobacz Przetwarzanie danych o podróży. |
Jak korzystać z interfejsu Navigation Connect API
| 1 | Konfiguracja | Zacznij od sekcji Skonfiguruj projekt Google Cloud i postępuj zgodnie z instrukcjami. |
| 2 | Tworzenie przejazdu | Wyślij wywołanie interfejsu Navigation Connect API, aby utworzyć podróż z niepowtarzalnym 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 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 dotyczącymi podróży. |