<GMTCTripModel 訂閱者> 通訊協定參考資料

公開成員函式

<GMTCTripModelsubscribe> 通訊協定參考資料

---

總覽

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
doUpdateModelState：		(列舉 GMTCTripModelState)	sessionState
			[optional]

行程工作階段狀態更新時，會呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
sessionState	新的工作階段狀態。

- (void) tripModel：		(GMTCTripModel *)	tripModel
doUpdateTrip：		(可為空值 GMTSTrip *)	行程
updatePropertyFields：		(GMTSTripPropertyFields)。	updatedPropertyFields
			[optional]

在目前的行程更新時呼叫。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
旅行	已變更的行程。
updatedPropertyFields	更新後的屬性。

- (void) tripModel：		(GMTCTripModel *)	tripModel
doUpdateTripStatus：		(列舉 GMTSTripStatus)	tripStatus
			[optional]

目前的行程狀態更新時，會呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
tripStatus	更新後的行程狀態。

- (void) tripModel：		(GMTCTripModel *)	tripModel
doUpdateVehicleLocation：		(可為空值 GMTSVehicleLocation *)	vehicleLocation
			[optional]

在車輛的位置資訊更新時呼叫。

新位置不得與之前的位置不同。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
vehicleLocation	目前行程的最後已知車輛位置。

- (void) tripModel：		(GMTCTripModel *)	tripModel
doUpdatePickupLocation：		(可為 GMTSTerminalLocation 為空值 *)	pickupLocation
			[optional]

更新取貨地點時呼叫。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
pickupLocation	目前的上車地點。如果行程經過重設或取消，就可能是 nil。

- (void) tripModel：		(GMTCTripModel *)	tripModel
doUpdateDropoffLocation：		(可為 GMTSTerminalLocation 為空值 *)	dropoffLocation
			[optional]

下車地點更新時呼叫。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
dropoffLocation	目前的下車地點。如果行程經過重設或取消，就可能是 nil。

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

到達下一個路線控點的預計到達時間時呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
nextWaypointETA	司機目前的預計到達地點抵達上車地點。如果行程經過重設或取消，則可能為 0。

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

司機的預計到達點抵達上車地點時呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
pickupETA	司機目前的預計到達地點抵達上車地點。如果行程經過重設或取消，則可能為 0。

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

司機的預計到達時間更新時呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
dropoffETA	司機目前的預計到達點抵達下車地點。如果行程經過重設或取消，則可能為 0。

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

行程有效路線的剩餘距離更新時，會呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
activeRouteRemainingDistance	目前路線和下一個重要位置之間的有效路線距離 (公尺)。下一個重要地點視目前行程的狀態而定。如果行程狀態為「GMTSTripStatusEnrouteToPickup」，則表示此為與上車地點之間的距離。如果行程狀態為「GMTSTripStatusEnrouteToDropoff」，這是指與下車地點之間的距離。您的應用程式必須提供所有必要的評估轉換。

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

行程的有效路線路段更新時，會呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
activeRoute	目前行程的有效路線路段。這個路段包含從車輛目前位置到下一個重要位置的路線。如果行程狀態為「GMTSTripStatusEnrouteToPickup」，下一個重要的地點就是上車地點。如果行程狀態為「GMTSTripStatusEnrouteToDropoff」，下一個重要的地點就是下車地點。

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

在行程的其餘路線部分更新時，會呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
remainingRoute	目前行程的其餘路線路段。這個區隔包含從目前使用者下一個目的地到使用者最終目的地的路徑。如果行程狀態為「GMTSTripStatusEnrouteToPickup」，剩餘路線路段就是從上車地點到下車地點的路段。

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

行程其餘路線的距離更新時，會呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
remainingRouteDistance	目前使用者前往下一個目的地的剩餘路線距離 (以公尺為單位)。下一個目的地取決於目前行程的狀態。如果行程狀態為「GMTSTripStatusEnrouteToPickup」，下一個目的地就是下車地點。您的應用程式必須提供所有必要的評估轉換。

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

行程中繼路線控點更新時，會呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
remainingWaypoints	目前剩餘的路線控點。

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

行程路線控點更新時，會呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
intermediateDestinations	這趟行程目前剩餘的中繼路線控點。

- (void) tripModel：		(GMTCTripModel *)	tripModel
doUpdateActiveRouteTraffic：		(可為空值 GMTSTrafficData *)	activeRouteTraffic
			[optional]

當行程的有效路線路段更新車流量資料時，會呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
activeRouteTraffic	目前行程的有效路線車流量路段，這個路段包含從車輛目前位置到下一個重要位置的路線。如果行程狀態為「GMTSTripStatusEnrouteToPickup」，下一個重要的地點就是上車地點。如果行程狀態為「GMTSTripStatusEnrouteToDropoff」，下一個重要的地點就是下車地點。

- (void) tripModel：		(GMTCTripModel *)	tripModel
doUpdateRemainingRouteTraffic：		(可為空值 GMTSTrafficData *)	remainingRouteTraffic
			[optional]

當行程中其餘路線的車流量更新時，會呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
remainingRouteTraffic	目前行程中其餘路線路段的車流量資料。

- (void) tripModel：		(GMTCTripModel *)	tripModel
doFailUpdateTripWithError：		(nullable NSError *)	錯誤
			[optional]

在行程監控要求錯誤更新時，會呼叫此方法。

參數：

tripModel	產生事件的 GMTCTripModel 例項。
錯誤	目前行程監控要求的錯誤。這個值可以是 nil。