<GMTCTripModel מנוי> סימוכין לפרוטוקול

פונקציות של חברי מועדון

<GMTCTripModelSubscriber> סימוכין לפרוטוקול

---

סקירה כללית

פרוטוקול של מנוי לעדכון האירועים של 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:didUpdateActiveRouteDurationDuration:
	היא תתקבל לאחר עדכון המרחק שנותר במסלול הפעיל של הנסיעה.
(void)	- tripModel:didUpdateActiveRoute:
	ההתראה הזו מוצגת כשקטע המסלול הפעיל של הנסיעה עודכן.
(void)	- tripModel:didUpdateחידודRoute:
	היא תתקבל כשקטע המסלול שנותר בנסיעה עודכן.
(void)	- tripModel:didUpdateUpdateRoute למלא':
	היא תתקבל לאחר עדכון המרחק ממסלול הנסיעה שנותר.
(void)	- tripModel:didUpdate טיפולWaypoints:
	היא תתקבל לאחר שנקודות הביניים של הנסיעה עודכנו.
(void)	- tripModel:didUpdateIntermediateDestinations:
	היא תתקבל לאחר שנקודות העצירה של הנסיעה עודכנו.
(void)	- tripModel:didUpdateActiveRouteTraffic:
	היא מוצגת כשנתוני התנועה מעודכנים בקטע המסלול הפעיל של הנסיעה.
(void)	- tripModel:didUpdateUpdateRouteTraffic:
	היא מוצגת כשנתוני התנועה מעודכנים בקטע המסלול שנותר בנסיעה.
(void)	- tripModel:didFailUpdateTripWithError:
	הוא מתרחש כשמעדכנים את השגיאה בבקשה למעקב אחר הנסיעה.

---

תיעוד לגבי פונקציות חברים

- (void) TriModel:		(GMTCTripModel *)	tripModel
doUpdateModelState:		(טיפוסים בני מנייה (enum) GMTCTripModelState	sessionState
			[optional]

התקבלה שיחה כשמצב סשן הנסיעה מתעדכן.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
sessionState	מצב הסשן החדש.

- (void) TriModel:		(GMTCTripModel *)	tripModel
doUpdateTrip:		(פונקציית GMTSTrip עם ערך null *)	נסיעה
updatedPropertyFields:		(GMTSTripPropertyFields)	updatedPropertyFields
			[optional]

התקבלה שיחה כשהנסיעה הנוכחית מתעדכנת.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
נסיעה	הנסיעה שהשתנתה.
updatedPropertyFields	המאפיינים המעודכנים.

- (void) TriModel:		(GMTCTripModel *)	tripModel
doUpdateTripStatus:		(enum GMTSTripStatus)	tripStatus (סטטוס הנסיעה)
			[optional]

התקבלה שיחה כשסטטוס הנסיעה הנוכחי מתעדכן.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
tripStatus	סטטוס הנסיעה עודכן.

- (void) TriModel:		(GMTCTripModel *)	tripModel
doUpdateVehicleLocation:		(nullable GMTSVehicleLocation *)	vehicleLocation
			[optional]

תתקבל התראה אחרי שמיקום הרכב עודכן.

ייתכן שהמיקום החדש לא יהיה שונה מהמיקום הקודם.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
vehicleLocation	המיקום הידוע האחרון של כלי הרכב בנסיעה הנוכחית.

- (void) TriModel:		(GMTCTripModel *)	tripModel
dUpdate PickupLocation:		(פונקציית ה-null במאפיין GMTSTerminalLocation *)	pickupLocation
			[optional]

תתקבל שיחה לאחר עדכון המיקום לאיסוף.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
pickupLocation	מיקום האיסוף הנוכחי. הערך הזה עשוי להיות אפס אם הנסיעה אופסה או בוטלה.

- (void) TriModel:		(GMTCTripModel *)	tripModel
doUpdateDropoffLocation:		(פונקציית ה-null במאפיין GMTSTerminalLocation *)	dropoffLocation
			[optional]

היא תתקבל כשיעד ההחזרה עודכן.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
dropoffLocation	מיקום ההחזרה הנוכחי. הערך הזה עשוי להיות אפס אם הנסיעה אופסה או בוטלה.

- (void) TriModel:		(GMTCTripModel *)	tripModel
doUpdateETAToNextWaypoint:		(NSTimeInterval)	nextWaypointETA
			[optional]

מופעלת בזמן עדכון זמן ההגעה המשוער לנקודת הדרך הבאה.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
nextWaypointETA	זמן ההגעה המשוער הנוכחי של הנהג/ת עד לנקודת האיסוף. הערך יכול להיות 0 אם הנסיעה אופסה או בוטלה.

- (void) TriModel:		(GMTCTripModel *)	tripModel
dUpdate PickupETA:		(NSTimeInterval)	pickupETA (איסוף עצמי)
			[optional]

מופעלת בזמן עדכון זמן ההגעה המשוער של הנהג לנקודת האיסוף.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
pickupETA	זמן ההגעה המשוער הנוכחי של הנהג/ת עד לנקודת האיסוף. הערך יכול להיות 0 אם הנסיעה אופסה או בוטלה.

- (void) TriModel:		(GMTCTripModel *)	tripModel
doUpdateDropoffETA:		(NSTimeInterval)	dropoffETA,
			[optional]

מופעלת בזמן עדכון זמן ההגעה המשוער של הנהג לנקודת ההורדה.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
dropoffETA	זמן ההגעה המשוער הנוכחי של הנהג/ת עד לנקודת ההורדה. הערך יכול להיות 0 אם הנסיעה אופסה או בוטלה.

- (void) TriModel:		(GMTCTripModel *)	tripModel
didUpdateActiveRouteDurationDuration:		(int32_t)	activeRouteRemainingDistance
			[optional]

היא תתקבל לאחר עדכון המרחק שנותר במסלול הפעיל של הנסיעה.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
activeRouteRemainingDistance	המרחק במטרים שנשאר במסלול הפעיל בין המיקום הנוכחי של הרכב למיקום המשמעותי הבא. המיקום המשמעותי הבא תלוי בסטטוס הנסיעה הנוכחית. אם סטטוס הנסיעה הוא 'GMTSTripStatusEnrouteToTakeup', זהו המרחק לנקודת האיסוף. אם סטטוס הנסיעה הוא 'GMTSTripStatusEnrouteToDropoff', זהו המרחק לנקודת ההורדה. האפליקציה צריכה לספק את כל המרות המדידה הנדרשות.

- (void) TriModel:		(GMTCTripModel *)	tripModel
doUpdateActiveRoute:		(nullable NSArray< GMTSLatLng * > *)	activeRoute,
			[optional]

ההתראה הזו מוצגת כשקטע המסלול הפעיל של הנסיעה עודכן.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
activeRoute	קטע המסלול הפעיל של הנסיעה הנוכחית. הקטע הזה כולל את המסלול מהמיקום הנוכחי של הרכב למיקום המשמעותי הבא. אם סטטוס הנסיעה הוא 'GMTSTripStatusEnrouteToTakeup', המיקום המשמעותי הבא הוא מיקום האיסוף. אם סטטוס הנסיעה הוא 'GMTSTripStatusEnrouteToDropoff', המיקום המשמעותי הבא הוא מיקום ההורדה.

- (void) TriModel:		(GMTCTripModel *)	tripModel
dodoUpdateRoute:		(nullable NSArray< GMTSLatLng * > *)	remainingRoute (נתיב שנותר)
			[optional]

היא תתקבל כשקטע המסלול שנותר בנסיעה עודכן.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
remainingRoute	קטע המסלול הנותר של הנסיעה הנוכחית. הפלח הזה כולל את המסלול מהיעד הבא של המשתמש הנוכחי אל היעד הסופי שלו. אם סטטוס הנסיעה הוא 'GMTSTripStatusEnrouteToTakeup', מקטע המסלול הנותר יהיה הקטע מנקודת האיסוף אל נקודת ההורדה.

- (void) TriModel:		(GMTCTripModel *)	tripModel
doUpdateUpdateRoute:		(int32_t)	remainingRouteDistance
			[optional]

היא תתקבל לאחר עדכון המרחק ממסלול הנסיעה שנותר.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
remainingRouteDistance	המרחק במטרים מהמסלול שנותר בין היעד הבא של המשתמש הנוכחי אל היעד הסופי שלו. היעד הבא תלוי בסטטוס של הנסיעה הנוכחית. אם סטטוס הנסיעה הוא 'GMTSTripStatusEnrouteToTakeup', היעד הבא הוא מיקום ההורדה. האפליקציה צריכה לספק את כל המרות המדידה הנדרשות.

- (void) TriModel:		(GMTCTripModel *)	tripModel
DidUpdateUpdateWaypoints:		(nullable NSArray< GMTSTripWaypoint * > *)	remainingWaypoints
			[optional]

היא תתקבל לאחר שנקודות הביניים של הנסיעה עודכנו.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
remainingWaypoints	ציוני הדרך הנוכחיים שנותרו.

- (void) TriModel:		(GMTCTripModel *)	tripModel
doUpdateIntermediateDestinations:		(nullable NSArray< GMTSTerminalLocation * > *)	intermediateDestinations
			[optional]

היא תתקבל לאחר שנקודות העצירה של הנסיעה עודכנו.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
intermediateDestinations	ציוני הדרך הנוכחיים שנותרו לנסיעה הזו.

- (void) TriModel:		(GMTCTripModel *)	tripModel
doUpdateActiveRouteTraffic:		(פונקציית GMTSTrafficData ריקה *)	activeRouteTraffic
			[optional]

היא מוצגת כשנתוני התנועה מעודכנים בקטע המסלול הפעיל של הנסיעה.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
activeRouteTraffic	מקטע התנועה במסלול הפעיל של הנסיעה הנוכחית. הקטע הזה כולל את המסלול מהמיקום הנוכחי של הרכב למיקום המשמעותי הבא. אם סטטוס הנסיעה הוא 'GMTSTripStatusEnrouteToTakeup', המיקום המשמעותי הבא הוא מיקום האיסוף. אם סטטוס הנסיעה הוא 'GMTSTripStatusEnrouteToDropoff', המיקום המשמעותי הבא הוא מיקום ההורדה.

- (void) TriModel:		(GMTCTripModel *)	tripModel
doUpdateUpdateRouteTraffic:		(פונקציית GMTSTrafficData ריקה *)	remainingRouteTraffic
			[optional]

היא מוצגת כשנתוני התנועה מעודכנים בקטע המסלול שנותר בנסיעה.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
remainingRouteTraffic	נתוני התנועה עבור קטע המסלול הנותר של הנסיעה הנוכחית.

- (void) TriModel:		(GMTCTripModel *)	tripModel
doFailUpdateTripWithError:		(nullable NSError *)	שגיאה
			[optional]

הוא מתרחש כשמעדכנים את השגיאה בבקשה למעקב אחר הנסיעה.

פרמטרים:

tripModel	המופע של GMTCTripModel שיצר את האירוע.
error	השגיאה של הבקשה הנוכחית למעקב אחר הנסיעה. הערך יכול להיות אפס.