סימוכין לשיעור GMTSTrip


סקירה כללית

אובייקט שמכיל מידע לוגיסטי לגבי נסיעה, כמו 'vehicleId', סוג הנסיעה, זמני האיסוף או ההורדה והמסלול.

מקבלת בירושה את GMTCImmutableData

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

(nullable
GMTCFleetEngineIDString *)
- tripID
 הפונקציה מחזירה את מזהה ה-drive של הנסיעה הנוכחית, לאחר המרה מ-tripName.
(nullable GMTSTripWaypoint *)nextTripWaypoint
 מחזירה את ציון הדרך הראשון ברשימת ציוני הדרך שנותרו.
(nullable GMTSTripWaypoint *)nextWaypoint
 מחזירה את ציון הדרך הבא שבו צריך לבקר.
(nullable NSArray< GMTSLatLng * > *) - activeRoute
 מחזירה את המסלול הפעיל של הנסיעה הנתונה.
(nullable NSArray< GMTSLatLng * > *) - remainingRoute
 מחזירה את המסלול הנותר של הנסיעה הנתונה.
(nullable GMTSTrafficData *)activeRouteTraffic
 מחזירה את נתוני התנועה עבור המסלול הפעיל של הנסיעה.
(nullable GMTSTrafficData *)- remainingRouteTraffic
 מחזירה את נתוני התנועה של המסלול הנותר בנסיעה.
(int32_t)- remainingDistanceOfActiveRouteInMeters
 מחזירה את המרחק שנותר במסלול הפעיל.
(int32_t)distanceOfRemainingRouteInMeters
 מחזירה את המרחק של המסלול הנותר.
(instancetype)- initWithTripName:vehicleID:tripType:tripStatus:pickupLocation:pickupTime:dropoffLocation:dropoffTime:lastVehicleLocation:numberOfPassengers:remainingWaypoints:intermediateDestinations:intermediateDestinationIndex:
 יוצר מופע של המחלקה הזו.

פונקציות סטטיות של חברים ציבוריים

(GMTSTripPropertyFields)+ propertyValueComparisonsBetweenTrip1:andTrip2:
 חשבו את ההפרש בין שתי נסיעות נתונות.

נכסים

NSString * tripName
 שם הנסיעה.
GMTCFleetEngineIDStringvehicleID
 מזהה של רכב שמטפל בנסיעה.
GMTSTripTypetripType
 סוג הנסיעה הנוכחי מופיע ב-GMTSTripType כדי לראות את כל האפשרויות.
GMTSTripStatustripStatus
 סטטוס הנסיעה הנוכחי, GMTSTripStatus, מופיע עבור כל הסטטוסים האפשריים.
GMTSTerminalLocationpickupLocation
 נקודת האיסוף של הנסיעה.
NSTimeIntervalpickupTime
 זמן ההגעה המשוער לנקודת האיסוף.
GMTSTerminalLocationdropoffLocation
 נקודת ההורדה של הנסיעה.
NSTimeIntervaldropoffTime
 זמן ההגעה המשוער אל נקודת ההורדה.
GMTSVehicleLocationlastVehicleLocation
 פרטי המיקום האחרון של הרכב בשביל הנסיעה.
NSUIntegernumberOfPassengers
 מספר הנוסעים המותרים בנסיעה הנוכחית.
NSArray< GMTSTripWaypoint * > * remainingWaypoints
 מערך של ציוני דרך במסלול הנסיעה.
NSArray< GMTSTerminalLocation * > * intermediateDestinations
 המערך של ציוני הדרך שנותרו של הצרכן.
int32_tintermediateDestinationIndex
 האינדקס של נקודת הביניים שבה הרכב יגיע אחריה.

מסמכי תיעוד לגבי פונקציות של חברים

הפונקציה מחזירה את מזהה ה-drive של הנסיעה הנוכחית, לאחר המרה מ-tripName.

מחזירה את ציון הדרך הראשון ברשימת ציוני הדרך שנותרו.

מחזירה את ציון הדרך הבא שבו צריך לבקר.

אם הנסיעה משויכת לשרשרת או משותפת, יכול להיות שנקודת הדרך הבאה לא שייכת ליעד הזה.

- (nullable NSArray<GMTSLatLng *> *) activeRoute

מחזירה את המסלול הפעיל של הנסיעה הנתונה.

המסלול הזה הוא מהמיקום הנוכחי של הרכב אל היעד הבא של המשתמש הנוכחי. בניגוד לנקודת הדרך הבאה בנסיעה הלוך וחזור או בנסיעה ב-Carpool, יכול להיות שנקודת הדרך הבאה לא תהיה קשורה למשתמש הנוכחי. הערך המוחזר נוצר בפעם הראשונה שניגשים אליו, ולאחר מכן נשמר במטמון.

- (nullable NSArray<GMTSLatLng *> *) remainingRoute

מחזירה את המסלול הנותר של הנסיעה הנתונה.

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

- (פונקציה null GMTSTrafficData *) activeRouteTraffic

מחזירה את נתוני התנועה עבור המסלול הפעיל של הנסיעה.

המסלול הזה הוא מהמיקום הנוכחי של הרכב אל היעד הבא של המשתמש הנוכחי. בניגוד לנקודת הדרך הבאה בנסיעה הלוך וחזור או בנסיעה ב-Carpool, יכול להיות שנקודת הדרך הבאה לא תהיה קשורה למשתמש הנוכחי. הערך המוחזר נוצר בפעם הראשונה שניגשים אליו, ולאחר מכן נשמר במטמון.

- (null בנתונים GMTSTrafficData *) remainingRouteTraffic

מחזירה את נתוני התנועה של המסלול הנותר בנסיעה.

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

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

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

מחזירה את המרחק של המסלול הנותר.

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

+ (GMTSTripPropertyFields) propertyValueComparisonsBetweenTrip1: (GMTSTrip *) trip1
andTrip2: (GMTSTrip *) trip2

חשבו את ההפרש בין שתי נסיעות נתונות.

כל הפרש בין תכונות יצבור בתוצאת ההחזרה.

פרמטרים:
trip1המועמד הראשון לנסיעה.
trip2המועמד השני לנסיעה.
- (instancetype) initWithTripName: (nullable NSString *)  tripName
מזהה רכב: (nullable GMTCFleetEngineIDString *) vehicleID
סוג הטיול: (GMTSTripType) tripType
סטטוס הנסיעה: (GMTSTripStatus) tripStatus
PickLocation: (nullable GMTSTerminalLocation *) pickupLocation
PickTime: (NSTimeInterval) pickupTime
dropoffLocation: (nullable GMTSTerminalLocation *) dropoffLocation
dropoffTime: (NSTimeInterval) dropoffTime
LastVehicleLocation: (nullable GMTSVehicleLocation *) lastVehicleLocation
מספר הנוסעים: (NSUInteger) numberOfPassengers
נקודות Waypoints: (nullable NSArray< GMTSTripWaypoint * > *)  remainingWaypoints
יעדי הביניים: (nullable NSArray< GMTSTerminalLocation * > *)  intermediateDestinations
אינדקס יעד: (int32_t) intermediateDestinationIndex

יוצר מופע של המחלקה הזו.

פרמטרים:
tripNameשם הנסיעה.
vehicleIDהמזהה של הרכב הטיפול בנסיעה.
tripTypeסוג הנסיעה. אפשר לעיין ברשימת 'טיפוסים בני מנייה (enum)' מסוג GMTSTripType כדי לראות את כל האפשרויות.
tripStatusסטטוס נסיעה מופיע בקטע 'טיפוסים בני מנייה (enum)' GMTSTripStatus לכל הסטטוסים האפשריים.
pickupLocationמיקום היעד לאיסוף.
pickupTimeזמן ההגעה המשוער לנקודת האיסוף.
dropoffLocationהמיקום של נקודת היעד למשלוח.
dropoffTimeזמן ההגעה המשוער לנקודת ההורדה.
lastVehicleLocationפרטי המיקום האחרון של הרכב.
numberOfPassengersמספר הנוסעים המותרים בנסיעה.
remainingWaypointsמערך ציוני הדרך שנותרו בנסיעה.
intermediateDestinationsהמערך של ציוני הדרך שנותרו של הצרכן.
intermediateDestinationIndexהאינדקס של נקודת הביניים שבה הרכב יגיע אחריה.

תיעוד נכס

- (NSString*) tripName [read, assign]

שם הנסיעה.

- (GMTCFleetEngineIDString*) vehicleID [read, assign]

מזהה של רכב שמטפל בנסיעה.

- (GMTSTripType) tripType [read, assign]

סוג הנסיעה הנוכחי מופיע ב-GMTSTripType כדי לראות את כל האפשרויות.

- (GMTSTripStatus) tripStatus (פרטי הסטטוס) [read, assign]

סטטוס הנסיעה הנוכחי, GMTSTripStatus, מופיע עבור כל הסטטוסים האפשריים.

- (GMTSTerminalLocation*) pickupLocation [read, assign]

נקודת האיסוף של הנסיעה.

- (NSTimeInterval) pickupTime [read, assign]

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

נקודת ההורדה של הנסיעה.

- (NSTimeInterval) dropoffTime [read, assign]

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

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

- (NSUInteger) numberOfPassengers [read, assign]

מספר הנוסעים המותרים בנסיעה הנוכחית.

- (NSArray<GMTSTripWaypoint *>*) remainingWaypoints [read, assign]

מערך של ציוני דרך במסלול הנסיעה.

- (NSArray<GMTSTerminalLocation *>*) intermediateDestinations [read, assign]

המערך של ציוני הדרך שנותרו של הצרכן.

- (int32_t) intermediateDestinationIndex [read, assign]

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

אם אין ציוני דרך ברמת הביניים, המערכת תתעלם מהשדה הזה.