نظرة عامة

يمثل تعريف طلب البحث النصي الذي سيتم إرساله عبر GMSPlacesClient.

الوظائف العامة
(instancetype)	- initWithTextQuery:placeProperties:
	ينشئ مثيل `GMSPlaceSearchByTextRequest` مع طلب بحث نصي وخصائص المكان المطلوب عرضها.
أماكن إقامة
NSString *	includedType
	الإعداد التلقائي غير متاح.
تدخُّل دفاعي	maxResultCount
	الحد الأقصى لعدد النتائج المطلوب عرضها.
عدد عائم	minRating
	الحد الأدنى لمتوسط تقييم المستخدمين للأماكن التي سيتم تضمينها في النتائج.
قيمة منطقية	isOpenNow
	فلترة النتائج حسب الأماكن المفتوحة حاليًا
NSArray< GMSPlaceProperty > *	placeProperties
	مصفوفة `GMSPlaceProperty` التي يجب تضمينها في نتائج المكان.
NSArray< NSNumber * > *	priceLevels
	مصفوفة من قيم `GMSPlacesPriceLevel` التي يجب أن تؤدي إلى فلترة الأماكن المضمّنة في النتائج.
GMSPlaceSearchByTextRankPreference	rankPreference
	تمثّل هذه السمة `GMSPlaceSearchByTextRankPreference` المستخدَم لترتيب النتائج التي يعرضها الطلب.
NSString *	regionCode
	رمز البلد/المنطقة بترميز يونيكود (CLDR) للموقع الجغرافي الذي صدر منه الطلب.
قيمة منطقية	isStrictTypeFiltering
	تحدِّد هذه السياسة ما إذا كان يجب عرض نتائج `includedType` فقط.
NSString *	textQuery
	طلب البحث النصي الخاص بعملية البحث.
id< GMSPlaceLocationBias >	locationBias
	المنطقة المتحيزة للبحث.
id< GMSPlaceLocationRestriction >	locationRestriction
	المنطقة المحظورة للبحث.

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

- (instancetype) initWithTextQuery:	(NSString *)	textQuery
placeProperties:	(NSArray< GMSPlaceProperty > *)	placeProperties

ينشئ مثيل GMSPlaceSearchByTextRequest مع طلب بحث نصي وخصائص مكان لعرضها.

المَعلمات:

textQuery	استعلام السلسلة لطلب البحث.
placeProperties	مصفوفة `GMSPlaceProperty` التي يجب تضمينها في نتائج المكان. يجب ألا يكون الحقل فارغًا. ستؤدي القائمة الفارغة إلى حدوث خطأ عند محاولة إرسال الطلب.

وثائق العقارات

- (NSString*) includedType [read, write, copy]

الإعداد التلقائي غير متاح.

يُرجى استخدام أداة الإعداد المحدّدة. نوع المكان المطلوب

يمكنك الانتقال إلى https://developers.google.com/maps/documentation/places/web-service/search-textual#supported-types للاطّلاع على أحدث قائمة بالأنواع المتاحة.

- (int) maxResultCount [read, write, assign]

الحد الأقصى لعدد النتائج المطلوب عرضها.

يسمح بالقيم بين 1 و20.

يمكن العثور على النطاق المسموح به لهذا الحقل على https://developers.google.com/maps/documentation/places/web-service/search-textual#maxresultcount.

يتم ضبط القيمة تلقائيًا على الحدّ الأقصى.

- (عدد عائم) minRating [read, write, assign]

الحد الأدنى لمتوسط تقييم المستخدمين للأماكن التي سيتم تضمينها في النتائج.

سيكون التقييم ضمن نطاق يتراوح بين 0.0 و5.0.

وسيتم تقريب التقييم المحدّد إلى أقرب 0.5. الاطّلاع على خاصية تقييم "GMSPlace"

وتكون القيمة التلقائية هي 0.0.

- (منطقي) isOpenNow [read, write, assign]

فلترة النتائج حسب الأماكن المفتوحة حاليًا

وتكون القيمة التلقائية هي "صحيح".

- (NSArray<GMSPlaceProperty>*) placeProperties [read, assign]

مصفوفة GMSPlaceProperty التي يجب تضمينها في نتائج المكان.

- (NSArray<NSNumber *>*) priceLevels [read, write, assign]

مصفوفة من قيم GMSPlacesPriceLevel التي يجب أن تؤدي إلى فلترة الأماكن المضمّنة في النتائج.

يمكن اختيار أي مجموعة من مستويات الأسعار. القيمة التلقائية هي كل مستويات الأسعار.

- (GMSPlaceSearchByTextRankPreference) rankPreference [read, write, assign]

تمثّل هذه السمة GMSPlaceSearchByTextRankPreference المستخدَم لترتيب النتائج التي يعرضها الطلب.

- (NSString*) regionCode [read, write, copy]

رمز البلد/المنطقة بترميز يونيكود (CLDR) للموقع الجغرافي الذي صدر منه الطلب.

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

يمكنك الاطّلاع على https://unicode.org/cldr/charts/latest/supplemental/territory_containment_un_m_49.html لمعرفة رموز المناطق.

- (BOOL) isStrictTypeFiltering [read, write, assign]

تحدِّد هذه السياسة ما إذا كان يجب عرض نتائج includedType فقط.

القيمة التلقائية هي "خطأ".

- (NSString*) textQuery [read, copy]

طلب البحث النصي الخاص بعملية البحث.

- (id<GMSPlaceLocationBias>) locationBias [read, write, assign]

المنطقة المتحيزة للبحث.

يعمل هذا الموقع بمثابة تحيز، مما يعني أن هناك تفضيلاً للنتائج في الموقع المحدد.

يجب تحديد locationRestrict أو locationBias عند تنفيذ طلب بحث.

وفي حال ضبطها مع locationRestriction، سيتم تجاهل هذه السياسة.

- (id<GMSPlaceLocationRestriction>) locationRestriction [read, write, assign]

المنطقة المحظورة للبحث.

يعمل هذا الموقع الجغرافي كقيود، ما يعني أنّه لن يتم عرض النتائج خارج الموقع الجغرافي المحدّد.

يجب تحديد locationRestrict أو locationBias عند تنفيذ طلب بحث.

لا يمكن استخدامه مع locationBias.

لا تتيح سمة locationRestriction للبحث النصي إلا GMSPlaceRectangularLocationOption.

مرجع الفئة GMSPlaceSearchByTextRequest

نظرة عامة

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

أماكن إقامة

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

وثائق العقارات