Pakiet SDK sterowników na Androida to mobilny zestaw narzędzi do aplikacji dla kierowców, który wysyła do Fleet Engine lokalizację pojazdu, trasę, pozostałą odległość i szacowany czas dotarcia na miejsce z pakietu SDK do nawigacji. Obsługuje zarówno przejazdy na żądanie, jak i zaplanowane zadania.
Pakiet SDK dla kierowców na Androida: najważniejsze informacje
- Usługa: pakiet SDK dla kierowców na Androida
- Inne nazwy: pakiet SDK dla kierowców, pakiet SDK dla kierowców do przejazdów na żądanie, pakiet SDK dla kierowców do zaplanowanych zadań
- Kategoria: Trasy
- Platforma: Android
- Działa na: kliencie (kod aplikacji lub przeglądarki)
- Etap uruchomienia: GA
- Cykl życia: aktywny
- Omówienie: omówienie pakietu Driver SDK na Androida
Pakiet SDK sterowników na Androida: kiedy go używać
Kiedy używać pakietu Driver SDK na Androida:
- Aplikacja kierowcy na Androida jest potrzebna do wysyłania do Fleet Engine aktualizacji lokalizacji pojazdu i trasy w czasie rzeczywistym.
- Aby otrzymywać z pakietu Navigation SDK informacje o pozostałej odległości i szacowanym czasie dotarcia do następnego punktu, musisz mieć Fleet Engine.
- Potrzebujesz jednej aplikacji dla kierowców, która zarządza przypisanymi przejazdami na żądanie lub zaplanowanymi zadaniami i zapewnia nawigację.
Nie używaj pakietu Driver SDK na Androida, gdy:
- Potrzebujesz tylko szczegółowych wskazówek dojazdu w aplikacji i nie korzystasz z Fleet Engine. Zamiast tego użyj pakietu Navigation SDK na Androida.
- Musisz wysyłać aktualizacje danych pojazdu inne niż lokalizacja, trasa, odległość i szacowany czas dotarcia na miejsce (te dane są przesyłane przez backend). Zamiast tego użyj usługi Fleet Engine.
- Tworzysz aplikację dla kierowców na iOS. Zamiast tego użyj pakietu Driver SDK na iOS.
Pakiet SDK Driver na Androida: konfiguracja
- Uwierzytelnianie: klucz interfejsu API, token internetowy JSON (JWT)
- Włącz też: Maps SDK na Androida
- Pierwsze kroki: skonfiguruj pakiet Driver SDK na Androida
- Dokumentacja: dokumentacja pakietu Driver SDK na Androida
- Zasady: Zasady dotyczące pakietu Driver SDK na Androida
- Informacje o wersji: informacje o wersji pakietu Driver SDK na Androida
Oficjalne pakiety Driver SDK na Androida:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-driver - maven:
com.google.android.libraries.navigation:navigation
Pakiet SDK dla kierowców na Androida: produkty powiązane
- Często używane z: Navigation SDK for Android, Fleet Engine Service
Pakiet SDK dla kierowców na Androida: typowe błędy
- Problem: jeśli zależności kompilacji nie określają wersji pakietu Driver SDK, IDE wczytuje najnowszą wersję. Od wersji 7.0.0 nowe kompilacje nie obsługują już Androida 6 i 7 (API 23–25). Rozwiązanie: w zależnościach kompilacji określ wersję pakietu Driver SDK na Androida, aby kontrolować, kiedy zmienia się minimalna obsługiwana wersja systemu operacyjnego. Zobacz /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android.
- Problem: pakiet Driver SDK zależy od pakietu Navigation SDK. Bez przypiętej wersji pakietu Navigation SDK projekt zawsze pobiera najnowszą wersję główną pakietu Navigation SDK. Rozwiązanie: dodaj zależności pakietu Driver SDK i Navigation SDK. Jeśli przypinasz pakiet Navigation SDK, wybierz wersję z zakresu podanego w informacjach o wersji pakietu Driver SDK (np. [7.0, 8.0) w przypadku pakietu Driver SDK 7.1). Zobacz /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project.
- Problem: pakiet SDK żąda tokenów autoryzacji przez
AuthTokenFactoryw momencie informacja o zmianie lokalizacji. Jeśli Twój serwer nie może wystawiać tokenów JWT, aktualizacje Fleet Engine nie mogą zostać autoryzowane. Rozwiązanie: upewnij się, że implementacja po stronie serwera może wydawać tokeny przed zainicjowaniem pakietu SDK, i używaj tokenów ponownie, dopóki nie wygasną. Zobacz /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate. - Problem: kompilacje ProGuard mogą generować ostrzeżenia dotyczące klas
com.google,io.grpciokio. Rozwiązanie: dodaj-dontwarn com.google.**,-dontwarn io.grpc.**i-dontwarn okio.**do konfiguracji ProGuard. Zobacz /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies.
Pakiet SDK dla kierowców na Androida: funkcje starsze i wycofane
- Interfejs
StatusListener: wycofany 25 listopada 2024 r. Wymiana:DriverStatusListener. Symptom: usunięto w pakiecie Driver SDK na Androida w wersji 6.0.0. Zobacz przewodnik po migracji. - Nav/Driver SDK na Androida w wersji 1.x (połączony plik binarny): wycofany 21 czerwca 2022 r. Zamiennik: oddzielne pliki binarne pakietu Driver SDK w wersji 3 lub nowszej i pakietu Navigation SDK. Objaw: wycofano 21 czerwca 2021 r. i nie jest obsługiwane po 21 czerwca 2022 r.; metody takie jak
Waypoint#fromLatLngiNavigator#startGuidance(resumeIntent)zostały usunięte w wersji 3.0. Zobacz przewodnik po migracji. AuthTokenContextServiceType: wycofany 29 listopada 2021 r. Zastąpienie: roszczenia dotyczące uwzględnionego identyfikatora pojazdu i identyfikatora zadania. Objaw: usunięto w wersji 4.0.0:ServiceTypeigetServiceType()zAuthTokenContextorazsetServiceTypezAuthTokenContext.Builder. Zobacz przewodnik po migracji.- Właściwość
TaskparentId: wycofana 28 kwietnia 2022 r. Wymiana:trackingId. Symptom: zmieniono nazwę w wersji 4.1.0; stara właściwość nadal istnieje, ale jest wycofana.
Co możesz zrobić za pomocą pakietu Driver SDK na Androida
Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.
- Zgłaszanie pozycji pojazdu w czasie rzeczywistym do usługi Fleet Engine.
- Zgłaszanie współrzędnych szerokości i długości geograficznej punktów trasy przejazdu pojazdu z pakietu Navigation SDK do usługi Fleet Engine.
- Zgłaszanie do usługi Fleet Engine pozostałej odległości pojazdu do następnego punktu na trasie.
- Zgłaszanie do usługi Fleet Engine szacowanego czasu dotarcia pojazdu do następnego punktu na trasie.
- Zgłaszanie do usługi Fleet Engine trasy podanej dla pojazdu przez pakiet Navigation SDK.