بررسی اجمالی

پروتکل مورد استفاده توسط GMSAutocompleteViewController ، برای برقراری ارتباط تعامل کاربر با کنترلر به برنامه.

توابع اعضای عمومی
(خالی)	- viewController:didAutocompleteWithPlace:
	زمانی فراخوانی می شود که مکانی از پیش بینی های تکمیل خودکار موجود انتخاب شده باشد.
(خالی)	- viewController:didFailAutocompleteWithError:
	هنگامی که هنگام بازیابی پیش‌بینی‌های تکمیل خودکار یا جزئیات مکان، خطای غیرقابل امتحانی رخ دهد، تماس گرفته می‌شود.
(خالی)	- لغو شد:
	زمانی که کاربر روی دکمه لغو در یک `GMSAutocompleteViewController` ضربه می‌زند، تماس می‌گیرد.
(بول)	- viewController:didSelectPrediction:
	زمانی که کاربر یک پیش‌بینی تکمیل خودکار را از لیست انتخاب می‌کند، اما قبل از درخواست جزئیات مکان، فراخوانی می‌شود.
(خالی)	- didUpdateAutocompletePredictions:
	هر بار که پیش‌بینی‌های تکمیل خودکار جدید دریافت می‌شود، یک بار تماس گرفته می‌شود.
(خالی)	- didRequestAutocompletePredictions:
	بلافاصله پس از درخواست پیش‌بینی تکمیل خودکار، یک بار تماس گرفته می‌شود.

مستندات عملکرد اعضا

- (void) viewController:	( GMSAutocompleteViewController *)	viewController
didAutocompleteWithPlace:	( GMSPlace *)	محل
		`[required]`

زمانی فراخوانی می شود که مکانی از پیش بینی های تکمیل خودکار موجود انتخاب شده باشد.

پیاده سازی این روش باید view controller را رد کند زیرا view controller خودش را رد نمی کند.

مولفه های:

viewController	`GMSAutocompleteViewController` که رویداد را ایجاد کرد.
محل	`GMSPlace` که برگردانده شد.

- (void) viewController:	( GMSAutocompleteViewController *)	viewController
didFailAutocompleteWithError:	(خطای NSE *)	خطا
		`[required]`

هنگامی که هنگام بازیابی پیش‌بینی‌های تکمیل خودکار یا جزئیات مکان، خطای غیرقابل امتحانی رخ دهد، تماس گرفته می‌شود.

خطای غیر قابل امتحان مجدد به عنوان خطای تعریف می شود که بعید به نظر می رسد با تکرار فوری عملیات برطرف شود.

فقط مقادیر زیر GMSPlacesErrorCode قابل امتحان مجدد هستند:

همه کدهای خطای دیگر قابل امتحان مجدد نیستند.

مولفه های:

viewController	`GMSAutocompleteViewController` که رویداد را ایجاد کرد.
خطا	`NSError` که برگردانده شد.

- (باطل) لغو شد: ( GMSAutocompleteViewController *) viewController [required]

زمانی که کاربر روی دکمه لغو در یک GMSAutocompleteViewController ضربه می‌زند، تماس می‌گیرد.

پیاده سازی این روش باید view controller را رد کند زیرا view controller خودش را رد نمی کند.

مولفه های:

viewController GMSAutocompleteViewController که رویداد را ایجاد کرد.

- (BOOL) viewController:	( GMSAutocompleteViewController *)	viewController
didSelectPrediction:	( GMSAutocompletePrediction *)	پیش بینی
		`[optional]`

زمانی که کاربر یک پیش‌بینی تکمیل خودکار را از لیست انتخاب می‌کند، اما قبل از درخواست جزئیات مکان، فراخوانی می‌شود.

برگرداندن NO از این روش، واکشی جزئیات مکان را متوقف می کند و didAutocompleteWithPlace فراخوانی نخواهد شد.

مولفه های:

viewController	`GMSAutocompleteViewController` که رویداد را ایجاد کرد.
پیش بینی	`GMSAutocompletePrediction` که انتخاب شد.

- (باطل) didUpdateAutocompletePredictions: ( GMSAutocompleteViewController *) viewController [optional]

هر بار که پیش‌بینی‌های تکمیل خودکار جدید دریافت می‌شود، یک بار تماس گرفته می‌شود.

مولفه های:

viewController GMSAutocompleteViewController که رویداد را ایجاد کرد.

- (void) didRequestAutocompletePredictions: ( GMSAutocompleteViewController *) viewController [optional]

بلافاصله پس از درخواست پیش‌بینی تکمیل خودکار، یک بار تماس گرفته می‌شود.

مولفه های:

viewController GMSAutocompleteViewController که رویداد را ایجاد کرد.