نظرة عامة

الواجهة الرئيسية لحزمة تطوير برامج الأماكن.

يتم استخدام البيانات للبحث والحصول على تفاصيل حول الأماكن. يجب الوصول إلى هذه الفئة من خلال الإجراء [GMSPlacesClient sharedClient].

يجب استدعاء طرق GMSPlacesClient من سلسلة المحادثات الرئيسية فقط. سيؤدي استدعاء هذه الطرق من سلسلة محادثات أخرى إلى استثناء أو سلوك غير محدد. ما لم يُنص على خلاف ذلك، سيتم استدعاء جميع عمليات الاستدعاء في سلسلة المحادثات الرئيسية.

الوظائف العامة
(مُلغاة)	- lookUpPlaceID:callback:
	يمكنك الحصول على تفاصيل عن مكان معيّن.
(مُلغاة)	- fetchAutocompleteSuggestionsFromRequest:callback:
	يمكنك العثور على اقتراحات الإكمال التلقائي من طلب البحث النصي.
(مُلغاة)	- lookUpPhotosForPlaceID:callback:
	يتيح هذا الخيار الحصول على البيانات الوصفية لما يصل إلى 10 صور مرتبطة بأحد الأماكن.
(مُلغاة)	- loadPlacePhoto:callback:
	لتحميل صورة معينة بحجمها الأقصى.
(مُلغاة)	- loadPlacePhoto:constrainedToSize:scale:callback:
	لتحميل الصورة لصورة معينة، مع تغيير حجمها لتلائم الحد الأقصى للأبعاد المحددة.
(مُلغاة)	- currentPlaceWithCallback:
	عرض تقدير للمكان الذي يُعرف عن وجود الجهاز فيه حاليًا.
(مُلغاة)	- findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
	يمكنك العثور على عبارات بحث مقترحة للإكمال التلقائي استنادًا إلى طلب بحث نصي.
(مُلغاة)	- fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
	استرجاع تفاصيل مكان
(مُلغاة)	- findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
	العثور على احتمالية الأماكن باستخدام الموقع الجغرافي الحالي للمستخدم.
(مُلغاة)	- isOpenWithRequest:callback:
	يحصل على حالة "مفتوح" لمكان ما.
(مُلغاة)	- isOpenWithPlaceID:callback:
	للحصول على تفاصيل عن مكان، بما في ذلك جميع الحقول اللازمة لتحديد `GMSPlaceOpenStatus` في الوقت الحالي.
(مُلغاة)	- isOpenWithPlaceID:date:callback:
	للحصول على تفاصيل عن مكان، بما في ذلك جميع الحقول اللازمة لتحديد `GMSPlaceOpenStatus` في `NSDate` المحدّد
(مُلغاة)	- isOpenWithPlace:callback:
	للحصول على تفاصيل عن مكان، بما في ذلك جميع الحقول اللازمة لتحديد `GMSPlaceOpenStatus` في الوقت الحالي.
(مُلغاة)	- isOpenWithPlace:date:callback:
	للحصول على تفاصيل عن مكان، بما في ذلك جميع الحقول اللازمة لتحديد `GMSPlaceOpenStatus` في `NSDate` المحدّد
(مُلغاة)	- searchByTextWithRequest:callback:
	البحث عن الأماكن حسب النص والقيود
(مُلغاة)	- fetchPlaceWithRequest:callback:
	الحصول على مكان باستخدام كائن طلب.
(مُلغاة)	- fetchPhotoWithRequest:callback:
	اطلب صورة باستخدام طلب جلب الصورة.
(مُلغاة)	- searchNearbyWithRequest:callback:
	ابحث عن أماكن بالقرب من أحد المواقع الجغرافية والقيود المفروضة.
الوظائف الأساسية الثابتة للأعضاء
(instancetype)	+ sharedClient
	يتم توفير المثيل المشترك من GMSPlacesClient لحزمة تطوير برامج أماكن Google لنظام التشغيل iOS، وإنشائه إذا لزم الأمر.
(منطقي)	+ توفير واجهة برمجة التطبيقات:
	يقدم مفتاح واجهة برمجة التطبيقات إلى حزمة تطوير البرامج لأماكن Google لنظام التشغيل iOS.
(NSString *)	+ openSourceLicenseInfo
	عرض معلومات ترخيص البرامج مفتوحة المصدر لحزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS.
(NSString *)	+ SDKVersion
	عرض إصدار هذا الإصدار من حزمة تطوير برامج أماكن Google لنظام التشغيل iOS.
(NSString *)	+ SDKLongVersion
	عرض النسخة الطويلة لهذا الإصدار من حزمة تطوير برامج أماكن Google لنظام التشغيل iOS.
الدوال ذات الصلة
(لاحظ أن هذه ليست دوال عضوية.)
typedef null(^)	GMSPlaceResultCallback )(GMSPlace _Nullable results, NSError _Nullable error)
	نوع معاودة الاتصال لتلقّي عمليات البحث عن تفاصيل المكان.
typedef null(^)	GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList _Nullable جوالList, NSError _Nullable error)
	نوع معاودة الاتصال لتلقّي قوائم احتمالية الأماكن.
typedef null(^)	GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > _Nullable likelys, NSError _Nullable error)
	نوع معاودة الاتصال لتلقّي مصفوفة `GMSPlaceLikelihood`.
typedef null(^)	GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > _Nullable results, NSError _Nullable error)
	نوع معاودة الاتصال لتلقّي نتائج الإكمال التلقائي.
typedef null(^)	GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList _Nullable photos, NSError _Nullable error)
	نوع معاودة الاتصال لتلقّي نتائج صور الأماكن.
typedef null(^)	GMSPlacePhotoImageResultCallback )(UIImage _Nullable image, NSError _Nullable error)
	نوع معاودة الاتصال لتلقّي `UIImage` عناصر من عنصر `GMSPlacePhotoMetadata`.
typedef null(^)	GMSPlaceOpenStatusCallback )(نتيجة GMSPlaceOpenStatus، NSError *_Nullable error)
	نوع معاودة الاتصال لتلقي حالة ساعات العمل للمكان.
typedef null(^)	GMSPlaceOpenStatusResponseCallback )(GMSPlaceIsOpenResponse response, NSError _Nullable error)
	نوع معاودة الاتصال لتلقي استجابة الحالة "مفتوح".
typedef null(^)	GMSPlaceSearchByTextResultCallback )(NSArray< GMSPlace * > _Nullable places, NSError _Nullable error)
	نوع معاودة الاتصال لتلقّي البحث حسب النتائج النصية.
typedef null(^)	GMSFetchPhotoResultCallback )(UIImage _Nullable imageImage, NSError _Nullable error)
	نوع معاودة الاتصال لتلقّي صورة.
typedef null(^)	GMSAutocompleteSuggestionsCallback )(NSArray< GMSAutocompleteSuggestion * > _Nullable results, NSError _Nullable error)
	نوع معاودة الاتصال لنتائج الإكمال التلقائي.
typedef null(^)	GMSPlaceSearchNearbyResultCallback )(NSArray< GMSPlace * > _Nullable places, NSError _Nullable error)
	نوع معاودة الاتصال لتلقّي نتائج البحث في الأماكن القريبة.

المستندات الخاصة بوظائف الأعضاء

+ (instancetype) sharedClient

يتم توفير المثيل المشترك من GMSPlacesClient لحزمة تطوير برامج أماكن Google لنظام التشغيل iOS، وإنشائه إذا لزم الأمر.

إذا كان تطبيقك يستخدم غالبًا طرق GMSPlacesClient، قد يحتاج إلى الاحتفاظ بهذا الكائن مباشرةً، وإلا فقد تتم إعادة تشغيل اتصالك بـ Google بشكل منتظم.

+ (BOOL) توفير مفتاح واجهة برمجة التطبيقات: (NSString *) مفتاح

يقدم مفتاح واجهة برمجة التطبيقات إلى حزمة تطوير البرامج لأماكن Google لنظام التشغيل iOS.

يتم إنشاء هذا المفتاح لتطبيقك عبر وحدة تحكُّم Google Cloud Platform، ويتم إقرانه بمعرّف حزمة تطبيقك لتحديده. ويجب أن يطلب تطبيقك ذلك قبل استخدام GMSPlacesClient (على سبيل المثال، في application:didFinishLaunchingWithOptions:).

المرتجعات:: نعم إذا تم تقديم APIKey بنجاح.

+ (NSString *) openSourceLicenseInfo

عرض معلومات ترخيص البرامج مفتوحة المصدر لحزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS.

يجب أن تكون هذه المعلومات متاحة داخل طلبك.

+ (NSString *) SDKVersion

عرض إصدار هذا الإصدار من حزمة تطوير برامج أماكن Google لنظام التشغيل iOS.

. على سبيل المثال، "1.0.0".

+ (NSString *) SDKLongVersion

عرض النسخة الطويلة لهذا الإصدار من حزمة تطوير برامج أماكن Google لنظام التشغيل iOS.

. على سبيل المثال: "1.0.0 (102.1)".

- (فارغ) LookUpPlaceID:	(NSString *)	placeID
رد الاتصال:	(GMSPlaceResultCallback)	معاودة الاتصال

يمكنك الحصول على تفاصيل عن مكان معيّن.

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:

placeID	رقم تعريف المكان المطلوب البحث فيه
رد الاتصال	يشير هذا المصطلح إلى رد الاتصال المطلوب استدعاؤه مع نتيجة البحث.

ملاحظة:: تم إيقاف هذا نهائيًا. تم استبدال هذه الطريقة بـ fetchPlaceWithRequest:callback: وستتم إزالتها في إصدار مستقبلي.

- (باطل) getAutocompletesuggestionsFromRequest:	(GMSAutocompleteRequest *)	طلب
رد الاتصال:	(GMSAutocompleteSuggestionsCallback)	معاودة الاتصال

يمكنك العثور على اقتراحات الإكمال التلقائي من طلب البحث النصي.

قد تكون النتائج منحازة بشكل اختياري نحو موقع معين أو تقتصر على منطقة معينة. لا تؤدي هذه الطريقة إلى الحظر.

سيتم استدعاء رد الاتصال المقدم مع مجموعة من اقتراحات الإكمال التلقائي عند النجاح وخطأ NSError عند حدوث خطأ.

المَعلمات:

طلب	طلب `GMSAutocompleteRequest` للإكمال التلقائي
رد الاتصال	معاودة الاتصال لاستدعاء مع الاقتراحات.

- (غير صالح) lookUpPhotosForPlaceID:	(NSString *)	placeID
رد الاتصال:	(GMSPlacePhotoMetadataResultCallback)	معاودة الاتصال

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

يتم الحصول على الصور من مجموعة متنوعة من المواقع، بما في ذلك مالكي الأنشطة التجارية والصور التي يساهم بها مستخدمو Google+. وفي معظم الحالات، يمكن استخدام هذه الصور بدون نَسب العمل، أو سيتم تضمين الإسناد المطلوب كجزء من الصورة. مع ذلك، يجب استخدام السمة attributions في الردّ لاسترداد أي إحالات إضافية مطلوبة وعرض عمليات تحديد المصدر هذه في تطبيقك أينما تعرض الصورة. يتم إرجاع 10 صور كحدّ أقصى.

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

تقوم هذه الطريقة بإجراء بحث عن الشبكة.

المَعلمات:

placeID	رقم تعريف المكان المطلوب البحث عن صور له.
رد الاتصال	يشير هذا المصطلح إلى رد الاتصال المطلوب استدعاؤه مع نتيجة البحث.

- (فارغ) loadPlacePhoto:	(GMSPlacePhotoMetadata *)	photoMetadata
رد الاتصال:	(GMSPlacePhotoImageResultCallback)	معاودة الاتصال

لتحميل صورة معينة بحجمها الأقصى.

وقد يتم تخزين بيانات الصور مؤقتًا من خلال حزمة تطوير البرامج (SDK). في حال عدم توفّر الصورة المطلوبة في ذاكرة التخزين المؤقت، سيتم إجراء بحث عن الشبكة.

المَعلمات:

photoMetadata	تمثّل هذه السمة `GMSPlacePhotoMetadata` المطلوب تحميل `UIImage` إليه.
رد الاتصال	يشير هذا المصطلح إلى معاودة الاتصال لاستدعاءها باستخدام `UIImage` المحمَّل.

- (فارغ) loadPlacePhoto:	(GMSPlacePhotoMetadata *)	photoMetadata
constrainedToSize:	(CGSize)	maxSize
المقياس:	(CGFloat)	المقياس
رد الاتصال:	(GMSPlacePhotoImageResultCallback)	معاودة الاتصال

لتحميل الصورة لصورة معينة، مع تغيير حجمها لتلائم الحد الأقصى للأبعاد المحددة.

سيتم تغيير حجم الصورة لتلائم الأبعاد المحددة مع الحفاظ على نسبة العرض إلى الارتفاع للصورة الأصلية. يتم تنفيذ هذا القياس من جهة الخادم.

إذا لم تكن معلَمة المقياس هي 1.0 maxSize، سيتم ضربها في هذه القيمة، وسيتم ضبط قيمة UIImage المعروضة على المقياس المحدَّد. يجب ضبط هذه المعلمة على مقياس الشاشة في حال تحميل صور لعرضها على الشاشة.

وقد يتم تخزين بيانات الصور مؤقتًا من خلال حزمة تطوير البرامج (SDK). في حال عدم توفّر الصورة المطلوبة في ذاكرة التخزين المؤقت، سيتم إجراء بحث عن الشبكة.

ملاحظة:: بعد تطبيق عامل المقياس، سيتم تقريب الأبعاد في maxSize إلى أقرب عدد صحيح قبل الاستخدام. في حال طلب صورة بحجم أكبر من الحد الأقصى للحجم المتاح، يمكن عرض صورة أصغر حجمًا.

المَعلمات:

photoMetadata	تمثّل هذه السمة `GMSPlacePhotoMetadata` المطلوب تحميل `UIImage` إليه.
maxSize	الحد الأقصى لحجم الصورة.
المقياس	المقياس المراد تحميل الصورة فيه.
رد الاتصال	يشير هذا المصطلح إلى معاودة الاتصال لاستدعاءها باستخدام `UIImage` المحمَّل.

- (فارغ) currentPlaceWithCallback: (GMSPlaceLikelihoodListCallback) معاودة الاتصال

عرض تقدير للمكان الذي يُعرف عن وجود الجهاز فيه حاليًا.

إنشاء قائمة باحتمالية المكان استنادًا إلى آخر موقع جغرافي مقدَّر للجهاز سيتم استدعاء رد الاتصال المقدم مع قائمة الاحتمالات هذه عند النجاح، وNSError عند حدوث خطأ.

ملاحظة:: تتطلّب هذه الطريقة أن يكون لدى تطبيقك إذن بالوصول إلى الموقع الجغرافي الحالي للجهاز. قبل طلب تنفيذ هذا الإجراء، يُرجى التأكّد من طلب الوصول إلى الموقع الجغرافي للمستخدمين من خلال [CLLocationManager requestWhenInUse مفعَّلة] أو [CLLocationManager requestAlways المخصصة]. إذا تم استدعاء هذه الطريقة وكانت حالة التفويض صحيحة لتطبيقك، سيتم طلب معاودة الاتصال عن طريق الخطأ.

المَعلمات:

رد الاتصال يشير هذا المصطلح إلى رد الاتصال الذي سيتم استدعاؤه باستخدام قائمة احتمالية تحديد المكان.

- (باطل) findAutocomplete VerifyionsFromQuery:	(NSString *)	طلب البحث
الفلتر المستخدم:	(قيمة فارغة GMSAutocompleteFilter *)	فلتر
sessionToken:	(قيمة فارغة GMSAutocompleteSessionToken *)	sessionToken
رد الاتصال:	(GMSAutocompletePredictionsCallback)	معاودة الاتصال

يمكنك العثور على عبارات بحث مقترحة للإكمال التلقائي استنادًا إلى طلب بحث نصي.

قد تكون النتائج منحازة بشكل اختياري نحو موقع معين أو تقتصر على منطقة معينة. لا تؤدي هذه الطريقة إلى الحظر.

سيتم استدعاء طلب الاستدعاء المقدَّم مع مصفوفة من توقعات الإكمال التلقائي عند النجاح وخطأ NSError عند حدوث خطأ.

المَعلمات:

query	النص المطلوب إكماله تلقائيًا
تصفية	الفلتر المطلوب تطبيقه على النتائج. قد تكون هذه المعلمة معدومة.
sessionToken	`GMSAutocompleteSessionToken` لربط الطلب بجلسة فوترة
رد الاتصال	يشير هذا المصطلح إلى معاودة الاتصال التي سيتم استدعاؤها مع عبارات البحث المقترحة.

- (فارغًا) آلية getPlaceFromPlaceID:	(NSString *)	placeID
حقول الأماكن:	(GMSPlaceField)	placeFields
sessionToken:	(قيمة فارغة GMSAutocompleteSessionToken *)	sessionToken
رد الاتصال:	(GMSPlaceResultCallback)	معاودة الاتصال

استرجاع تفاصيل مكان

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:

placeID	رقم تعريف المكان المطلوب البحث فيه
placeFields	حقول الأماكن الفردية المطلوبة لعناصر الأماكن في القائمة.
sessionToken	`GMSAutocompleteSessionToken` لربط الطلب بجلسة فوترة
رد الاتصال	يشير هذا المصطلح إلى رد الاتصال المطلوب استدعاؤه مع نتيجة البحث.

ملاحظة:: تم إيقاف هذا نهائيًا. تم استبدال هذه الطريقة بـ fetchPlaceWithRequest:callback: callback: وستتم إزالتها في إصدار مستقبلي.

- (يجب ملء هذا الحقل) findPlaceLikelihosFromCurrentLocationWithPlaceFields	(GMSPlaceField)	placeFields
رد الاتصال:	(GMSPlaceLikelihoodsCallback)	معاودة الاتصال

العثور على احتمالية الأماكن باستخدام الموقع الجغرافي الحالي للمستخدم.

لا تؤدي هذه الطريقة إلى الحظر.

سيتم استدعاء رد الاتصال المقدم مع مصفوفة من الأماكن مع درجات الاحتمال عند النجاح وخطأ NSError عند حدوث خطأ.

المَعلمات:

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

- (فارغ) isOpenWithRequest:	(GMSPlaceIsOpenRequest *)	isOpenRequest
رد الاتصال:	(GMSPlaceOpenStatusResponseCallback)	معاودة الاتصال

الحصول على حالة "مفتوح" لمكان، بما في ذلك جميع الخصائص اللازمة لتحديد GMSPlaceOpenStatus في NSDate المحدد. لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:

isOpenRequest	تشير هذه السمة إلى طلب تحديد حالة "مفتوح" لمكان معيّن.
رد الاتصال	يشير هذا المصطلح إلى معاودة الاتصال التي سيتم استدعاؤها مع استجابة الحالة "مفتوحة".

- (فارغ) isOpenWithPlaceID:	(NSString *)	placeID
رد الاتصال:	(GMSPlaceOpenStatusCallback)	معاودة الاتصال

يحصل على حالة "مفتوح" لمكان، بما في ذلك جميع الحقول اللازمة لتحديد GMSPlaceOpenStatus في الوقت الحالي.

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:

placeID	رقم تعريف المكان المطلوب البحث فيه
رد الاتصال	معاودة الاتصال لاستدعاءها مع نتيجة المكان.

- (فارغ) isOpenWithPlaceID:	(NSString *)	placeID
التاريخ:	(NSDate *)	تاريخ
رد الاتصال:	(GMSPlaceOpenStatusCallback)	معاودة الاتصال

يحصل على حالة "مفتوح" لمكان، بما في ذلك جميع الحقول اللازمة لتحديد GMSPlaceOpenStatus في NSDate المحدد.

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:

placeID	رقم تعريف المكان المطلوب البحث فيه
التاريخ	تمثّل هذه السمة `NSDate` لتحديد حالة "مفتوح".
رد الاتصال	معاودة الاتصال لاستدعاءها مع نتيجة المكان.

- (فارغ) isOpenWithPlace:	(GMSPlace *)	المكان
رد الاتصال:	(GMSPlaceOpenStatusCallback)	معاودة الاتصال

يحصل على حالة "مفتوح" لمكان، بما في ذلك جميع الحقول اللازمة لتحديد GMSPlaceOpenStatus في الوقت الحالي.

لا تطلب الحقول الإضافية إلا إذا كان GMSPlace لا يحتوي على جميع الحقول اللازمة، وإلّا سيتم عرض GMSPlaceOpenStatus في معاودة الاتصال على الفور. لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:

مكان	`GMSPlace` المطلوب البحث فيه.
رد الاتصال	معاودة الاتصال لاستدعاءها مع نتيجة المكان.

- (فارغ) isOpenWithPlace:	(GMSPlace *)	المكان
التاريخ:	(NSDate *)	تاريخ
رد الاتصال:	(GMSPlaceOpenStatusCallback)	معاودة الاتصال

للحصول على تفاصيل عن مكان، بما في ذلك جميع الحقول اللازمة لتحديد GMSPlaceOpenStatus في NSDate المحدّد

لا يتم طلب حقول إضافية إلا إذا كان GMSPlace لا يحتوي على جميع الحقول اللازمة، وبخلاف ذلك، GMSPlaceOpenStatus\ will be returned in the callback immediately. This method is non-blocking.


Parameters:

  
    place The GMSPlace to lookup. 
    date The NSDate to determine open status for. 
    callback The callback to invoke with the place result.

- (باطل) searchByTextWithRequest:	(GMSPlaceSearchByTextRequest *)	textSearchRequest
رد الاتصال:	(GMSPlaceSearchByTextResultCallback)	معاودة الاتصال

البحث عن الأماكن حسب النص والقيود

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:

textSearchRequest	`GMSPlaceSearchByTextRequest` هو النص المطلوب استخدامه لطلب البحث.
رد الاتصال	يشير هذا المصطلح إلى رد الاتصال المطلوب استدعاؤه مع نتيجة البحث.

- (باطل) getPlaceWithRequest:	(GMSFetchPlaceRequest *)	fetchPlaceRequest
رد الاتصال:	(GMSPlaceResultCallback)	معاودة الاتصال

الحصول على مكان باستخدام كائن طلب.

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:

fetchPlaceRequest	`GMSFetchPlaceRequest` هو طلب استرجاع البيانات لاستخدامه في طلب البحث.
رد الاتصال	معاودة الاتصال لاستدعاءها مع نتيجة المكان.

- (باطل) جلبPhotoWithRequest:	(GMSFetchPhotoRequest *)	fetchPhotoRequest
رد الاتصال:	(GMSFetchPhotoResultCallback)	معاودة الاتصال

اطلب صورة باستخدام طلب جلب الصورة.

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:

fetchPhotoRequest	`GMSFetchPhotoRequest` طلب استخدام الصورة.
رد الاتصال	يشير هذا المصطلح إلى معاودة الاتصال التي سيتم استدعاؤها مع نتيجة `NSURL`.

- (خالية) searchفينWithRequest:	(GMSPlaceSearchNearbyRequest *)	searchNearbyRequest
رد الاتصال:	(GMSPlaceSearchNearbyResultCallback )	معاودة الاتصال

ابحث عن أماكن بالقرب من أحد المواقع الجغرافية والقيود المفروضة.

لا تؤدي هذه الطريقة إلى الحظر.

المَعلمات:

searchNearbyRequest	`GMSPlaceSearchNearbyRequest` طلب البحث في الأماكن القريبة لاستخدامه في طلب البحث.
رد الاتصال	يشير هذا المصطلح إلى رد الاتصال المطلوب استدعاؤه مع نتيجة البحث.

- (typedef null(^ GMSPlaceResultCallback)(GMSPlace *_Nullable result, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لتلقّي عمليات البحث عن تفاصيل المكان.

في حالة حدوث خطأ، ستكون القيمة result لا شيء وسيحتوي الحقل error على معلومات حول الخطأ.

المَعلمات:

نتيجة	`GMSPlace` الذي تم إرجاعه
خطأ	الخطأ الذي حدث، إن وجد.

- (typedef null(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_NullableabilitiesList, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لتلقّي قوائم احتمالية الأماكن.

في حالة حدوث خطأ، ستكون القيمة likelihoodList لا شيء وسيحتوي الحقل error على معلومات حول الخطأ.

المَعلمات:

likelihoodList	قائمة احتمالية الأماكن.
خطأ	الخطأ الذي حدث، إن وجد.

- (typedef null(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_Nullable جوالs, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لتلقّي مصفوفة GMSPlaceLikelihood.

في حال حدوث خطأ، ستكون الصفيفة فارغة، وستحتوي السمة error على معلومات حول الخطأ.

- (typedef null(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لتلقّي نتائج الإكمال التلقائي.

results هي مصفوفة من GMSAutocompletePrompts تمثل الإكمالات المرشحة لطلب البحث.

المَعلمات:

النتائج	مصفوفة من `GMSAutocompletePrediction`.
خطأ	الخطأ الذي حدث، إن وجد.

- (typedef null(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Nullable photos, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لتلقّي نتائج صور الأماكن.

في حالة حدوث خطأ، ستكون القيمة photos لا شيء وسيحتوي الحقل error على معلومات حول الخطأ.

المَعلمات:

صور	النتيجة التي تحتوي على `GMSPlacePhotoMetadata` عنصر.
خطأ	الخطأ الذي حدث، إن وجد.

- (typedef null(^ GMSPlacePhotoImageResultCallback)(UIImage *_Nullable image, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لتلقّي UIImage عناصر من عنصر GMSPlacePhotoMetadata.

في حالة حدوث خطأ، ستكون القيمة photo لا شيء وسيحتوي الحقل error على معلومات حول الخطأ.

المَعلمات:

صورة	`UIImage` الذي تم تحميله.
خطأ	الخطأ الذي حدث، إن وجد.

- (typedef باطلة(^ GMSPlaceOpenStatusCallback)(نتيجة GMSPlaceOpenStatus, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لتلقي حالة ساعات العمل للمكان.

إذا حدث خطأ، ستكون قيمة result هي GMSPlaceOpenStatusUnknown، وستحتوي error على معلومات حول الخطأ.

المَعلمات:

نتيجة	`GMSPlaceOpenStatus` الذي تم إرجاعه
خطأ	الخطأ الذي حدث، إن وجد.

- (typedef null(^ GMSPlaceOpenStatusResponseCallback)(GMSPlaceIsOpenResponse *response, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لتلقي استجابة الحالة "مفتوح".

في حال حدوث خطأ، ستظهر حالة الاستجابة GMSPlaceOpenStatusUnknown للاستجابة وسيحتوي الخطأ على معلومات حول الخطأ.

المَعلمات:

رد	`GMSPlaceIsOpenResponse` الذي تم إرجاعه
خطأ	الخطأ الذي حدث، إن وجد.

- (typedef null(^ GMSPlaceSearchByTextResultCallback)(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لتلقّي البحث حسب النتائج النصية.

results هو مصفوفة من GMSPlace تمثل النتائج الفردية المطابقة لطلب البحث.

المَعلمات:

النتائج	مصفوفة من `GMSPlace`.
خطأ	الخطأ الذي حدث، إن وجد.

- (typedef null(^ GMSFetchPhotoResultCallback)(UIImage *_Nullable imageImage, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لتلقّي صورة.

photoImage هو UIImage يمثّل الصورة الناتجة المطابقة للطلب المحدّد. في حالة حدوث خطأ، ستكون القيمة photoImage لا شيء وسيحتوي الحقل error على معلومات حول الخطأ.

المَعلمات:

photoImage نتيجة UIImage

- (typedef null(^ GMSAutocompleteSuggestionsCallback)(NSArray< GMSAutocompleteSuggestion * > *_Nullable results, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لنتائج الإكمال التلقائي.

المَعلمات:

النتائج	مصفوفة من `GMSAutocompleteSuggestion`.
خطأ	الخطأ الذي حدث، إن وجد.

- (typedef null(^ GMSPlaceSearchNearbyResultCallback)(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)) [related]

نوع معاودة الاتصال لتلقّي نتائج البحث في الأماكن القريبة.

المَعلمات:

مكان	مصفوفة `GMSPlace`
خطأ	الخطأ الذي حدث، إن وجد.

place	The `GMSPlace` to lookup.
date	The `NSDate` to determine open status for.
callback	The callback to invoke with the place result.

مرجع فئة GMSPlacesClient

نظرة عامة

الوظائف العامة

الوظائف الأساسية الثابتة للأعضاء

الدوال ذات الصلة

المستندات الخاصة بوظائف الأعضاء

وثائق الأصدقاء والوظائف ذات الصلة