概览
此对象包含有关行程的物流信息,例如“vehicleId”、行程类型、上车点或下车时间以及路线。
成员函数文档
-(可为 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 |
返回该行程剩余路线的路况数据。
剩余路线是从当前用户的下一个目的地到用户最终目的地的路线段。
- (int32_t) remainingDistanceOfActiveRouteInMeters |
返回有效路线的剩余距离。
有效路线是指从车辆所在位置到当前用户下一个目的地的路线路段。
- (int32_t) distanceOfRemainingRouteInMeters |
返回剩余路线的距离。
剩余路线表示从当前用户的下一个目的地到上一个目的地的路线段。
+ (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] |
到达上车点的预计时间。
- (GMTSTerminalLocation*) dropoffLocation [read, assign] |
行程的下车点。
- (NSTimeInterval) dropoffTime [read, assign] |
预计到达下车点的时间。
- (GMTSVehicleLocation*) lastVehicleLocation [read, assign] |
行程中车辆的最后位置信息。
- (NSUInteger) numberOfPassengersnumberOfPassengers [read, assign] |
当前行程允许的乘客人数。
- (NSArray<GMTSTripWaypoint *>*) remainingWaypoints [read, assign] |
行程路线上的航点数组。
- (NSArray<GMTSTerminalLocation *>*) intermediateDestinations [read, assign] |
消费者的剩余航点的数组。
- (int32_t) intermediateDestinationIndex [read, assign] |
车辆下一次到达的中间航点的索引。
如果没有中间航点,系统会忽略此字段。