<GMSAutocompleteTableDataSourceDelegate> 通訊協定參考資料

<GMSAutocompleteTableDataSourceDelegate> 通訊協定參考資料

總覽

GMSAutocompleteTableDataSource 所使用的通訊協定,用於將使用者的資料來源與應用程式之間的互動,

公開成員函式

(無效)- tableDataSource:didAutocompleteWithPlace:
 從可用自動完成預測中選出某個地點時呼叫。
(無效)- tableDataSource:didFailAutocompleteWithError:
 在擷取自動完成預測或地點詳細資訊時發生無法重試的錯誤時呼叫。
(布林值)- tableDataSource:didSelectPrediction:
 使用者在清單中選取自動完成預測查詢字串,但在要求地點詳細資訊前,系統會呼叫此方法。
(無效)- didUpdateAutocompleteAutocompletePredictForTableDataSource:
 每次收到新的自動完成預測時呼叫一次。
(無效)- didRequestAutocompletePredictionsForTableDataSource:
 在提出自動完成預測要求之後立即呼叫一次。

成員函式說明文件

- (void) tableDataSource: (GMSAutocompleteTableDataSource *) 資料表資料來源
doAutocompleteWithPlace: (GMSPlace *) place [地點]
[required]

從可用自動完成預測中選出某個地點時呼叫。

參數:
資料表資料來源產生事件的 GMSAutocompleteTableDataSource
地點傳回的 GMSPlace
- (void) tableDataSource: (GMSAutocompleteTableDataSource *) 資料表資料來源
doesFailAutocompleteWithError: (NSError *) error
[required]

在擷取自動完成預測或地點詳細資訊時發生無法重試的錯誤時呼叫。

不可重試的錯誤的定義是可能無法立即重試作業來修正。

只有以下 GMSPlacesErrorCode 值可以重試:

  • kGMSPlacesNetwork 錯誤
  • kGMSPlacesServerError
  • kGMSPlacesInternalError

所有其他錯誤代碼不可重試。

參數:
資料表資料來源產生事件的 GMSAutocompleteTableDataSource
錯誤傳回的 NSError
- (BOOL) tableDataSource: (GMSAutocompleteTableDataSource *) 資料表資料來源
doSelectPrediction: (GMSAutocompletePrediction *) 預測
[optional]

使用者在清單中選取自動完成預測查詢字串,但在要求地點詳細資訊前,系統會呼叫此方法。

如果透過此方法傳回 NO,會隱藏地點詳細資訊擷取作業,系統也不會呼叫 doAutocompleteWithPlace。

參數:
資料表資料來源產生事件的 GMSAutocompleteTableDataSource
預測選取的 GMSAutocompletePrediction

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

參數:
資料表資料來源產生事件的 GMSAutocompleteTableDataSource

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

參數:
資料表資料來源產生事件的 GMSAutocompleteTableDataSource