Krótkie wprowadzenie do pakietu SDK dla konsumentów na Androida

Pakiet SDK dla konsumentów na Androida jest częścią Fleet Engine do przejazdów na żądanie. Zapewnia interfejsy, które modelują dane o przejazdach i śledzą przejazdy we Fleet Engine, oraz klasy do tworzenia wyświetlacza opartego na mapie, który udostępnia konsumentom w aplikacji na Androida informacje o postępach przejazdu (lokalizacja pojazdu, trasa, szacowany czas dotarcia na miejsce, pozostała odległość, natężenie ruchu).

Pakiet SDK dla konsumentów na Androida: najważniejsze informacje

  • Usługa: pakiet SDK dla konsumentów na Androida
  • Inne nazwy: pakiet SDK dla konsumentów na Androida, pakiet SDK dla konsumentów, pakiet SDK dla konsumentów na Androida do usług mobilności na żądanie
  • Kategoria: trasy
  • Platforma: Android
  • Działa na: kliencie (kod aplikacji lub przeglądarki)
  • Etap uruchomienia: GA
  • Cykl życia: aktywny
  • Omówienie: omówienie pakietu Consumer SDK na Androida

Consumer SDK na Androida: kiedy go używać

Kiedy używać pakietu SDK dla konsumentów na Androida:

  • Chcesz, aby klienci w Twojej aplikacji na Androida mogli śledzić przejazd na żądanie (przejazd, zamówienie lub dostawę), który Twój backend śledzi we Fleet Engine.
  • Musisz wyświetlić na mapie w aplikacji użytkownika na Androida lokalizację pojazdu na drodze i jego trasę w czasie zbliżonym do rzeczywistego.
  • Musisz wyświetlić szacowany czas dotarcia na miejsce odbioru i wysiadki, pozostałą odległość oraz natężenie ruchu w czasie rzeczywistym w przypadku przejazdu Fleet Engine na Androidzie.
  • Musisz dostosować znaczniki przejazdu, linie łamane trasy lub styl mapy na mapie udostępniania przejazdu na Androidzie.

Kiedy nie używać pakietu Consumer SDK na Androida:

  • Potrzebujesz udostępniania przejazdu w przypadku przejazdów na żądanie w aplikacji na iOS. Zamiast tego użyj pakietu SDK Consumer na iOS.
  • Potrzebujesz udostępniania przejazdu na stronie internetowej lub śledzenia przez konsumentów zaplanowanych zadań, takich jak dostawy. Zamiast tego użyj pakietu SDK klienta JavaScript.
  • Musisz zgłaszać lokalizację kierowcy i postępy przejazdu z aplikacji kierowcy na Androida. Zamiast tego użyj pakietu Driver SDK na Androida.

Pakiet SDK dla klientów na Androida: konfiguracja

Oficjalne pakiety Consumer SDK na Androida:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

Pakiet SDK dla konsumentów na Androida: typowe błędy

  • Problem: jeśli zależność pakietu SDK Map nie jest ustawiona na konkretną wersję, pakiet SDK dla konsumentów używa minimalnej wymaganej wersji pakietu SDK Map, co może powodować błędy w aplikacjach, które korzystają z funkcji dostępnych w nowszych wersjach pakietu SDK Map. Rozwiązanie: zadeklaruj wyraźnie zdefiniowaną wersję play-services-maps obok transportation-consumer w Gradle lub Maven. Zobacz /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project.
  • Problem: jeśli nie zatrzymasz udostępniania przejazdu po jego zakończeniu, spowoduje to niepotrzebne żądania sieciowe do Fleet Engine i wycieki pamięci. Rozwiązanie: wywołaj JourneySharingSession.stop(), gdy przejazd nie jest już potrzebny, na przykład w onDestroy() lub gdy przejazd jest COMPLETE. Zobacz /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey.
  • Problem: ConsumerApi.initialize() zgłasza wyjątek, jeśli instancja interfejsu API już istnieje (wersja 2.0.0 i nowsze). Rozwiązanie: najpierw wywołaj ConsumerApi.getInstance() i sprawdź zwrócony Task, aby określić, czy instancja już istnieje. Zobacz /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android.
  • Problem: pakiet Consumer SDK w wersji 3 lub starszej nie obsługuje pełnego trybu R8. W aplikacjach kierowanych na wtyczkę Androida do obsługi Gradle w wersji 8.0 lub nowszej mogą występować problemy z kompilacją lub działaniem. Rozwiązanie: ustaw android.enableR8.fullMode=false, gdy kierujesz na AGP 8.0 lub nowszą wersję, i używaj AGP 7.3 lub nowszej wersji z Kotlinem 2.0 w przypadku pakietu Consumer SDK w wersji 3.0 lub nowszej. Zobacz /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3.

Pakiet SDK dla konsumentów na Androida: funkcje starsze i wycofane

  • ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions: wycofano 15 września 2023 r. Wymiana: TripModel, TripModelCallback, TripModelManager, TripModelOptions. Zobacz przewodnik po migracji.
  • Klasa Trip i adnotacje Trip.TripStatus / Trip.TripType (oraz TripInfo#getTripStatus(), TripInfo#getTripType(), TripModelCallback#onTripStatusUpdated): wycofane 15 września 2023 r. Wymiana: TripInfo.TripStatus / TripInfo.TripType, TripInfo#getCurrentTripStatus(), TripInfo#getCurrentTripType(), TripModelCallback#onTripStatusUpdate. Zobacz przewodnik po migracji.
  • MarkerStyleOptions i PolylineStyleOptions: wycofane od 30 listopada 2021 r. Zamiennik: MarkerOptions i PolylineOptions (udostępniane za pomocą Maps SDK). Objaw: pakiet Consumer SDK stosuje własny domyślny styl dla każdego typu znacznika lub linii łamanej, a nie domyślne ustawienia MarkerOptions. Zobacz przewodnik po migracji.
  • Kanał dystrybucji prywatnego repozytorium: wycofany. Zamiennik: repozytorium Google Maven (wersje 2.1.0 i nowsze). Zobacz przewodnik po migracji.

Co możesz zrobić za pomocą pakietu Consumer 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.