Klien untuk Fleet Engine Google.
Class ini memungkinkan pemanggil untuk enable
dan disableLocationTracking()
menonaktifkan pelacakan lokasi. Frekuensi update dapat dikontrol dengan setLocationReportingInterval(long, TimeUnit)
.
Class ini tidak aman untuk thread.
Ringkasan Class Bertingkat
antarmuka | FleetEngine.AuthTokenFactory | Instance antarmuka ini akan diminta untuk memberikan token otorisasi saat berbagai operasi dilakukan. | |
class | FleetEngine.ErrorListener | Klien Fleet Engine akan menggunakan instance antarmuka ini untuk memberi tahu developer jika terjadi pengecualian penting. | |
antarmuka | FleetEngine.FleetEngineConfig | Antarmuka ini tidak digunakan lagi. hook lama | |
antarmuka | FleetEngine.StatusListener | Pemroses pembaruan status. | |
enum | FleetEngine.VehicleState | Menunjukkan apakah kendaraan menerima perjalanan baru. |
Ringkasan Metode Publik
void statis |
clearInstance()
clearInstance menghentikan pelacakan lokasi, membersihkan status internal, dan mereset singleton FleetEngine ke null.
|
void statis |
createInstance(Aplikasi aplikasi, String providerId, String vehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)
Membuat singleton
FleetEngine , yang dapat digunakan untuk mengakses layanan Google Fleet Engine. |
void statis |
createInstance(Aplikasi aplikasi, String providerId, String kendaraanId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)
Membuat singleton
FleetEngine , yang dapat digunakan untuk mengakses layanan Google Fleet Engine. |
void |
disableLocationTracking()
Menghentikan pelacakan lokasi.
|
void |
enableLocationTracking()
Mulai mengupload laporan posisi ke backend Fleet Engine.
|
statis FleetEngine |
getInstance()
Menampilkan singleton FleetEngine.
|
long |
getLocationReportingIntervalMs()
Menampilkan interval pelaporan lokasi saat ini, dalam milidetik.
|
boolean |
isLocationTrackingEnabled()
Menampilkan apakah pelacakan lokasi diaktifkan.
|
void statis |
setFleetEngineConfig(konfigurasi FleetEngine.FleetEngineConfig)
|
void |
setLocationReportingInterval(interval panjang, TimeUnit intervalUnits)
Menetapkan interval minimum saat laporan lokasi akan dikirim ke backend Fleet Engine.
|
void statis |
setNavigator(navigator Navigator)
|
void |
Ringkasan Metode Turunan
Metode Publik
public static void clearInstance ()
clearInstance menghentikan pelacakan lokasi, membersihkan status internal, dan mereset singleton FleetEngine ke null.
public static void createInstance (Application application, String providerId, String vehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)
Membuat singleton FleetEngine
, yang dapat digunakan untuk mengakses layanan Google Fleet Engine. Secara internal, metode ini mendapatkan RoadSnappedLocationProvider
menggunakan getRoadSnappedLocationProvider(Application)
, sehingga Navigator
harus berhasil
diperoleh sebelum memanggil metode ini; jika tidak, metode tersebut akan menghasilkan IllegalStateException
. Memanggil createInstance() dua kali akan menghasilkan IllegalStateException
.
Parameter
aplikasi | Application saat ini, tidak boleh null |
---|---|
providerId | ID penyedia |
vehicleId | ID kendaraan yang akan dihubungkan ke Fleet Engine |
authTokenFactory | factory yang menyediakan token otorisasi Fleet Engine |
errorListener | listener yang akan diberi tahu saat terjadi error klien Fleet Engine |
Menampilkan
IllegalStateException | jika ID penyedia tidak ditentukan di AndroidManifest.xml
|
---|
public static void createInstance (Application application, String providerId, String vehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)
Membuat singleton FleetEngine
, yang dapat digunakan untuk mengakses layanan Google Fleet Engine. Secara internal, metode ini mendapatkan RoadSnappedLocationProvider
menggunakan getRoadSnappedLocationProvider(Application)
, sehingga Navigator
harus berhasil
diperoleh sebelum memanggil metode ini; jika tidak, metode tersebut akan menghasilkan IllegalStateException
. Memanggil createInstance() dua kali akan menghasilkan IllegalStateException
.
Parameter
aplikasi | Application saat ini, tidak boleh null . |
---|---|
providerId | ID penyedia. |
vehicleId | ID kendaraan yang akan dihubungkan ke Fleet Engine |
authTokenFactory | factory yang menyediakan token otorisasi Fleet Engine. |
statusListener | pemroses untuk pembaruan status. |
errorListener | listener yang akan diberi tahu saat terjadi error klien Fleet Engine. |
Menampilkan
IllegalStateException | jika ID penyedia tidak ditentukan dalam AndroidManifest.xml .
|
---|
public void disableLocationTracking ()
Menghentikan pelacakan lokasi. Tidak ada upaya yang dilakukan untuk menghentikan laporan yang sudah berlangsung, tetapi tidak ada laporan posisi baru yang akan dibuat atau dikirim.
Pelacakan dapat dilanjutkan setelah berhenti dengan memanggil enableLocationTracking()
lagi.
Menampilkan
IllegalStateException | jika pelacakan lokasi sudah dihentikan |
---|
public void enableLocationTracking ()
Mulai mengupload laporan posisi ke backend Fleet Engine. Laporan dibuat secara berkala, secara default setiap 5 detik. Laporan dapat dibuat lebih jarang jika masalah sementara, seperti hilangnya konektivitas jaringan, mencegah pengiriman laporan.
Laporan posisi dibuat di thread latar belakang, panggilan ini langsung ditampilkan.
Pelacakan lokasi dapat dinonaktifkan dengan memanggil disableLocationTracking()
.
Interval pelaporan dapat diubah dengan setLocationReportingInterval(long, TimeUnit)
.
Menampilkan
IllegalStateException | jika pelacakan lokasi sudah diaktifkan |
---|
public static FleetEngine getInstance ()
Menampilkan singleton FleetEngine. createInstance() harus dipanggil sebelum getInstance(), jika tidak, null akan ditampilkan.
publik panjang getLocationReportingIntervalMs ()
Menampilkan interval pelaporan lokasi saat ini, dalam milidetik.
public boolean isLocationTrackingEnabled ()
Menampilkan apakah pelacakan lokasi diaktifkan.
public static void setFleetEngineConfig (Konfigurasi FleetEngine.FleetEngineConfig)
Parameter
config |
---|
public void setLocationReportingInterval (interval panjang, TimeUnit intervalUnits)
Menetapkan interval minimum saat laporan lokasi akan dikirim ke backend Fleet Engine. Interval pelaporan default adalah 10 detik. Interval update minimum yang didukung adalah 5 detik. Update yang lebih sering dapat menyebabkan permintaan dan error yang lebih lambat.
Parameter
interval | |
---|---|
intervalUnits |
public void setVehicleState (FleetEngine.VehicleState state)
Menetapkan VehicleState. Jika pembaruan lokasi diaktifkan, nilai akan diterapkan pada pembaruan lokasi berikutnya. Jika pembaruan lokasi dinonaktifkan, pembaruan akan segera diaktifkan.
Pembaruan VehicleState dibuat di thread latar belakang, panggilan ini segera ditampilkan.
Parameter
state |
---|
Menampilkan
IllegalStateException | jika VehicleState ditetapkan ONLINE saat pelacakan lokasi belum diaktifkan. |
---|