<GMSAutocompleteViewControllerDelegate> 协议参考

<GMSAutocompleteViewControllerDelegate> 协议参考

概览

GMSAutocompleteViewController 使用的协议,用于将用户与控制器的交互传达给应用。

公开成员函数

(void) - viewController:didAutocompleteWithPlace
 从提供的自动补全预测结果中选择某个地点后调用。
(void) - viewController:didFailAutocompleteWithError:
 在检索自动补全预测结果或地点详情时发生不可重试错误时调用。
(void) - wasCancelled
 在用户点按 GMSAutocompleteViewController 中的“Cancel”按钮时调用。
(BOOL) - viewController:didSelectPrediction
 在用户从列表中选择自动补全预测结果之前但在请求地点详情之前调用。
(void) - didUpdateAutocompletePredictions
 每次收到新的自动补全预测结果时调用一次。
(void) - didRequestAutocompletePredictions
 在请求自动补全联想查询后立即调用一次。

成员函数文档

- (void) viewController: (GMSAutocompleteViewController *) viewController
dodAutocompleteWithPlace: (GMSPlace *) 地点
[required]

从提供的自动补全预测结果中选择某个地点后调用。

此方法的实现应关闭视图控制器,因为视图控制器不会自行关闭。

参数:
viewController生成事件的 GMSAutocompleteViewController
地点返回的 GMSPlace
- (void) viewController: (GMSAutocompleteViewController *) viewController
doFailAutocompleteWithError: (NSError *) 错误
[required]

在检索自动补全预测结果或地点详情时发生不可重试错误时调用。

不可重试的错误定义为不太可能通过立即重试操作来修复的错误。

只有以下 GMSPlacesErrorCode 值可重试:

  • kGMSPlacesNetworkError
  • kGMSPlacesServerError
  • kGMSPlacesInternalError

所有其他错误代码均不可重试。

参数:
viewController生成事件的 GMSAutocompleteViewController
error返回的 NSError
- (void) wasCancelled (GMSAutocompleteViewController *) viewController [required]

在用户点按 GMSAutocompleteViewController 中的“Cancel”按钮时调用。

此方法的实现应关闭视图控制器,因为视图控制器不会自行关闭。

参数:
viewController生成事件的 GMSAutocompleteViewController
- (BOOL) viewController: (GMSAutocompleteViewController *) viewController
dodSelectPrediction: (GMSAutocompletePrediction *) 预测
[optional]

在用户从列表中选择自动补全预测结果之前但在请求地点详情之前调用。

如果从此方法返回 NO,则会抑制地点详情提取,并且不会调用 DidAutocompleteWithPlace。

参数:
viewController生成事件的 GMSAutocompleteViewController
预测所选的 GMSAutocompletePrediction
- (void) didUpdateAutocompletePredictions (GMSAutocompleteViewController *) viewController [optional]

每次收到新的自动补全预测结果时调用一次。

参数:
viewController生成事件的 GMSAutocompleteViewController
- (void) didRequestAutocompletePredictions (GMSAutocompleteViewController *) viewController [optional]

在请求自动补全联想查询后立即调用一次。

参数:
viewController生成事件的 GMSAutocompleteViewController