أسطول المركبات

الفئة العامة FleetEngine يوسِّع Object

عميل لشركة Google Fleet Engine.

تتيح هذه الفئة للمتصل enable وdisableLocationTracking() إيقاف تتبُّع الموقع الجغرافي. يمكنك التحكّم في معدّل تكرار التحديثات باستخدام setLocationReportingInterval(long, TimeUnit).

هذا الصف غير آمن لسلاسل المحادثات.

ملخص الفئة المدمَجة

واحدة	FleetEngine.AuthTokenFactory		وسيُطلب من مثيلات هذه الواجهة توفير رمز تفويض مميز عند إجراء عمليات مختلفة.
صنف	FleetEngine.ErrorListener		سيستخدم برنامج Fleet Engine نسخًا من هذه الواجهة لإبلاغ المطوّر عند حدوث استثناءات مهمة.
واحدة	FleetEngine.FleetEngineConfig		تم إيقاف هذه الواجهة. عنصر جذب قديم
واحدة	FleetEngine.StatusListener		يرصد الميكروفون تحديثات الحالة.
تعداد	FleetEngine.VehicleState		يشير هذا العمود إلى ما إذا كانت المركبة تقبل الرحلات الجديدة.

ملخّص الطريقة العلنية

قيمة فارغة	clearInstance() يوقف clearInstance تتبّع الموقع الجغرافي وينهي الحالة الداخلية ويعيد ضبط FleetEngine على "فارغ".
قيمة فارغة	createInstance(تطبيق Application, String providerId, String vehicleId, FleetEngine.AuthTokenFactory authTokenfactor, FleetEngine.ErrorListener errorListener) ينشئ سينغلتون FleetEngine، الذي يمكن استخدامه للوصول إلى خدمة Google Fleet Engine.
قيمة فارغة	createInstance(تطبيق Application, String providerId, String vehicleId, FleetEngine.AuthTokenFactory authTokenfactor, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener) ينشئ سينغلتون FleetEngine، الذي يمكن استخدامه للوصول إلى خدمة Google Fleet Engine.
void	disableLocationTracking() إيقاف تتبُّع الموقع الجغرافي
void	enableLocationTracking() بدء تحميل تقارير الموضع إلى الواجهة الخلفية لـ Fleet Engine
ثابت FleetEngine	getInstance() لعرض FleetEngine سينغلتون.
شعر طويل	getLocationReportingIntervalMs() لعرض الفاصل الزمني الحالي للإبلاغ عن الموقع بالمللي ثانية.
boolean	isLocationTrackingEnabled() يعود ما إذا كان تتبع الموقع الجغرافي مفعَّلاً.
قيمة فارغة	setFleetEngineConfig(الإعداد FleetEngine.FleetEngineConfig)
void	setLocationReportingInterval(فاصل زمني طويل، وحدات الفترات الزمنية للوحدة الزمنية) تحدِّد هذه السياسة الحد الأدنى للفاصل الزمني الذي يتم خلاله تسليم تقارير المواقع الجغرافية إلى الواجهة الخلفية لـ Fleet Engine.
قيمة فارغة	setNavigator(أداة التنقّل في Navigator)
void	setVehicleState(حالة FleetEngine.VehicleState) لضبط حالة المركبة.

ملخّص الطريقة المكتسبة

من الفئة java.lang.Object

boolean	equals(كائن arg0)
last الفئة<?>	getClass()
int	hashCode()
أخير ملغي	notify()
أخير ملغي	notifyAll()
سلسلة	toString()
أخير ملغي	انتظار(long arg0, int arg1)
أخير ملغي	انتظار(طول طويل arg0)
أخير ملغي	نحن()

الطرق العامة

public static فارغ clearInstance ()

يوقف clearInstance تتبّع الموقع الجغرافي وينهي الحالة الداخلية ويعيد ضبط FleetEngine على "فارغ".

public static باطلة createInstance (Application application, String providerId, String vehicleId, FleetEngine.AuthTokenFactory authTokenfactor, FleetEngine.ErrorListener errorListener)

ينشئ سينغلتون FleetEngine، الذي يمكن استخدامه للوصول إلى خدمة Google Fleet Engine. داخليًا، تحصل هذه الطريقة على RoadSnappedLocationProvider باستخدام getRoadSnappedLocationProvider(Application)، لذا يجب الحصول على Navigator بنجاح قبل استدعاء هذه الطريقة، وإلا ستؤدي إلى IllegalStateException. سيؤدي استدعاء createInstance() مرتين إلى IllegalStateException.

المَعلمات

التطبيق	قيمة Application الحالية، يجب ألا تكون null
providerId	رقم تعريف مقدّم الخدمة
vehicleId	معرّف المركبة التي سيتم ربطها بمحرّك Fleet Engine
authTokenFactory	رمز factory الذي يوفّر الرموز المميّزة لتفويض Fleet Engine
errorListener	listener الذي سيتم إرسال إشعار إليه عند حدوث أخطاء في عميل Fleet Engine

الرميات

IllegalStateException	إذا لم يتم تحديد رقم تعريف مقدِّم الخدمة في AndroidManifest.xml

public static باطلة createInstance (Application application, String providerId, String vehicleId, FleetEngine.AuthTokenFactory authTokenVA, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)

ينشئ سينغلتون FleetEngine، الذي يمكن استخدامه للوصول إلى خدمة Google Fleet Engine. داخليًا، تحصل هذه الطريقة على RoadSnappedLocationProvider باستخدام getRoadSnappedLocationProvider(Application)، لذا يجب الحصول على Navigator بنجاح قبل استدعاء هذه الطريقة، وإلا ستؤدي إلى IllegalStateException. سيؤدي استدعاء createInstance() مرتين إلى IllegalStateException.

المَعلمات

التطبيق	قيمة Application الحالية، يجب ألا تكون null.
providerId	رقم تعريف المزوّد.
vehicleId	معرّف المركبة التي سيتم ربطها بمحرّك Fleet Engine
authTokenFactory	رمز factory الذي يوفّر الرموز المميّزة لتفويض Fleet Engine
statusListener	المستمع لتحديثات الحالة.
errorListener	listener الذي سيتم إرسال إشعار إليه عند حدوث أخطاء في عميل Fleet Engine.

الرميات

IllegalStateException	إذا لم يتم تحديد رقم تعريف مقدِّم الخدمة في AndroidManifest.xml.

عام إلغاء disableLocationTracking ()

إيقاف تتبُّع الموقع الجغرافي ولا يتم إجراء أي محاولة لإيقاف تقرير قيد التقدم، ولكن لن يتم إنشاء أي تقارير موضع إعلان جديدة أو نقلها.

يمكن استئناف عملية التتبُّع بعد الإيقاف من خلال الاتصال برقم enableLocationTracking() مجددًا.

الرميات

IllegalStateException	إذا سبق أن تم إيقاف تتبُّع الموقع الجغرافي

عام إلغاء enableLocationTracking ()

بدء تحميل تقارير الموضع إلى الواجهة الخلفية لـ Fleet Engine يتم إعداد التقارير بشكل دوري وتلقائيًا كل 5 ثوانٍ. قد يتم إصدار البلاغات بشكل أقل تكرارًا إذا كانت هناك مشاكل عابرة تمنع تسليم التقارير، مثل فقدان الاتصال بالشبكة.

يتم إعداد تقارير الموضع في سلسلة محادثات في الخلفية، ويتم عرض هذه المكالمة على الفور.

قد يتم إيقاف تتبُّع الموقع الجغرافي من خلال الاتصال على الرقم disableLocationTracking().

يمكن تغيير الفاصل الزمني لإعداد التقارير باستخدام setLocationReportingInterval(long, TimeUnit).

الرميات

IllegalStateException	إذا كان تتبع الموقع الجغرافي مفعَّلاً

public static FleetEngine getInstance ()

لعرض FleetEngine Individualton. يجب استدعاء createInstance() قبل getInstance() ، وإلا سيتم عرض قيمة فارغة.

عامة طويلة getLocationReportingIntervalMs ()

لعرض الفاصل الزمني الحالي للإبلاغ عن الموقع بالمللي ثانية.

public منطقي isLocationTrackingEnabled ()

يعود ما إذا كان تتبع الموقع الجغرافي مفعَّلاً.

عامة ثابتة إلغاء setFleetEngineConfig (إعداد FleetEngine.FleetEngineConfig)

المَعلمات

config

متاح للجميع إلغاء setLocationReportingInterval ("long" (فترة طويلة) والفاصل الزمني لـ "TimeUnitUnits")

تحدِّد هذه السياسة الحد الأدنى للفاصل الزمني الذي يتم خلاله تسليم تقارير المواقع الجغرافية إلى الواجهة الخلفية لـ Fleet Engine. الفاصل الزمني التلقائي لإعداد التقارير هو 10 ثوانٍ. الحد الأدنى لمدة التحديث المتوافقة هو 5 ثوانٍ. وقد تؤدي التحديثات الأكثر تكرارًا إلى بطء الطلبات والأخطاء.

المَعلمات

interval
intervalUnits

public static فارغ setNavigator (مستكشف المستكشف)

المَعلمات

أداة التنقُّل

متاح للجميع إلغاء setVehicleState (FleetEngine.VehicleState)

لضبط حالة المركبة. في حال تفعيل تعديلات الموقع الجغرافي، سيتم نشر القيمة في عملية تعديل الموقع الجغرافي التالية. في حال إيقاف تحديثات الموقع الجغرافي، يتم تنشيط التحديث على الفور.

يتم تعديل حالة المركبة في سلسلة محادثات في الخلفية، ويتم عرض هذه المكالمة على الفور.

المَعلمات

state

الرميات

IllegalStateException	إذا تم ضبط حالة المركبة على الإنترنت عندما لا تكون ميزة تتبُّع الموقع الجغرافي مفعَّلة بعد.