<GMTCTripModelSubscriber> 协议参考

公开成员函数

<GMTCTripModelSubscriber> 协议参考

---

概览

GMTCTripModel 事件更新的订阅者协议。

公开成员函数
(void)	- tripModel:didUpdateModelState:
	在行程会话状态更新时调用。
(void)	- tripModel:didUpdateTrip:updatedPropertyFields:
	在当前行程更新后调用。
(void)	- tripModel:didUpdateTripStatus：
	在当前行程状态更新时调用。
(void)	- tripModel:didUpdateVehicleLocation：
	在车辆的位置信息更新时调用。
(void)	- tripModel:didUpdatePickupLocation：
	在上车地点更新时调用。
(void)	- tripModel:didUpdateDropoffLocation：
	在下车点更新时调用。
(void)	- tripModel:didUpdateETAToNextWaypoint：
	在到达下一个航点的预计到达时间后调用。
(void)	- tripModel:didUpdatePickupETA：
	当驾驶员到达上车点的预计到达时间更新时调用。
(void)	- tripModel:didUpdateDropoffETA：
	当驾驶员到达下车点的预计到达时间更新时调用。
(void)	- tripModel:didUpdateActiveRouteRemainingDistance:
	在更新行程有效路线的剩余距离后调用。
(void)	- tripModel:didUpdateActiveRoute：
	在行程的有效路线段更新后调用。
(void)	- tripModel:didUpdateRemainingRoute:
	在更新行程的剩余路线段时调用。
(void)	- tripModel:didUpdateRemainingRouteDistance:
	在行程剩余路线的距离更新后调用。
(void)	- tripModel:didUpdateRemainingWaypoints:
	在行程的中间航点已更新时调用。
(void)	- tripModel:didUpdateIntermediateDestinations:
	在行程的航点已更新时调用。
(void)	- tripModel:didUpdateActiveRouteTraffic:
	在为行程的有效路线段的路况数据更新时调用。
(void)	- tripModel:didUpdateRemainingRouteTraffic:
	在更新行程剩余路线段的路况数据时调用。
(void)	- tripModel:didFailUpdateTripWithError:
	在行程监控请求错误已更新时调用。

---

成员函数文档

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateModelState：		（枚举 GMTCTripModelState）	sessionState
			[optional]

在行程会话状态更新时调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
sessionState	新的会话状态。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateTrip：		（可为 null 的 GMTSTrip *）	行程
updatedPropertyFields：		(GMTSTripPropertyFields)	updatedPropertyFields
			[optional]

在当前行程更新后调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
旅行	已更改的行程。
updatedPropertyFields	已更新的属性。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateTripStatus：		（枚举 GMTSTripStatus）	tripStatus
			[optional]

在当前行程状态更新时调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
tripStatus	已更新的行程状态。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateVehicleLocation：		（可为 null 的 GMTSVehicleLocation *）	vehicleLocation
			[optional]

在车辆的位置信息更新时调用。

新地点可能与之前的地点相同。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
vehicleLocation	当前行程的最后已知车辆位置。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdatePickupLocation：		（可为 null 的 GMTSTerminalLocation *）	pickupLocation
			[optional]

在上车地点更新时调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
pickupLocation	当前上车地点。如果行程被重置或取消，此值可能为 nil。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateDropoffLocation：		（可为 null 的 GMTSTerminalLocation *）	dropoffLocation
			[optional]

在下车点更新时调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
dropoffLocation	当前的下车点。如果行程被重置或取消，此值可能为 nil。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateETAToNextWaypoint：		(NSTimeInterval)	nextWaypointETA
			[optional]

在到达下一个航点的预计到达时间后调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
nextWaypointETA	司机当前到上车点的预计到达时间。如果行程被重置或取消，此值可以为 0。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdatePickupETA：		(NSTimeInterval)	pickupETA
			[optional]

当驾驶员到达上车点的预计到达时间更新时调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
pickupETA	司机当前到上车点的预计到达时间。如果行程被重置或取消，则此值可以为 0。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateDropoffETA：		(NSTimeInterval)	dropoffETA
			[optional]

当驾驶员到达下车点的预计到达时间更新时调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
dropoffETA	驾驶员当前到达下车点的预计到达时间。如果行程被重置或取消，则此值可以为 0。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateActiveRouteRemainingDistance：		(int32_t)	activeRouteRemainingDistance
			[optional]

在更新行程有效路线的剩余距离后调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
activeRouteRemainingDistance	车辆当前位置与下一个重要位置之间在有效路线上保持的距离（以米为单位）。下一个重要位置取决于当前行程的状态。如果行程状态为“GMTSTripStatusEnrouteToPickup”，则是指与上车点之间的距离。如果行程状态为“GMTSTripStatusEnrouteToDropoff”，那么此距离就是到下车点的距离。您的应用必须提供任何必要的衡量转化。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateActiveRoute：		(nullable NSArray< GMTSLatLng * > *)	activeRoute
			[optional]

在行程的有效路线段更新后调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
activeRoute	当前行程的有效路线段。此路段包含从车辆当前位置到下一个重要位置的路线。如果行程状态为“GMTSTripStatusEnrouteToPickup”，则下一个重要位置就是上车地点。如果行程状态为“GMTSTripStatusEnrouteToDropoff”，那么下一个重要位置就是下车点。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateRemainingRoute：		(nullable NSArray< GMTSLatLng * > *)	remainingRoute
			[optional]

在更新行程的剩余路线段时调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
remainingRoute	当前行程的剩余路线段。此路段包含从当前用户的下一个目的地到用户最终目的地的路线。如果行程状态为“GMTSTripStatusEnrouteToPickup”，其余的路线段将是从上车地点到下车点的路段。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateRemainingRouteDistance：		(int32_t)	remainingRouteDistance
			[optional]

在行程剩余路线的距离更新后调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
remainingRouteDistance	当前用户的下一个目的地与最终目的地之间剩余路线的距离（以米为单位）。下一个目的地取决于当前行程的状态。如果行程状态为“GMTSTripStatusEnrouteToPickup”，那么下一个目的地就是下车点。您的应用必须提供任何必要的衡量转化。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateRemainingWaypoints：		(nullable NSArray< GMTSTripWaypoint * > *)	remainingWaypoints
			[optional]

在行程的中间航点已更新时调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
remainingWaypoints	当前剩余的航点。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateIntermediateDestinations：		(nullable NSArray< GMTSTerminalLocation * > *)	intermediateDestinations
			[optional]

在行程的航点已更新时调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
intermediateDestinations	此行程当前剩余的中间航点。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateActiveRouteTraffic：		（可为 null 的 GMTSTrafficData *）	activeRouteTraffic
			[optional]

在为行程的有效路线段的路况数据更新时调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
activeRouteTraffic	当前行程的有效路线段。此路段包含从车辆当前位置到下一个重要位置的路线。如果行程状态为“GMTSTripStatusEnrouteToPickup”，则下一个重要位置就是上车地点。如果行程状态为“GMTSTripStatusEnrouteToDropoff”，那么下一个重要位置就是下车点。

- (void)tripModel：		(GMTCTripModel *)	tripModel
dodUpdateRemainingRouteTraffic：		（可为 null 的 GMTSTrafficData *）	remainingRouteTraffic
			[optional]

在更新行程剩余路线段的路况数据时调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
remainingRouteTraffic	当前行程剩余路线段的路况数据。

- (void)tripModel：		(GMTCTripModel *)	tripModel
doFailUpdateTripWithError：		(nullable NSError *)	错误
			[optional]

在行程监控请求错误已更新时调用。

参数：

tripModel	生成事件的 GMTCTripModel 实例。
error	当前行程监控请求的错误。该值可以为 nil。