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
- Uwierzytelnianie: token internetowy JSON (JWT), klucz interfejsu API
- Włącz też: Fleet Engine Service, Maps SDK na Androida
- Pierwsze kroki: skonfiguruj pakiet SDK dla konsumentów na Androida
- Dokumentacja: dokumentacja pakietu SDK dla konsumentów na Androida
- Zasady: Zasady dotyczące pakietu SDK dla konsumentów na Androida
- Informacje o wersji: Informacje o wersji pakietu Consumer SDK na Androida
Oficjalne pakiety Consumer SDK na Androida:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
Consumer SDK na Androida: produkty powiązane
- Często używane z: Fleet Engine Service, Driver SDK for Android, Maps SDK na Androida
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-mapsoboktransportation-consumerw 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 wonDestroy()lub gdy przejazd jestCOMPLETE. 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łajConsumerApi.getInstance()i sprawdź zwróconyTask, 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
Tripi adnotacjeTrip.TripStatus/Trip.TripType(orazTripInfo#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. MarkerStyleOptionsiPolylineStyleOptions: wycofane od 30 listopada 2021 r. Zamiennik:MarkerOptionsiPolylineOptions(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 ustawieniaMarkerOptions. 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.
- Dodaj do aplikacji mobilnej dostosowywaną, interaktywną mapę, która śledzi postęp przejazdu z Fleet Engine.
- Dodaj linię łamaną trasy, która śledzi przejazd z Fleet Engine, do mapy na stronie internetowej lub w aplikacji mobilnej.
- Aktualizowanie postępów przejazdu na trasie na mapie na stronie internetowej lub w aplikacji mobilnej w przypadku przejazdu w Fleet Engine.
- Zmień styl dróg, linii łamanych i wielokątów na mapie, która śledzi postęp przejazdu z Fleet Engine.
- Wyświetlanie lub ukrywanie obiektów na mapie, która śledzi postęp przejazdu z Fleet Engine.
- Zmienianie stylu ikon i etykiet tekstowych na mapie, która śledzi postęp przejazdu z Fleet Engine.
- Zastosuj różne style mapy do różnych poziomów powiększenia na mapie, która śledzi postęp przejazdu z silnika floty.
- Zmienianie gęstości miejsc na mapie, która śledzi postęp przejazdu z Fleet Engine. Eksperymentalna Uwaga: obsługa definiowania stylów map w Google Cloud w pakiecie SDK dla konsumentów jest ogólnie dostępna, natomiast kontrola gęstości ciekawych miejsc to eksperymentalna funkcja definiowania stylów map w Google Cloud (obsługiwana tylko w przypadku jasnych stylów map).
- Zmień styl budynków na mapie, która śledzi postęp podróży z Fleet Engine. Wersja eksperymentalna Uwaga: obsługa definiowania stylów map w Google Cloud w pakiecie Consumer SDK jest ogólnie dostępna, natomiast dostosowywanie stylu budynków 3D i ich obrysów to eksperymentalna funkcja definiowania stylów map w Google Cloud (obsługiwana tylko w przypadku jasnych stylów map).
- Zmienianie stylu punktów orientacyjnych na mapie, która śledzi postęp przejazdu z Fleet Engine. Eksperymentalna Uwaga: obsługa definiowania stylów map w Google Cloud w pakiecie SDK dla klientów jest ogólnie dostępna, natomiast dostosowywanie ikon punktów orientacyjnych to eksperymentalna funkcja definiowania stylów map w Google Cloud (obsługiwana tylko w przypadku jasnych stylów map).
- Dostosuj znacznik na mapie, który śledzi postęp przejazdu z Fleet Engine.
- Dostosuj linię łamaną trasy na mapie, która śledzi postęp przejazdu z Fleet Engine.