FleetEngine

کلاس عمومی FleetEngine Object را گسترش می دهد

مشتری برای موتور ناوگان Google.

این کلاس به تماس گیرنده اجازه می دهد تا ردیابی مکان را enable و disableLocationTracking() را غیرفعال کند. فرکانس به روز رسانی را می توان با setLocationReportingInterval(long, TimeUnit) کنترل کرد.

این کلاس امن نیست.

خلاصه کلاس تودرتو

رابط	FleetEngine.AuthTokenFactory		هنگامی که عملیات مختلف انجام می شود، از نمونه های این رابط خواسته می شود که یک نشانه مجوز ارائه دهند.
کلاس	FleetEngine.ErrorListener		مشتری Fleet Engine از نمونه هایی از این رابط استفاده می کند تا در صورت بروز استثناهای مهم به توسعه دهنده اطلاع دهد.
رابط	FleetEngine.FleetEngineConfig		این رابط منسوخ شده است. قلاب میراث
رابط	FleetEngine.StatusListener		شنونده برای به روز رسانی وضعیت.
enum	FleetEngine.VehicleState		نشان می دهد که آیا وسیله نقلیه سفرهای جدیدی را می پذیرد یا خیر.

خلاصه روش عمومی

فضای خالی ساکن	clearInstance () clearInstance ردیابی مکان را متوقف می‌کند، وضعیت داخلی را پاک می‌کند و FleetEngine singleton را به null بازنشانی می‌کند.
فضای خالی ساکن	createInstance (برنامه کاربردی، String providerId، String automjetId، FleetEngine.AuthTokenFactory authTokenFactory، FleetEngine.ErrorListener errorListener) FleetEngine singleton را ایجاد می کند که می تواند برای دسترسی به سرویس Google Fleet Engine استفاده شود.
فضای خالی ساکن	createInstance (برنامه کاربردی، String providerId، String automjetId، FleetEngine.AuthTokenFactory authTokenFactory، FleetEngine.StatusListener statusListener، FleetEngine.ErrorListener errorListener) FleetEngine singleton را ایجاد می کند که می تواند برای دسترسی به سرویس Google Fleet Engine استفاده شود.
خالی	disableLocationTracking () ردیابی موقعیت مکانی را متوقف می کند.
خالی	enableLocationTracking () آپلود گزارش‌های موقعیت را در قسمت پشتیبان Fleet Engine شروع کنید.
FleetEngine استاتیک	getInstance () تک تن FleetEngine را برمی گرداند.
طولانی	getLocationReportingIntervalMs () فاصله گزارش مکان فعلی را بر حسب میلی ثانیه برمی‌گرداند.
بولی	isLocationTrackingEnabled () نشان می دهد که آیا ردیابی موقعیت مکانی فعال است یا خیر.
فضای خالی ساکن	setFleetEngineConfig (پیکربندی FleetEngine.FleetEngineConfig )
خالی	setLocationReportingInterval (فاصله طولانی، TimeUnit intervalUnits) حداقل فاصله زمانی که گزارش های موقعیت مکانی به باطن Fleet Engine تحویل داده می شود را تنظیم می کند.
فضای خالی ساکن	setNavigator ( Navigator Navigator)
خالی	setVehicleState (حالت FleetEngine.VehicleState ) VehicleState را تنظیم می کند.

خلاصه روش ارثی

از کلاس java.lang.Object

بولی	برابر است (شیء arg0)
کلاس نهایی<?>	getClass ()
بین المللی	هش کد ()
باطل نهایی	اعلام کردن ()
باطل نهایی	اطلاع رسانی به همه ()
رشته	toString ()
باطل نهایی	صبر کنید (long arg0، int arg1)
باطل نهایی	صبر کنید (طولانی arg0)
باطل نهایی	صبر کن ()

روش های عمومی

public static void clearInstance ()

clearInstance ردیابی مکان را متوقف می‌کند، وضعیت داخلی را پاک می‌کند و FleetEngine singleton را به null بازنشانی می‌کند.

Public Void createInstance (برنامه کاربردی، String providerId، String automjetId، FleetEngine.AuthTokenFactory authTokenFactory، FleetEngine.ErrorListener errorListener)

FleetEngine singleton را ایجاد می کند که می تواند برای دسترسی به سرویس Google Fleet Engine استفاده شود. در داخل، این متد یک RoadSnappedLocationProvider با استفاده از getRoadSnappedLocationProvider(Application) دریافت می کند، بنابراین قبل از فراخوانی این متد باید یک Navigator با موفقیت به دست آید، در غیر این صورت منجر به یک IllegalStateException می شود. دو بار فراخوانی createInstance() منجر به یک IllegalStateException می شود.

مولفه های

کاربرد	Application فعلی، نباید null باشد
شناسه ارائه دهنده	شناسه ارائه دهنده
شناسه خودرو	شناسه وسیله نقلیه ای که به موتور ناوگان متصل می شود
authTokenFactory	factory ای که توکن های مجوز Fleet Engine را عرضه می کند
errorListener	listener ای که هنگام بروز خطاهای مشتری Fleet Engine مطلع می شود

پرتاب می کند

IllegalStateException	اگر شناسه ارائه دهنده در AndroidManifest.xml مشخص نشده باشد

Public Void createInstance (برنامه کاربردی، String providerId، String automjetId، FleetEngine.AuthTokenFactory authTokenFactory، FleetEngine.StatusListener statusListener، FleetEngine.ErrorListener errorListener)

FleetEngine singleton را ایجاد می کند که می تواند برای دسترسی به سرویس Google Fleet Engine استفاده شود. در داخل، این متد یک RoadSnappedLocationProvider با استفاده از getRoadSnappedLocationProvider(Application) دریافت می کند، بنابراین قبل از فراخوانی این متد باید یک Navigator با موفقیت به دست آید، در غیر این صورت منجر به یک IllegalStateException می شود. دو بار فراخوانی createInstance() منجر به یک IllegalStateException می شود.

مولفه های

کاربرد	Application فعلی , نباید null باشد .
شناسه ارائه دهنده	شناسه ارائه دهنده
شناسه خودرو	شناسه وسیله نقلیه ای که به موتور ناوگان متصل می شود
authTokenFactory	factory که توکن های مجوز Fleet Engine را عرضه می کند.
statusListener	شنونده برای به روز رسانی وضعیت.
errorListener	listener ای که هنگام بروز خطاهای مشتری Fleet Engine مطلع می شود.

پرتاب می کند

IllegalStateException	اگر شناسه ارائه دهنده در AndroidManifest.xml مشخص نشده باشد.

public void disableLocationTracking ()

ردیابی موقعیت مکانی را متوقف می کند. هیچ تلاشی برای متوقف کردن گزارشی که در حال حاضر در حال انجام است انجام نمی شود، اما هیچ گزارش موقعیت جدیدی تولید یا ارسال نخواهد شد.

با فراخوانی مجدد enableLocationTracking() می توان ردیابی را پس از توقف از سر گرفت.

پرتاب می کند

IllegalStateException	اگر ردیابی مکان قبلاً متوقف شده بود

public void enableLocationTracking ()

آپلود گزارش‌های موقعیت را در قسمت پشتیبان Fleet Engine شروع کنید. گزارش ها به صورت دوره ای و به طور پیش فرض هر 5 ثانیه یکبار تهیه می شوند. در صورتی که مشکلات گذرا، مانند از دست دادن اتصال شبکه، مانع از تحویل گزارش شود، ممکن است کمتر گزارش شود.

گزارش های موقعیت در یک رشته پس زمینه ساخته می شوند، این تماس بلافاصله برمی گردد.

ردیابی موقعیت مکانی ممکن است با فراخوانی disableLocationTracking() غیرفعال شود.

فاصله گزارش را می توان با setLocationReportingInterval(long, TimeUnit) تغییر داد.

پرتاب می کند

IllegalStateException	اگر ردیابی موقعیت مکانی قبلاً فعال شده بود

عمومی استاتیک FleetEngine getInstance ()

تک تن FleetEngine را برمی گرداند. ()createInstance باید قبل از getInstance فراخوانی شود، در غیر این صورت null برگردانده می شود.

عمومی طولانی getLocationReportingIntervalMs ()

فاصله گزارش مکان فعلی را بر حسب میلی ثانیه برمی‌گرداند.

بولین عمومی isLocationTrackingEnabled ()

نشان می دهد که آیا ردیابی موقعیت مکانی فعال است یا خیر.

setFleetEngineConfig void عمومی (پیکربندی FleetEngine.FleetEngineConfig )

مولفه های

پیکربندی

public void setLocationReportingInterval (فاصله طولانی، TimeUnit intervalUnits)

حداقل فاصله زمانی که گزارش های موقعیت مکانی به باطن Fleet Engine تحویل داده می شود را تنظیم می کند. فاصله گزارش پیش فرض 10 ثانیه است. حداقل فاصله به روز رسانی پشتیبانی شده 5 ثانیه است. به‌روزرسانی‌های مکرر ممکن است منجر به درخواست‌ها و خطاهای کندتر شود.

مولفه های

فاصله
واحدهای فاصله ای

setNavigator خالی استاتیک عمومی ( Navigator Navigator)

مولفه های

ناوبر

public void setVehicleState ( حالت FleetEngine.VehicleState )

VehicleState را تنظیم می کند. اگر به‌روزرسانی‌های مکان فعال باشد، مقدار در به‌روزرسانی مکان بعدی منتشر می‌شود. اگر به‌روزرسانی مکان غیرفعال باشد، به‌روزرسانی فوراً فعال می‌شود.

به‌روزرسانی VehicleState در یک موضوع پس‌زمینه انجام می‌شود، این تماس بلافاصله برمی‌گردد.

مولفه های

حالت

پرتاب می کند

IllegalStateException	اگر وقتی ردیابی موقعیت مکانی هنوز فعال نشده است، VehicleState به صورت ONLINE تنظیم شده باشد.