<GMTCTripModelحساب> مرجع البروتوكول

وظائف الأعضاء الحكوميين

مرجع بروتوكول <GMTCTripModelSubscribe>

---

نظرة عامة

بروتوكول مشترك لتعديل حدث GMTCTripModel.

وظائف الأعضاء العامين
(void)	- tripModel:didUpdateModelState:
	يتم استدعاء هذا الإجراء عند تعديل حالة جلسة الرحلة.
(void)	- tripModel:didUpdateTrip:updatedPropertyFields:.
	يتم استدعاؤه عندما يتم تعديل الرحلة الحالية.
(void)	- tripModel:didUpdateTripStatus:
	يتم استدعاؤه عند تعديل حالة الرحلة الحالية.
(void)	- tripModel:didUpdateVehicleLocation:
	يتم الاتصال به عند تعديل الموقع الجغرافي للمركبة.
(void)	- tripModel:didUpdatePickupLocation:
	يتم إجراء المكالمة عند تعديل الموقع الجغرافي لاستلام الطلب.
(void)	- tripModel:didUpdateDropoffLocation:
	يتم استدعاؤه عند تعديل موقع التسليم.
(void)	- tripModel:didUpdateETAToNextWaypoint:
	يتم استدعاء هذا الحدث عندما يتم تعديل الوقت المقدّر للوصول إلى نقطة الطريق التالية.
(void)	- tripModel:didUpdatePickupETA:
	يتم استدعاء هذا الحدث عند تعديل الوقت المقدّر للوصول للسائق إلى نقطة الاستلام.
(void)	- tripModel:didUpdateDropoffETA:
	يتم استدعاء هذا الحدث عند تعديل الوقت المقدّر للوصول إلى نقطة انطلاق السائق.
(void)	- tripModel:didUpdateActiveRouteRemainingتباعد:
	يتم استدعاء هذا الحدث عند تعديل المسافة المتبقية من المسار النشط للرحلة.
(void)	- tripModel:didUpdateActiveRoute:
	يتم استدعاء هذا الحدث عند تعديل جزء المسار النشط للرحلة.
(void)	- tripModel:didUpdateRemainingRoute:
	يتم استدعاء هذا الحدث عند تعديل الجزء المتبقي من المسار من الرحلة.
(void)	- tripModel:didUpdateRemainingRouteتباعد:
	يتم استدعاؤه عند تعديل المسافة المتبقية في مسار الرحلة.
(void)	- tripModel:didUpdateRemainingWaypoints:
	يتم استدعاءها عند تعديل نقاط الطريق الوسيطة للرحلة.
(void)	- tripModel:didUpdateIntermedcateDestinations:
	يتم استدعاؤها عند تعديل نقاط المسار للرحلة.
(void)	- tripModel:didUpdateActiveRouteTraffic:
	يتم استدعاء هذا الحدث عند تعديل بيانات حركة المرور لشريحة المسار النشطة للرحلة.
(void)	- tripModel:didUpdateRemainingRouteTraffic:
	يتم استدعاؤه عند تعديل بيانات حركة المرور لجزء المسار المتبقي من الرحلة.
(void)	- tripModel:didFailUpdateTripWithError:.
	يتم استدعاء هذا الإجراء عند تعديل خطأ طلب تتبُّع الرحلة.

---

وثائق وظائف الأعضاء

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateModelState:		(التعداد GMTCTripModelState)	sessionState
			[optional]

يتم استدعاء هذا الإجراء عند تعديل حالة جلسة الرحلة.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
sessionState	حالة الجلسة الجديدة

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateTrip:		(GMTSTrip *) قابل للقيم	رحلة
Update PropertyFields:		(GMTSTripPropertyFields)	updatedPropertyFields
			[optional]

يتم استدعاؤه عندما يتم تعديل الرحلة الحالية.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
رحلة	الرحلة التي تغيّرت
updatedPropertyFields	السمات التي تم تعديلها.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateTripStatus:		(تعداد GMTSTripStatus)	tripStatus
			[optional]

يتم استدعاؤه عند تعديل حالة الرحلة الحالية.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
tripStatus	حالة الرحلة المعدَّلة

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateVehicleLocation:		(GMTSVehicleLocation قابل للقيم الفارغة *)	vehicleLocation
			[optional]

يتم الاتصال به عند تعديل الموقع الجغرافي للمركبة.

قد لا يكون الموقع الجغرافي الجديد مختلفًا عن الموقع الجغرافي السابق.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
vehicleLocation	آخر موقع جغرافي معروف للمركبة للرحلة الحالية.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdatepickupupLocation:		(GMTSTerminalLocation قابل للقيم (*)	pickupLocation
			[optional]

يتم إجراء المكالمة عند تعديل الموقع الجغرافي لاستلام الطلب.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
pickupLocation	الموقع الجغرافي الحالي لاستلام الطلب. وقد تكون هذه القيمة فارغة في حال إعادة ضبط الرحلة أو إلغاؤها.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateDropoffLocation:		(GMTSTerminalLocation قابل للقيم (*)	dropoffLocation
			[optional]

يتم استدعاؤه عند تعديل موقع التسليم.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
dropoffLocation	موقع التسليم الحالي. وقد تكون هذه القيمة فارغة في حال إعادة ضبط الرحلة أو إلغاؤها.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateETAToNextWaypoint:		(NSTimeInterval)	nextWaypointETA
			[optional]

يتم استدعاء هذا الحدث عندما يتم تعديل الوقت المقدّر للوصول إلى نقطة الطريق التالية.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
nextWaypointETA	الوقت المقدر للوصول الحالي للسائق إلى نقطة الاستلام. ويمكن أن تكون القيمة 0 في حال إعادة ضبط الرحلة أو إلغاؤها.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdate PickupETA:		(NSTimeInterval)	pickupETA
			[optional]

يتم استدعاء هذا الحدث عند تعديل الوقت المقدّر للوصول للسائق إلى نقطة الاستلام.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
pickupETA	الوقت المقدر للوصول الحالي للسائق إلى نقطة الاستلام. وقد يتم تمثيل القيمة 0 في حال إعادة ضبط الرحلة أو إلغاؤها.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateDropoffETA:		(NSTimeInterval)	dropoffETA
			[optional]

يتم استدعاء هذا الحدث عند تعديل الوقت المقدّر للوصول إلى نقطة انطلاق السائق.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
dropoffETA	الوقت المقدَّر للوصول الحالي للسائق إلى نقطة التسليم. وقد يتم تمثيل القيمة 0 في حال إعادة ضبط الرحلة أو إلغاؤها.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateActiveRouteReReightingway:		(int32_t)	activeRouteRemainingDistance
			[optional]

يتم استدعاء هذا الحدث عند تعديل المسافة المتبقية من المسار النشط للرحلة.

المَعلمات:

tripModel

مثيل GMTCTripModel الذي أنشأ الحدث.

activeRouteRemainingDistance

المسافة بالمتر التي تبقى على المسار النشط بين الموقع الجغرافي الحالي للمركبة والموقع المهم التالي يعتمد الموقع الجغرافي المهم التالي على حالة الرحلة الحالية. إذا كانت حالة الرحلة هي "GMTSTripStatusEnrouteTo Pickup"، تكون هذه هي المسافة إلى الموقع الجغرافي للاستلام. إذا كانت حالة الرحلة "GMTSTripStatusEnrouteToDropoff"، هذه هي المسافة إلى موقع التسليم. يجب أن يوفّر تطبيقك أي إحالات ناجحة ضرورية للقياس.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateActiveRoute:		(nullable NSArray< GMTSLatLng * > *)	activeRoute
			[optional]

يتم استدعاء هذا الحدث عند تعديل جزء المسار النشط للرحلة.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
activeRoute	جزء المسار النشط للرحلة الحالية. يشمل هذا الجزء المسار من الموقع الحالي للمركبة إلى الموقع المهم التالي. وإذا كانت حالة الرحلة هي "GMTSTripStatusEnrouteTopickupup"، سيكون الموقع الجغرافي المهم التالي هو موقع الاستلام. وإذا كانت حالة الرحلة هي "GMTSTripStatusEnrouteToDropoff"، سيكون الموقع المهم التالي هو موقع التسليم.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateRemainingRoute:		(nullable NSArray< GMTSLatLng * > *)	remainingRoute
			[optional]

يتم استدعاء هذا الحدث عند تعديل الجزء المتبقي من المسار من الرحلة.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
remainingRoute	الجزء المتبقي من المسار للرحلة الحالية. تشمل هذه الشريحة المسار من وجهة المستخدم التالية إلى وجهة المستخدم النهائية. إذا كانت حالة الرحلة هي "GMTSTripStatusEnrouteTo Pickup"، سيكون جزء المسار المتبقي هو الجزء من موقع الاستلام إلى موقع التسليم.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateRemainingRouteتشمل:		(int32_t)	remainingRouteDistance
			[optional]

يتم استدعاؤه عند تعديل المسافة المتبقية في مسار الرحلة.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
remainingRouteDistance	المسافة بالمتر من المسار المتبقّي بين وجهة المستخدم التالية ووجهته النهائية تعتمد الوجهة التالية على حالة الرحلة الحالية. إذا كانت حالة الرحلة هي "GMTSTripStatusEnrouteTopickupup"، تكون الوجهة التالية هي موقع الإنزال. يجب أن يوفّر تطبيقك أي إحالات ناجحة ضرورية للقياس.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
dUpdateRemainingWaypoints:		(nullable NSArray< GMTSTripWaypoint * > *)	remainingWaypoints
			[optional]

يتم استدعاءها عند تعديل نقاط الطريق الوسيطة للرحلة.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
remainingWaypoints	نقاط الطريق المتبقية الحالية.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateIntermedcateDestinations:		(nullable NSArray< GMTSTerminalLocation * > *)	intermediateDestinations
			[optional]

يتم استدعاؤها عند تعديل نقاط المسار للرحلة.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
intermediateDestinations	نقاط الطريق الوسيطة المتبقية الحالية لهذه الرحلة.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateActiveRouteTraffic:		(GMTSTrafficData قيمة فارغة *)	activeRouteTraffic
			[optional]

يتم استدعاء هذا الحدث عند تعديل بيانات حركة المرور لشريحة المسار النشطة للرحلة.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
activeRouteTraffic	جزء حركة المرور على المسار النشط للرحلة الحالية. يشمل هذا الجزء المسار من الموقع الحالي للمركبة إلى الموقع المهم التالي. وإذا كانت حالة الرحلة هي "GMTSTripStatusEnrouteTopickupup"، سيكون الموقع الجغرافي المهم التالي هو موقع الاستلام. وإذا كانت حالة الرحلة هي "GMTSTripStatusEnrouteToDropoff"، سيكون الموقع المهم التالي هو موقع التسليم.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doUpdateRemainingRouteTraffic:		(GMTSTrafficData قيمة فارغة *)	remainingRouteTraffic
			[optional]

يتم استدعاؤه عند تعديل بيانات حركة المرور لجزء المسار المتبقي من الرحلة.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
remainingRouteTraffic	بيانات حركة المرور للجزء المتبقي من المسار من الرحلة الحالية.

- (بلا قيمة) tripModel:		(GMTCTripModel *)	tripModel
doFailUpdateTripWithError:		(nullable NSError *)	خطأ
			[optional]

يتم استدعاء هذا الإجراء عند تعديل خطأ طلب تتبُّع الرحلة.

المَعلمات:

tripModel	مثيل GMTCTripModel الذي أنشأ الحدث.
خطأ	خطأ في طلب مراقبة الرحلة الحالي. يمكن أن تكون القيمة صفرًا.