GMTSTrip 类参考


概览

此对象包含有关行程的物流信息,例如“vehicleId”、行程类型、上车点或下车时间以及路线。

继承 GMTCImmutableData

公共成员函数

(可为 null
GMTCFleetEngineIDString *)
- tripID
 返回当前行程的 travelID(从 travelName 转换而来)。
(可为 null 的 GMTSTripWaypoint *)- nextTripWaypoint
 返回剩余航点列表中的第一个航点。
(可为 null 的 GMTSTripWaypoint *)- nextWaypoint
 返回要访问的下一个航点。
(nullable NSArray< GMTSLatLng * > *) - activeRoute
 返回指定行程的有效路线。
(nullable NSArray< GMTSLatLng * > *) - remainingRoute
 返回指定行程的剩余路线。
(可为 null 的 GMTSTrafficData *)- activeRouteTraffic
 返回该行程当前路线的路况数据。
(可为 null 的 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
 行程的上车地点。
NSTimeInterval pickupTime
 到达上车点的预计时间。
GMTSTerminalLocationdropoffLocation
 行程的下车点。
NSTimeInterval dropoffTime
 预计到达下车点的时间。
GMTSVehicleLocationlastVehicleLocation
 行程中车辆的最后位置信息。
NSUIntegernumberOfPassengers
 当前行程允许的乘客人数。
NSArray<GMTSTripWaypointGMTSTripWaypoint * > * remainingWaypoints
 行程路线上的航点数组。
NSArray< GMTSTerminalLocation * > * intermediateDestinations
 消费者的剩余航点的数组。
int32_tintermediateDestinationIndex
 车辆下一次到达的中间航点的索引。

成员函数文档

-(可为 null 的 GMTCFleetEngineIDString *)tripID

返回当前行程的 travelID(从 travelName 转换而来)。

-(GMTSTripWaypoint 可为 null *)nextTripWaypoint

返回剩余航点列表中的第一个航点。

-(可为 null 的 GMTSTripWaypoint *)nextWaypoint

返回要访问的下一个航点。

如果此行程已串联或共享,则下一个航点可能不属于此行程。

- (nullable NSArray<GMTSLatLng *> *) activeRoute

返回指定行程的有效路线。

此路线是从车辆的当前位置到当前用户的下一个目的地。与背靠背或拼车行程中的下一个航点不同,下一个航点可能与当前用户不相关。系统会在首次访问时生成返回值,然后对其进行缓存。

- (nullable NSArray<GMTSLatLng *> *) remainingRoute

返回指定行程的剩余路线。

剩余路线是从当前用户的下一个目的地到用户最终目的地的路线段。

-(可为 null 的 GMTSTrafficData *)activeRouteTraffic

返回该行程当前路线的路况数据。

此路线是从车辆的当前位置到当前用户的下一个目的地。与背靠背或拼车行程中的下一个航点不同,下一个航点可能与当前用户不相关。系统会在首次访问时生成返回值,然后对其进行缓存。

-(可为 null 的 GMTSTrafficData *)remainingRouteTraffic

返回该行程剩余路线的路况数据。

剩余路线是从当前用户的下一个目的地到用户最终目的地的路线段。

返回有效路线的剩余距离。

有效路线是指从车辆所在位置到当前用户下一个目的地的路线路段。

返回剩余路线的距离。

剩余路线表示从当前用户的下一个目的地到上一个目的地的路线段。

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

计算两个给定行程之间的差值。

每个属性差异都会累积到返回结果中。

参数:
trip1第一个行程候选路线。
trip2第二个候选行程。
- (instancetype) initWithTripName: (nullable NSString *)  tripName
车辆 ID: (可为 null 的 GMTCFleetEngineIDString *) vehicleID
tripType: (GMTSTripType) tripType
tripStatus: (GMTSTripStatus) tripStatus
pickupLocation: (可为 null 的 GMTSTerminalLocation *) pickupLocation
pickupTime [提货时间]: (NSTimeInterval) pickupTime
dropoffLocation: (可为 null 的 GMTSTerminalLocation *) dropoffLocation
dropoffTime: (NSTimeInterval) dropoffTime
lastVehicleLocation: (可为 null 的 GMTSVehicleLocation *) lastVehicleLocation
乘客人数: (NSUInteger)  numberOfPassengers
剩余航点: (nullable NSArray< GMTSTripWaypoint * > *)  remainingWaypoints
中间目标: (nullable NSArray< GMTSTerminalLocation * > *)  intermediateDestinations
intermediateDestinationIndex: (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) pickupTimepickupTime [read, assign]

到达上车点的预计时间。

行程的下车点。

- (NSTimeInterval) dropoffTime [read, assign]

预计到达下车点的时间。

行程中车辆的最后位置信息。

- (NSUInteger) numberOfPassengersnumberOfPassengers [read, assign]

当前行程允许的乘客人数。

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

行程路线上的航点数组。

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

消费者的剩余航点的数组。

- (int32_t) intermediateDestinationIndex [read, assign]

车辆下一次到达的中间航点的索引。

如果没有中间航点,系统会忽略此字段。