نظرة عامة
كائن إرسال المعلومات إلى الواجهة الخلفية لـ Fleet Engine.
تُستخدم لعمليات التسليم.
يكتسب GMTDVehicleReporter.
وظائف الأعضاء العامين | |
| (void) | - setVehicleStops:complete: |
| يعدِّل هذا الخيار محطات توقّف المركبة المتبقية للمركبة. | |
| (void) | - reportEnrouteToNextStopWithComplete: |
تعديل حالة أوّل GMTDVehicleStop في remainingVehicleStops إلى GMTDVehicleStopStateEnroute | |
| (void) | - reportitdAtStopWithComplete: |
تعديل حالة أوّل GMTDVehicleStop في remainingVehicleStops إلى GMTDVehicleStopStateArrived | |
| (void) | - reportCompleteStopWithcomplete: |
لإزالة أول GMTDVehicleStop في remainingVehicleStops. | |
| (void) | - getRemainingVehicleStopsWithComplete: |
الحصول على العناصر المتبقية البالغ عددها GMTDVehicleStop والتي لا تزال المركبة بحاجة إلى زيارتها. | |
| (void) | - updateVehicleState: |
| لتعديل حالة المركبة | |
| (void) | - addListener: |
| إضافة مستمع | |
| (void) | - removeListener: |
| لإزالة مستمِع. | |
الأنواع المحمية | |
| typedef void(^ | GMTDVehicleReporterStopCompletionHandler )(NSArray< GMTDVehicleStop * > *_Nullable stops, NSError *_Nullable error) |
معالج لتحديث المحطات عبر GMTDDeliveryVehicleReporter. | |
السمات المحمية | |
| __pad0__: NSObject <GMSNavigatorListener | |
المواقع | |
| GMSRoadSnappedLocationProviderListener BOOL | locationTrackingEnabled |
لا تحتوي هذه الفئة على مهيئات عامة، لذا يمكنك الحصول على هذا الكائن من السمة vehicleReporter في العنصر GMTDDeliveryDriverAPI أو GMTDRidesharingDriverAPI. | |
| NSTimeInterval | locationReportingInterval |
| يشير إلى الحد الأدنى للفاصل الزمني الذي يتم خلاله تسليم تقارير المواقع إلى Fleet Engine. | |
وثائق وظائف الأعضاء
| - (باطل) setVehicleStops: | (NSArray< GMTDVehicleStop * > *) | vehicleStops | |
| الإكمال: | (GMTDVehicleReporterStopCompletionHandler) | الإكمال | |
يعدِّل هذا الخيار محطات توقّف المركبة المتبقية للمركبة.
تظهر النتائج بشكل غير متزامن في remainingVehicleStops. من المتوقّع أن تنتقل المركبة إلى محطات التوقّف بنفس ترتيب المصفوفة.
- المَعلمات:
-
vehicleStops المصفوفة التي تتضمّن GMTDVehicleStopعناصر ستزورها المركبة يجب ألا تكون هذه المدة صفرية، كما يجب أن تكون حالة كل محطات باستثناء المحطة الأولى بالحالةGMTDVehicleStopStateNew.إتمام مربّع يتم تشغيله بعد تعديل المحطات.
| - (باطل) reportEnrouteToNextStopWithComplete: | (GMTDVehicleReporterStopCompletionHandler) | الإكمال |
تعديل حالة أوّل GMTDVehicleStop في remainingVehicleStops إلى GMTDVehicleStopStateEnroute
يجب أن تحتوي remainingVehicleStops على محطة واحدة على الأقل عند استدعاء هذه الدالة.
- المَعلمات:
-
إتمام مربّع يتم تشغيله بعد تعديل المحطات.
| - (باطل) reportdAtStopWithComplete: | (GMTDVehicleReporterStopCompletionHandler) | الإكمال |
تعديل حالة أوّل GMTDVehicleStop في remainingVehicleStops إلى GMTDVehicleStopStateArrived
يجب أن تحتوي remainingVehicleStops على محطة واحدة على الأقل عند استدعاء هذه الدالة.
- المَعلمات:
-
إتمام مربّع يتم تشغيله بعد تعديل المحطات.
| - (باطل) reportCompleteStopWithComplete: | (GMTDVehicleReporterStopCompletionHandler) | الإكمال |
لإزالة أول GMTDVehicleStop في remainingVehicleStops.
يجب أن تحتوي remainingVehicleStops على محطة واحدة على الأقل عند استدعاء هذه الدالة.
- المَعلمات:
-
إتمام مربّع يتم تشغيله بعد تعديل المحطات.
| - (باطل) getRemainingVehicleStopsWithComplete: | (GMTDVehicleReporterStopCompletionHandler) | الإكمال |
الحصول على العناصر المتبقية البالغ عددها GMTDVehicleStop والتي لا تزال المركبة بحاجة إلى زيارتها.
- المَعلمات:
-
إتمام هذه السمة هي إكمال لتشغيل عناصر GMTDVehicleStopالتي تم استردادها. سيتم تنفيذ الإكمال بشكل غير متزامن في سلسلة التعليمات الرئيسية.
| - (باطل) updateVehicleState: | (GMTDVehicleState) | vehicleState |
لتعديل حالة المركبة
يُستخدم لمشاركة الرحلات فقط.
إذا تم ضبط locationTrackingEnabled على "لا"، سيتعذّر ضبط الحالة على GMTDVehicleStateOnline.
سيؤدي ضبط حالة مختلفة إلى إرسال طلب لمرة واحدة إلى الواجهة الخلفية لـ Fleet Engine.
تعدِّل هذه الطريقة حالة من جهة الخادم، ويجب أن يتتبّع تطبيق العميل fleetEngine:didSucceedVehicleUpdate: وfleetEngine:didFailVehicleUpdate:withError: للتأكّد من نجاح العملية أو تعذُّرها. تتم إعادة المحاولة تلقائيًا مع تعذّر إتمام العملية في حال ضبط locationTrackingEnabled على "نعم".
- المَعلمات:
-
vehicleState الحالة المطلوبة للمركبة
| - (void) addListener: | (id< GMTDVehicleReporterListener >) | مستمع |
إضافة مستمع
يتم احتواء المستمع على مرجع ضعيف.
- المَعلمات:
-
أداة معالجة الحدث عنصر متوافق مع البروتوكول GMTDVehicleReporterListener
| - (void) removeListener: | (id< GMTDVehicleReporterListener >) | مستمع |
لإزالة مستمِع.
- المَعلمات:
-
أداة معالجة الحدث عنصر متوافق مع البروتوكول GMTDVehicleReporterListener
وثائق بيانات الأعضاء
- GMTDVehicleReporter: [protected, inherited] |
وثائق العقار
- (GMSRoadSnappedLocationProviderListener BOOL) locationTrackingEnabled [read, write, assign, inherited] |
لا تحتوي هذه الفئة على مهيئات عامة، لذا يمكنك الحصول على هذا الكائن من السمة vehicleReporter في العنصر GMTDDeliveryDriverAPI أو GMTDRidesharingDriverAPI.
يشير إلى ما إذا كان تتبع الموقع الجغرافي مفعَّلاً أم لا.
في حال ضبط هذه السياسة على "نعم"، يتم إرسال تحديثات الرحلات والمركبات إلى الواجهة الخلفية لـ Fleet Engine على فترات منتظمة استنادًا إلى القيمة المضبوطة على locationUpdateInterval.
في حال ضبط هذه السياسة على "لا"، تتوقف التحديثات ويتم إرسال طلب لتحديث المركبة مرة واحدة إلى الواجهة الخلفية لـ Fleet Engine لضبط حالة المركبة على GMTDVehicleStateOffline. راجِع updateVehicleState لمعرفة اعتبارات خاصة حول التعامل مع حالات التعذُّر عند ضبط locationTrackingEnabled على "لا".
- (NSTimeInterval) locationReportingInterval [read, write, assign, inherited] |
يشير إلى الحد الأدنى للفاصل الزمني الذي يتم خلاله تسليم تقارير المواقع إلى Fleet Engine.
- ملاحظة:
- الفاصل الزمني التلقائي لإعداد التقارير هو 10 ثوانٍ. يبلغ الحد الأقصى المسموح به للقيمة 60 ثانية والحد الأدنى المسموح به هو 5 ثوانٍ. وفي حال استخدام قيمة خارج هذا النطاق، يتم تطبيق القيمة المطلوبة على ذلك النطاق.