Klient Fleet Engine firmy Google.
W ramach tej klasy rozmówca może enable
i disableLocationTracking()
wyłączyć śledzenie lokalizacji. Częstotliwość aktualizacji można kontrolować za pomocą setLocationReportingInterval(long, TimeUnit)
.
Te zajęcia nie są bezpieczne w wątku.
Podsumowanie zagnieżdżonych zajęć
interfejs, | FleetEngine.AuthTokenFactory | Instancje tego interfejsu będą prosić o podanie tokena autoryzacji podczas wykonywania różnych operacji. | |
klasa | FleetEngine.ErrorListener | Klient Fleet Engine będzie używać instancji tego interfejsu, aby informować dewelopera o ważnych wyjątkach. | |
interfejs, | FleetEngine.FleetEngineConfig | Ten interfejs został wycofany. starsza wersja webhooka | |
interfejs, | FleetEngine.StatusListener | Nasłuchujący aktualne informacje o stanie. | |
enum | typ wyliczeniowy | FleetEngine.VehicleState | Wskazuje, czy pojazd przyjmuje nowe przejazdy. |
Podsumowanie metod publicznych
statyczny stan nieważny |
clearInstance()
Czyszczenie instancji zatrzymuje śledzenie lokalizacji, czyści wewnętrzny stan i resetuje singleton FleetEngine do wartości null.
|
statyczny stan nieważny |
createInstance(aplikacja aplikacji, identyfikator dostawcy ciągu, identyfikator pojazdu w ciągu znaków, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)
Tworzy singleton
FleetEngine , który umożliwia dostęp do usługi Google Fleet Engine. |
statyczny stan nieważny |
createInstance(aplikacja aplikacji, identyfikator dostawcy ciągu, identyfikator pojazdu w ciągu znaków, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)
Tworzy singleton
FleetEngine , który umożliwia dostęp do usługi Google Fleet Engine. |
void |
disableLocationTracking()
Przerywa śledzenie lokalizacji.
|
void |
enableLocationTracking()
Zacznij przesyłać raporty o pozycji do backendu Fleet Engine.
|
statyczny FleetEngine |
getInstance()
Zwraca singleton FleetEngine.
|
długi |
getLocationReportingIntervalMs()
Zwraca bieżący interwał raportowania lokalizacji w milisekundach.
|
boolean |
isLocationTrackingEnabled()
Wskazuje, czy śledzenie lokalizacji jest włączone.
|
statyczny stan nieważny |
setFleetEngineConfig(konfiguracja FleetEngine.FleetEngineConfig)
|
void |
setLocationReportingInterval(długi interwał, TimeUnit interUnits)
Określa minimalny odstęp czasu, po którym raporty o lokalizacji będą dostarczane do backendu Fleet Engine.
|
statyczny stan nieważny |
setNavigator(nawigator Navigator)
|
void |
Podsumowanie metod dziedziczonych
Metody publiczne
public static void clearInstance ()
Czyszczenie instancji zatrzymuje śledzenie lokalizacji, czyści wewnętrzny stan i resetuje singleton FleetEngine do wartości null.
public static void createInstance (Aplikacja aplikacji, String providerId, StringVehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)
Tworzy singleton FleetEngine
, który umożliwia dostęp do usługi Google Fleet Engine. Wewnętrznie ta metoda uzyskuje RoadSnappedLocationProvider
za pomocą getRoadSnappedLocationProvider(Application)
, więc przed jej wywołaniem należy uzyskać Navigator
. W przeciwnym razie otrzymana jest wartość IllegalStateException
. Dwukrotne wywołanie metody createInstance() da wynik IllegalStateException
.
Parametry
aplikacji ML | obecna wartość Application , nie może wynosić null |
---|---|
providerId | identyfikator dostawcy |
vehicleId | identyfikator pojazdu, który zostanie połączony z Fleet Engine; |
authTokenFactory | factory , który dostarcza tokeny autoryzacji Fleet Engine |
errorListener | listener , który będzie otrzymywać powiadomienia o błędach klienta Fleet Engine |
Rzuty
IllegalStateException | jeśli identyfikator dostawcy nie jest określony w AndroidManifest.xml
|
---|
public static void createInstance (Application application, String providerId, StringużywaneId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)
Tworzy singleton FleetEngine
, który umożliwia dostęp do usługi Google Fleet Engine. Wewnętrznie ta metoda uzyskuje RoadSnappedLocationProvider
za pomocą getRoadSnappedLocationProvider(Application)
, więc przed jej wywołaniem należy uzyskać Navigator
. W przeciwnym razie otrzymana jest wartość IllegalStateException
. Dwukrotne wywołanie metody createInstance() da wynik IllegalStateException
.
Parametry
aplikacji ML | aktualna wartość Application , nie może wynosić null . |
---|---|
providerId | identyfikator dostawcy. |
vehicleId | identyfikator pojazdu, który zostanie połączony z Fleet Engine; |
authTokenFactory | factory , który dostarcza tokeny autoryzacji Fleet Engine. |
statusListener | odbiornik aktualizacji stanu. |
errorListener | listener , który będzie powiadamiany o błędach klienta Fleet Engine. |
Rzuty
IllegalStateException | jeśli identyfikator dostawcy nie jest określony w AndroidManifest.xml .
|
---|
public void disableLocationTracking ()
Przerywa śledzenie lokalizacji. Nie podejmowana jest próba zatrzymania już utworzonego raportu, ale nie będą generowane ani przesyłane żadne nowe raporty o pozycji.
Śledzenie można wznowić po zatrzymaniu, ponownie wywołując metodę enableLocationTracking()
.
Rzuty
IllegalStateException | jeśli śledzenie lokalizacji zostało już zatrzymane. |
---|
public void enableLocationTracking ()
Zacznij przesyłać raporty o pozycji do backendu Fleet Engine. Raporty są tworzone okresowo, domyślnie co 5 sekund. Raporty mogą być generowane rzadziej, jeśli przejściowe problemy, takie jak utrata połączenia sieciowego, uniemożliwiają ich dostarczanie.
Raporty o pozycji są tworzone w wątku w tle. To połączenie jest zwracane natychmiast.
Śledzenie lokalizacji można wyłączyć, dzwoniąc pod numer disableLocationTracking()
.
Interwał raportowania można zmienić za pomocą funkcji setLocationReportingInterval(long, TimeUnit)
.
Rzuty
IllegalStateException | jeśli śledzenie lokalizacji było już włączone |
---|
public static FleetEngine getInstance ()
Zwraca singleton FleetEngine. Metoda createInstance() musi zostać wywołana przed getInstance(). W przeciwnym razie zostanie zwrócona wartość null.
public long getLocationReportingIntervalMs ()
Zwraca bieżący interwał raportowania lokalizacji w milisekundach.
public boolean isLocationTrackingEnabled ()
Wskazuje, czy śledzenie lokalizacji jest włączone.
public static void setFleetEngineConfig (konfiguracja FleetEngine.FleetEngineConfig)
Parametry
konfiguracja |
---|
public void setLocationReportingInterval (long interwał, TimeUnit interUnits)
Określa minimalny odstęp czasu, po którym raporty o lokalizacji będą dostarczane do backendu Fleet Engine. Domyślny interwał raportowania to 10 sekund. Minimalny obsługiwany interwał aktualizacji to 5 sekund. Częstsze aktualizacje mogą powodować wolniejsze żądania i błędy.
Parametry
interval | |
---|---|
intervalUnits |
public void setVehicleState (stan FleetEngine.VehicleState)
Ustawia wartość VehicleState. Jeśli masz włączone aktualizacje lokalizacji, wartość zostanie zastosowana przy następnej aktualizacji lokalizacji. Jeśli aktualizacje lokalizacji są wyłączone, aktualizacja jest uruchamiana natychmiast.
Aktualizacja VehicleState jest przeprowadzana w wątku w tle i jest zwracana natychmiast.
Parametry
state |
---|
Rzuty
IllegalStateException | jeśli parametr VehicleState jest ustawiony na ONLINE, gdy śledzenie lokalizacji nie jest jeszcze włączone. |
---|