Krótkie wprowadzenie do pakietu Driver SDK na Androida

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

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: 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 AuthTokenFactory w 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.grpc i okio. 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#fromLatLng i Navigator#startGuidance(resumeIntent) zostały usunięte w wersji 3.0. Zobacz przewodnik po migracji.
  • AuthTokenContext ServiceType: 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: ServiceType i getServiceType() z AuthTokenContext oraz setServiceType z AuthTokenContext.Builder. Zobacz przewodnik po migracji.
  • Właściwość Task parentId: 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.