<GMSAutocompleteViewControllerAdmin> مرجع البروتوكول

مرجع بروتوكول <GMSAutocompleteViewControllerمنافذ>

نظرة عامة

البروتوكول الذي يستخدمه GMSAutocompleteViewController لإبلاغ التطبيق بتفاعل المستخدم مع وحدة التحكّم.

وظائف الأعضاء العامين

(void) - viewController:didAutocompleteWithPlace:
 يتم استدعاء هذا الحدث عند اختيار مكان من توقعات الإكمال التلقائي المتاحة.
(void) - viewController:didFailAutocompleteWithError:
 يتم استدعاؤه عند حدوث خطأ لا يمكن إعادة المحاولة عند استرداد عبارات البحث المقترحة من خلال ميزة "الإكمال التلقائي" أو تفاصيل المكان.
(void) - تم إلغاؤه:
 يتم استدعاء هذا الإجراء عندما ينقر المستخدم على زر "إلغاء" في "GMSAutocompleteViewController".
(BOOL) - viewController:didSelectForecastion:
 يتم استدعاء هذا الحدث عندما يختار المستخدم توقعًا للإكمال التلقائي من القائمة ولكن قبل طلب تفاصيل المكان.
(void) - didUpdateAutocompleteForecastions:
 يتم استدعاء هذا الإجراء مرة واحدة في كل مرة يتم فيها تلقّي عبارات بحث مقترحة جديدة ضمن ميزة "الإكمال التلقائي".
(void) - didRequestAutocompleteForecastions:
 يتم استدعاءه مرة واحدة مباشرةً بعد تقديم طلب لعبارات البحث المقترحة من خلال ميزة "الإكمال التلقائي".

وثائق وظائف الأعضاء

- (void) viewController: (GMSAutocompleteViewController *) viewController
doAutocompleteWithPlace: (GMSPlace *) مكان
[required]

يتم استدعاء هذا الحدث عند اختيار مكان من توقعات الإكمال التلقائي المتاحة.

يجب أن يستبعد تنفيذ هذه الطريقة وحدة التحكم في العرض، لأن وحدة التحكم في العرض لن تتجاهل نفسها.

المَعلمات:
viewControllerGMSAutocompleteViewController الذي أدى إلى إنشاء الحدث.
مكانGMSPlace التي تم إرجاعها
- (void) viewController: (GMSAutocompleteViewController *) viewController
doFailAutocompleteWithError: (NSError *) خطأ
[required]

يتم استدعاؤه عند حدوث خطأ لا يمكن إعادة المحاولة عند استرداد عبارات البحث المقترحة من خلال ميزة "الإكمال التلقائي" أو تفاصيل المكان.

يتم تعريف الخطأ الذي لا يمكن إعادة محاولة إصلاحه بأنه خطأ لا يمكن إصلاحه عن طريق إعادة محاولة العملية على الفور.

لا يمكن إعادة المحاولة إلا في ما يلي من قيم GMSPlacesErrorCode:

  • kGMSPlacesNetworkError
  • kGMSPlacesServerError
  • kGMSPlacesInternalError

وجميع رموز الخطأ الأخرى لا يمكن إعادة المحاولة.

المَعلمات:
viewControllerGMSAutocompleteViewController الذي أدى إلى إنشاء الحدث.
خطأNSError التي تم إرجاعها
- (باطل) تم إلغاؤه: (GMSAutocompleteViewController *) viewController [required]

يتم استدعاء هذا الإجراء عندما ينقر المستخدم على زر "إلغاء" في "GMSAutocompleteViewController".

يجب أن يستبعد تنفيذ هذه الطريقة وحدة التحكم في العرض، لأن وحدة التحكم في العرض لن تتجاهل نفسها.

المَعلمات:
viewControllerGMSAutocompleteViewController الذي أدى إلى إنشاء الحدث.
- (BOOL) وحدة التحكّم في العرض: (GMSAutocompleteViewController *) viewController
dSelectselection: (GMSAutocompletePrediction *) التوقّع
[optional]

يتم استدعاء هذا الحدث عندما يختار المستخدم توقعًا للإكمال التلقائي من القائمة ولكن قبل طلب تفاصيل المكان.

سيؤدي عرض "لا" من هذه الطريقة إلى إيقاف استرجاع تفاصيل المكان ولن يتم استدعاء doAutocompleteWithPlace.

المَعلمات:
viewControllerGMSAutocompleteViewController الذي أدى إلى إنشاء الحدث.
التوقّعGMSAutocompletePrediction الذي تم اختياره.
- (void) didUpdateAutocompletecompleteions: (GMSAutocompleteViewController *) viewController [optional]

يتم استدعاء هذا الإجراء مرة واحدة في كل مرة يتم فيها تلقّي عبارات بحث مقترحة جديدة ضمن ميزة "الإكمال التلقائي".

المَعلمات:
viewControllerGMSAutocompleteViewController الذي أدى إلى إنشاء الحدث.

يتم استدعاءه مرة واحدة مباشرةً بعد تقديم طلب لعبارات البحث المقترحة من خلال ميزة "الإكمال التلقائي".

المَعلمات:
viewControllerGMSAutocompleteViewController الذي أدى إلى إنشاء الحدث.