GMSLocationSimulator 類別參考資料

GMSLocationSimulator 類別參考資料

總覽

可用於模擬裝置位置以進行測試的類別。

公開成員函式

(void) - simulateLocationsAlongExistingRoute
 開始模擬行經目前設定的路線GMSNavigator
(void) - emulatorAlongNewRouteToDestinations:callback:
 計算前往指定路線控點的路線,並模擬這條路線沿途的行駛情形。
(void) - simulateAlongNewRouteToDestinations:routingOptions:callback:
 計算前往指定路線控點的路線,並模擬這條路線沿途的行駛情形。
(void) - emulatorLocationAtCoordinate:
 以固定的座標模擬裝置位置。
(void) - stopSimulation
 如果目前正在模擬裝置位置,系統會停止模擬裝置位置。
(void) - simulateNavigationPrompt
 顯示包含假資料的導航提示以進行測試。
(void) - simulateTrafficIncidentReport
 顯示虛擬流量提示以供測試。

資源

BOOL已暫停
 是否暫停模擬作業。
BOOLavoidsHighways
 使用 simulateAlongNewRouteToDestinations:callback: 方法模擬前往目的地時,是否要避開高速公路。
BOOLavoidsTolls
 使用 simulateAlongNewRouteToDestinations:callback: 方法模擬前往目的地時,是否應避開收費路段。
BOOLavoidsFerries
 使用 simulateAlongNewRouteToDestinations:callback: 方法模擬前往目的地時,是否要避免搭乘渡輪。
float speedMultiplier
 模擬沿路線行駛時要使用的速度係數。
BOOLlocationJitteringEnabled
 模擬位置是否應隨機發出時基誤差。
GMSNavigationLicensePlateRestrictionlicensePlateRestriction
 使用目前車輛的末碼和國家/地區代碼,設定車牌限制。

成員函式說明文件

開始模擬行經目前設定的路線GMSNavigator

如果GMSNavigator沒有路線,則不會有任何動作。

- (void) 模擬 AlongNewRouteToDestinations: (NSArray< GMSNavigationWaypoint * > *) 目的地
回呼: (GMSRouteStatusCallback) 回呼

計算前往指定路線控點的路線,並模擬這條路線沿途的行駛情形。

新路線會使用在站上設定的交通方式GMSMapView

使用 GMSRouteStatusOK 呼叫回呼之前,將會開始行駛。如果回呼傳回 GMSRouteStatusOK 以外的任何值,就不會開始模擬。如果在產生路線前已呼叫任何其他模擬器方法,系統將取消路線產生作業,並且會呼叫回呼 GMSRouteStatusCanceled。

參數:
目的地即將模擬路線的目的地清單。
回呼路線可供使用或失敗時,系統會呼叫的區塊。
- (void) 模擬 AlongNewRouteToDestinations: (NSArray< GMSNavigationWaypoint * > *) 目的地
routeOptions: (GMSNavigationRoutingOptions *) routingOptions
回呼: (GMSRouteStatusCallback) 回呼

計算前往指定路線控點的路線,並模擬這條路線沿途的行駛情形。

新的路線會使用在站上設定的交通方式GMSMapView

旅程從使用 GMSRouteStatusOK 叫用回呼之前開始。如果回呼傳回 GMSRouteStatusOK 以外的值,表示不會啟動模擬。如果在產生路線之前已呼叫任何其他模擬方法,則將取消產生路線,並且會透過 GMSRouteStatusCanceled 呼叫回呼。

參數:
目的地即將模擬路線的目的地清單。
routingOptions決定傳迴路徑的轉送邏輯。
回呼路線可供使用或失敗時,系統會呼叫的區塊。
- (void) imLocationAtCoordinate: (CLLocationCoordinate2D)  座標

以固定的座標模擬裝置位置。

- (void) stopSimulation

如果目前正在模擬裝置位置,系統會停止模擬裝置位置。

顯示包含假資料的導航提示以進行測試。

顯示虛擬流量提示以供測試。


屬性說明文件

- (BOOL) 已暫停 [read, write, assign]

是否暫停模擬作業。

如果將這個項目設為 YES,當在路線模擬時,系統仍會定期傳送位置更新,但此地點會沿著路線停止前進。

- (BOOL) avoidsHighways [read, write, assign]

使用 simulateAlongNewRouteToDestinations:callback: 方法模擬前往目的地時,是否要避開高速公路。

預設值為 NO。

- (BOOL) avoidsTolls [read, write, assign]

使用 simulateAlongNewRouteToDestinations:callback: 方法模擬前往目的地時,是否應避開收費路段。

預設值為 NO。

- (BOOL) avoidsFerries [read, write, assign]

使用 simulateAlongNewRouteToDestinations:callback: 方法模擬前往目的地時,是否要避免搭乘渡輪。

預設值為 YES。

- (浮點值) speedMultiplier [read, write, assign]

模擬沿路線行駛時要使用的速度係數。

這項屬性的值必須為正數。嘗試設定非正數的值不會有任何作用。預設值為 1.0。

- (BOOL) locationJitteringEnabled [read, write, assign]

模擬位置是否應隨機發出時基誤差。

使用目前車輛的末碼和國家/地區代碼,設定車牌限制。

如此一來,我們就能依據車牌號碼,繞過特定類型的道路限制。這項設定僅適用於設定此值後發出的 MPAlongNewRouteToDestinations 呼叫。

如果沒有車牌,請設為 nil。預設為 nil。