GMTSTrip 類別參考資料

GMTSTrip 類別參考

總覽

包含行程相關邏輯資訊的物件,例如 `vehicleId`、行程類型、上車或下車時間和路線。

沿用 GMTCImmutableData

公開成員函式

(可為空值
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
 傳回剩餘路線的距離。
(instancetype)- initWithTripName:vehicleID:tripType:tripStatus:pickupLocation:pickupTime:dropoffLocation:dropoffTime:lastVehicleLocation:numberOfPassengers:remainingWaypoints:intermediateDestinations:intermediateDestinationIndex:
 建立此類別的例項。

靜態成員函式

(GMTSTripPropertyFields)。+ propertyValueDifferencesBetweenTrip1:andTrip2:
 計算兩趟指定行程之間的差額。

資源

NSString * tripName
 行程的名稱。
GMTCFleetEngineIDStringvehicleID
 行程服務的車輛 ID。
GMTSTripTypetripType
 目前的行程類型。如需所有選項,請參閱 GMTSTripType。
GMTSTripStatustripStatus
 所有可能狀態都會顯示目前的行程狀態 (GMTSTripStatus)。
GMTSTerminalLocationpickupLocation
 行程的上車地點。
NSTimeIntervalpickupTime
 抵達上車地點的預估時間。
GMTSTerminalLocationdropoffLocation
 行程的下車地點。
NSTimeIntervaldropoffTime
 抵達下車地點的預估時間。
GMTSVehicleLocationlastVehicleLocation
 行程的車輛最後位置資訊。
NSUIntegernumberOfPassengers
 目前行程允許的乘客人數。
NSArray< GMTSTripWaypoint * > * remainingWaypoints
 行程路線上的路線控點陣列。
NSArray< GMTSTerminalLocation * > * intermediateDestinations
 用戶的剩餘路線控點陣列。
int32_tintermediateDestinationIndex
 車輛下次抵達的中繼路線控點索引。

成員函式說明文件

- (可為空值的 GMTCFleetEngineIDString *) tripID

傳回目前行程的 TripID (從 tripName 轉換)。

- (可為空值的 GMTSTripWaypoint *) nextTripWaypoint

傳回其餘路線控點清單中的第一個路線控點。

- (可為空值的 GMTSTripWaypoint *) nextWaypoint

傳回下一個要造訪的路線。

如果此行程已鏈結或共用,下一個路線控點可能不會屬於該行程。

- (nullable NSArray<GMTSLatLng *> *) activeRoute

傳回指定行程的有效路線。

這個路線是從車輛目前位置到目前使用者的下一個目的地。與往回或共乘行程的下一個路線點不同,下一個路線控點可能與目前的使用者無關。系統會在第一次存取回傳值時產生,然後進行快取。

- (nullable NSArray<GMTSLatLng *> *) remainingRoute

傳回指定行程的其餘路線。

剩餘路線是指從目前使用者下一個目的地到使用者最終目的地的路線線段。

- (可為空值的 GMTSTrafficData *) activeRouteTraffic

傳回這趟行程有效路線的路況資料。

這個路線是從車輛目前位置到目前使用者的下一個目的地。與往回或共乘行程的下一個路線點不同,下一個路線控點可能與目前的使用者無關。系統會在第一次存取回傳值時產生,然後進行快取。

- (可為空值的 GMTSTrafficData *) remainingRouteTraffic

傳回這趟行程的其餘路線的路況資料。

剩餘路線是指從目前使用者下一個目的地到使用者最終目的地的路線線段。

傳回目前路線的剩餘距離。

有效路線是指從車輛位置到目前使用者下一個目的地的路線路段。

傳回剩餘路線的距離。

剩餘路線是指從目前使用者下一個目的地到最終目的地的路段。

+ (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]

抵達上車地點的預估時間。

行程的下車地點。

- (NSTimeInterval) dropoffTime [read, assign]

抵達下車地點的預估時間。

行程的車輛最後位置資訊。

- (NSUInteger) numberOfPassengers [read, assign]

目前行程允許的乘客人數。

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

行程路線上的路線控點陣列。

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

用戶的剩餘路線控點陣列。

- (int32_t) intermediateDestinationIndex [read, assign]

車輛下次抵達的中繼路線控點索引。

如果沒有中繼路線控點,系統就會忽略這個欄位。