<GMSAutocompleteResultsViewController 委派> 通訊協定參考資料

<GMSAutocompleteResultsViewController 委派> 通訊協定參考資料

總覽

GMSAutocompleteResultsViewController 使用的通訊協定,用於將使用者與控制器之間的互動傳送至應用程式。

公開成員函式

(void) - resultsController:didAutocompleteWithPlace:
 從可用的自動完成預測清單中選取地點時,會呼叫此方法。
(void) - resultsController:didFailAutocompleteWithError:
 擷取自動完成預測或 Place Details 時,發生無法重試的錯誤時呼叫。
(BOOL) - resultsController:didSelectPrediction:
 使用者從清單選取自動預測結果,但在要求 Place Details 之前,會呼叫此方法。
(void) - didUpdateAutocompletePredictionsForResultsController:
 每次收到新的自動完成預測時呼叫一次。
(void) - didRequestAutocompletePredictionsForResultsController:
 在提出自動完成預測的要求後,會立即呼叫一次。

成員函式說明文件

- (void) resultController: (GMSAutocompleteResultsViewController *) resultsController
doAutocompleteWithPlace: (GMSPlace *) place
[required]

從可用的自動完成預測清單中選取地點時,會呼叫此方法。

參數:
resultsController產生事件的 GMSAutocompleteResultsViewController
地點傳回的 GMSPlace
- (void) resultController: (GMSAutocompleteResultsViewController *) resultsController
doFailAutocompleteWithError: (NSError *) 錯誤
[required]

擷取自動完成預測或 Place Details 時,發生無法重試的錯誤時呼叫。

所謂不可重試的錯誤,是指無法透過立即重試的方式修正。

只有下列 GMSPlacesErrorCode 的值可重試:

  • kGMSPlacesNetworkError
  • kGMSPlacesServerError
  • kGMSPlacesInternalError

所有其他錯誤代碼都無法重試。

參數:
resultsController產生事件的 GMSAutocompleteResultsViewController
錯誤傳回的 NSError
- (BOOL) resultsController: (GMSAutocompleteResultsViewController *) resultsController
hasSelectPrediction: (GMSAutocompletePrediction *) 預測
[optional]

使用者從清單選取自動預測結果,但在要求 Place Details 之前,會呼叫此方法。

透過這個方法傳回 NO 時,系統會隱藏地點詳細資料擷取作業,而且不會呼叫 doAutocompleteWithPlace。

參數:
resultsController產生事件的 GMSAutocompleteResultsViewController
預測所選的 GMSAutocompletePrediction

每次收到新的自動完成預測時呼叫一次。

參數:
resultsController產生事件的 GMSAutocompleteResultsViewController

在提出自動完成預測的要求後,會立即呼叫一次。

參數:
resultsController產生事件的 GMSAutocompleteResultsViewController