總覽
包含行程相關邏輯資訊的物件,例如 `vehicleId`、行程類型、上車或下車時間和路線。
成員函式說明文件
- (可為空值的 GMTCFleetEngineIDString *) tripID |
傳回目前行程的 TripID (從 tripName 轉換)。
- (可為空值的 GMTSTripWaypoint *) nextTripWaypoint |
傳回其餘路線控點清單中的第一個路線控點。
- (可為空值的 GMTSTripWaypoint *) nextWaypoint |
傳回下一個要造訪的路線。
如果此行程已鏈結或共用,下一個路線控點可能不會屬於該行程。
- (nullable NSArray<GMTSLatLng *> *) activeRoute |
傳回指定行程的有效路線。
這個路線是從車輛目前位置到目前使用者的下一個目的地。與往回或共乘行程的下一個路線點不同,下一個路線控點可能與目前的使用者無關。系統會在第一次存取回傳值時產生,然後進行快取。
- (nullable NSArray<GMTSLatLng *> *) remainingRoute |
傳回指定行程的其餘路線。
剩餘路線是指從目前使用者下一個目的地到使用者最終目的地的路線線段。
- (可為空值的 GMTSTrafficData *) activeRouteTraffic |
傳回這趟行程有效路線的路況資料。
這個路線是從車輛目前位置到目前使用者的下一個目的地。與往回或共乘行程的下一個路線點不同,下一個路線控點可能與目前的使用者無關。系統會在第一次存取回傳值時產生,然後進行快取。
- (可為空值的 GMTSTrafficData *) remainingRouteTraffic |
傳回這趟行程的其餘路線的路況資料。
剩餘路線是指從目前使用者下一個目的地到使用者最終目的地的路線線段。
- (int32_t) remainingDistanceOfActiveRouteInMeters |
傳回目前路線的剩餘距離。
有效路線是指從車輛位置到目前使用者下一個目的地的路線路段。
- (int32_t) distanceOfRemainingRouteInMeters |
傳回剩餘路線的距離。
剩餘路線是指從目前使用者下一個目的地到最終目的地的路段。
+ (GMTSTripPropertyFields)propertyValueDifferencesBetweenTrip1: | (GMTSTrip *) | trip1 | |
andTrip2: | (GMTSTrip *) | trip2 | |
計算兩趟指定行程之間的差額。
不同的屬性差異會累計到傳回結果中。
- 參數:
-
trip1 第一趟行程的候選文字。 trip2 第二趟行程的候選文字。
- (instancetype) initWithTripName: | (nullable NSString *) | tripName | |
CarID: | (可為空值的 GMTCFleetEngineIDString *) | vehicleID | |
TripType: | (GMTSTripType)。 | tripType | |
TripStatus: | (GMTSTripStatus)。 | tripStatus | |
pickupLocation: | (可為空值的 GMTSTerminalLocation *) | pickupLocation | |
pickupTime: | (NSTimeInterval) | pickupTime | |
下車地點: | (可為空值的 GMTSTerminalLocation *) | dropoffLocation | |
下車時間: | (NSTimeInterval) | dropoffTime | |
上次車輛位置: | (可為空值的 GMTSVehicleLocation *) | lastVehicleLocation | |
numberOfPassengers: | (NSUInteger) | numberOfPassengers | |
RestWaypoints: | (nullable NSArray< GMTSTripWaypoint * > *) | remainingWaypoints | |
中繼目的地: | (nullable NSArray< GMTSTerminalLocation * > *) | intermediateDestinations | |
中繼 DestinationIndex: | (int32_t) | intermediateDestinationIndex | |
建立此類別的例項。
- 參數:
-
tripName 行程的名稱。 vehicleID 提供行程的車輛 ID, tripType 行程類型,所有選項請參閱列舉 GMTSTripType。 tripStatus 行程狀態,所有可能的狀態請參閱列舉 GMTSTripStatus。 pickupLocation 指定的上車地點。 pickupTime 抵達上車地點的預估時間。 dropoffLocation 目標下車地點。 dropoffTime 抵達下車地點的預估時間。 lastVehicleLocation 上次的車輛位置資訊。 numberOfPassengers 行程允許的乘客人數。 remainingWaypoints 行程中剩餘的路線控點陣列。 intermediateDestinations 用戶的剩餘路線控點陣列。 intermediateDestinationIndex 車輛下次抵達的中繼路線控點索引。
資源說明文件
- (NSString*) tripName [read, assign] |
行程的名稱。
- (GMTCFleetEngineIDString*) vehicleID [read, assign] |
行程服務的車輛 ID。
- (GMTSTripType) tripType [read, assign] |
目前的行程類型。如需所有選項,請參閱 GMTSTripType。
- (GMTSTripStatus) tripStatus [read, assign] |
所有可能狀態都會顯示目前的行程狀態 (GMTSTripStatus)。
- (GMTSTerminalLocation*) pickupLocation [read, assign] |
行程的上車地點。
- (NSTimeInterval) pickupTime [read, assign] |
抵達上車地點的預估時間。
- (GMTSTerminalLocation*) dropoffLocation [read, assign] |
行程的下車地點。
- (NSTimeInterval) dropoffTime [read, assign] |
抵達下車地點的預估時間。
- (GMTSVehicleLocation*) lastVehicleLocation [read, assign] |
行程的車輛最後位置資訊。
- (NSUInteger) numberOfPassengers [read, assign] |
目前行程允許的乘客人數。
- (NSArray<GMTSTripWaypoint *>*) remainingWaypoints [read, assign] |
行程路線上的路線控點陣列。
- (NSArray<GMTSTerminalLocation *>*) intermediateDestinations [read, assign] |
用戶的剩餘路線控點陣列。
- (int32_t) intermediateDestinationIndex [read, assign] |
車輛下次抵達的中繼路線控點索引。
如果沒有中繼路線控點,系統就會忽略這個欄位。