Động cơ đội xe

lớp công khai FleetEngine mở rộng Đối tượng

Một khách hàng cho Fleet Engine của Google.

Lớp này cho phép phương thức gọi đến enable và disableLocationTracking() tắt tính năng theo dõi vị trí. Bạn có thể kiểm soát tần suất cập nhật bằng setLocationReportingInterval(long, TimeUnit).

Lớp này không an toàn cho luồng.

Tóm tắt lớp lồng ghép

giao diện	FleetEngine.AuthTokenFactory		Các thực thể của giao diện này sẽ được yêu cầu cung cấp mã thông báo uỷ quyền khi thực hiện nhiều thao tác.
lớp	FleetEngine.ErrorListener		Ứng dụng Fleet Engine sẽ sử dụng các phiên bản của giao diện này để thông báo cho nhà phát triển khi xảy ra các ngoại lệ quan trọng.
giao diện	FleetEngine.FleetEngineConfig		Giao diện này không được dùng nữa. hook cũ
giao diện	FleetEngine.StatusListener		Trình nghe thông tin cập nhật trạng thái.
enum	FleetEngine.VehicleState		Cho biết phương tiện có chấp nhận các chuyến đi mới hay không.

Tóm tắt phương thức công khai

tĩnh khoảng trống	Hàm clearInstance() clearInstance ngừng theo dõi vị trí, xóa trạng thái nội bộ và đặt lại singleton của FleetEngine thành giá trị rỗng).
tĩnh khoảng trống	createInstance(Ứng dụng ứng dụng, Chuỗi providerId, Chuỗi xeId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener) Tạo singleton FleetEngine có thể dùng để truy cập vào dịch vụ Google Fleet Engine.
tĩnh khoảng trống	createInstance(Ứng dụng ứng dụng, Chuỗi providerId, Chuỗi xeId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener) Tạo singleton FleetEngine có thể dùng để truy cập vào dịch vụ Google Fleet Engine.
void	disableLocationTracking() Dừng theo dõi vị trí.
void	enableLocationTracking() Bắt đầu tải báo cáo vị trí lên phần phụ trợ của Fleet Engine.
tĩnh FleetEngine	getInstance() Trả về singleton của FleetEngine.
long	getLocationReportingIntervalMs() Trả về khoảng thời gian báo cáo vị trí hiện tại, tính bằng mili giây.
boolean	isLocationTrackingEnabled() Trả về cho dù tính năng theo dõi vị trí có đang bật hay không.
tĩnh khoảng trống	setFleetEngineConfig(cấu hình FleetEngine.FleetEngineConfig)
void	setLocationReportingInterval(khoảng thời gian dài, TimeUnit khoảng thời gian) Đặt khoảng thời gian tối thiểu gửi báo cáo vị trí đến phần phụ trợ của Fleet Engine.
tĩnh khoảng trống	setNavigator(trình điều hướng Trình điều hướng)
void	setVehicleState(trạng thái FleetEngine.VehicleState) Thiết lập ActivityState.

Tóm tắt phương thức kế thừa

Trong lớp java.lang.Object

boolean	bằng(Đối tượng arg0)
cuối cùng Loại<?>	getClass()
int	hashCode()
cuối cùng vô hiệu	notify()
cuối cùng vô hiệu	notifyAll()
Chuỗi	toString()
cuối cùng vô hiệu	chờ(long arg0, int arg1)
cuối cùng vô hiệu	chờ(long arg0)
cuối cùng vô hiệu	wait()

Phương thức công khai

công khai tĩnh khoảng trống clearInstance ()

clearInstance ngừng theo dõi vị trí, xóa trạng thái nội bộ và đặt lại singleton của FleetEngine thành giá trị rỗng).

công khai tĩnh khoảng trống createInstance (Ứng dụng, Chuỗi providerId, Chuỗi xeId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)

Tạo singleton FleetEngine có thể dùng để truy cập vào dịch vụ Google Fleet Engine. Trong nội bộ, phương thức này lấy RoadSnappedLocationProvider bằng getRoadSnappedLocationProvider(Application), vì vậy, bạn phải lấy Navigator thành công trước khi gọi phương thức này, nếu không sẽ dẫn đến IllegalStateException. Việc gọi createInstance() hai lần sẽ dẫn đến IllegalStateException.

Các tham số

ứng dụng	Application hiện tại, không được là null
providerId	mã nhận dạng của nhà cung cấp
vehicleId	mã nhận dạng của xe sẽ được kết nối với Fleet Engine
authTokenFactory	factory cung cấp mã thông báo uỷ quyền cho Hệ thống thiết bị
errorListener	listener sẽ được thông báo khi xảy ra lỗi máy khách Fleet Engine

Gửi

IllegalStateException	nếu mã nhà cung cấp không được chỉ định trong AndroidManifest.xml

public static void createInstance (Application application, String providerId, String vehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)

Tạo singleton FleetEngine có thể dùng để truy cập vào dịch vụ Google Fleet Engine. Trong nội bộ, phương thức này lấy RoadSnappedLocationProvider bằng getRoadSnappedLocationProvider(Application), vì vậy, bạn phải lấy Navigator thành công trước khi gọi phương thức này, nếu không sẽ dẫn đến IllegalStateException. Việc gọi createInstance() hai lần sẽ dẫn đến IllegalStateException.

Các tham số

ứng dụng	Application hiện tại, không được là null.
providerId	mã nhận dạng của nhà cung cấp.
vehicleId	mã nhận dạng của xe sẽ được kết nối với Fleet Engine
authTokenFactory	factory cung cấp mã thông báo uỷ quyền cho Fleet Engine.
statusListener	trình nghe thông tin cập nhật trạng thái.
errorListener	listener sẽ được thông báo khi xảy ra lỗi máy khách Fleet Engine.

Gửi

IllegalStateException	nếu mã nhà cung cấp không được chỉ định trong AndroidManifest.xml.

công khai void disableLocationTracking ()

Dừng theo dõi vị trí. Google không cố gắng dừng một báo cáo đang xử lý, nhưng sẽ không có báo cáo vị trí mới nào được tạo hoặc truyền.

Bạn có thể tiếp tục theo dõi sau khi dừng bằng cách gọi lại enableLocationTracking().

Gửi

IllegalStateException	nếu đã ngừng theo dõi vị trí

công khai vô hiệu enableLocationTracking ()

Bắt đầu tải báo cáo vị trí lên phần phụ trợ của Fleet Engine. Báo cáo được tạo định kỳ, theo mặc định 5 giây một lần. Việc báo cáo có thể được thực hiện ít thường xuyên hơn nếu các vấn đề tạm thời (chẳng hạn như mất kết nối mạng) ngăn chặn việc gửi báo cáo.

Báo cáo vị trí được thực hiện trong một luồng ở chế độ nền, lệnh gọi này sẽ trả về ngay lập tức.

Bạn có thể tắt tính năng theo dõi vị trí bằng cách gọi disableLocationTracking().

Bạn có thể thay đổi khoảng thời gian báo cáo bằng setLocationReportingInterval(long, TimeUnit).

Gửi

IllegalStateException	nếu tính năng theo dõi vị trí đã được bật

công khai tĩnh FleetEngine getInstance ()

Trả về singleton của FleetEngine. createInstance() phải được gọi trước getInstance(), nếu không giá trị rỗng sẽ được trả về.

công khai dài getLocationReportingIntervalMs ()

Trả về khoảng thời gian báo cáo vị trí hiện tại, tính bằng mili giây.

công khai boolean isLocationTrackingEnabled ()

Trả về cho dù tính năng theo dõi vị trí có đang bật hay không.

công khai tĩnh khoảng trống setFleetEngineConfig (FleetEngine.FleetEngineConfig cấu hình)

Các tham số

cấu hình

công khai khoảng trống setLocationReportingInterval (khoảng thời gian dài, TimeUnit khoảngUnits)

Đặt khoảng thời gian tối thiểu gửi báo cáo vị trí đến phần phụ trợ của Fleet Engine. Khoảng thời gian báo cáo mặc định là 10 giây. Khoảng thời gian cập nhật tối thiểu được hỗ trợ là 5 giây. Việc cập nhật thường xuyên hơn có thể khiến các yêu cầu và lỗi bị chậm hơn.

Các tham số

khoảng thời gian
intervalUnits

công khai tĩnh khoảng trống setNavigator (trình điều hướng)

Các tham số

trình điều hướng

công khai khoảng trống setVehicleState (FleetEngine.VehicleState trạng thái)

Thiết lập ActivityState. Nếu bạn bật tính năng cập nhật vị trí, thì giá trị này sẽ được áp dụng vào lần cập nhật vị trí tiếp theo. Nếu cập nhật vị trí bị tắt, cập nhật sẽ được kích hoạt ngay lập tức.

Việc cập nhật XeState được thực hiện trong một luồng ở chế độ nền, lệnh gọi này sẽ trả về ngay lập tức.

Các tham số

state

Gửi

IllegalStateException	nếu XeState được đặt là TRỰC TUYẾN khi tính năng theo dõi vị trí chưa được bật.