نظرة عامة
تُمثِّل هذه السمة تعريف طلب البحث النصي الذي سيتم إرساله عبر GMSPlacesClient
.
وظائف الأعضاء العامة | |
(instancetype) | - initWithTextQuery:placeProperties: |
إنشاء مثيل لـ GMSPlaceSearchByTextRequest باستخدام طلب بحث نصي وخصائص المكان المطلوب عرضها | |
المواقع | |
NSString * | includedType |
لا يتوفّر الإدخال التلقائي. | |
int | maxResultCount |
تمثّل هذه السمة الحد الأقصى لعدد النتائج المطلوب عرضها. | |
float | minRating |
تمثّل هذه السمة الحد الأدنى لمتوسط تقييم المستخدمين للأماكن التي سيتم تضمينها في النتائج. | |
قيمة منطقية | isOpenNow |
فلترة النتائج لعرض الأماكن المفتوحة حاليًا | |
NSArray< GMSPlaceProperty > * | placeProperties |
مصفوفة GMSPlaceProperty التي يجب تضمينها في نتائج المكان. | |
NSArray< NSNumber * > * | priceLevels |
مصفوفة من قيم GMSPlacesPriceLevel التي يجب أن تصفي الأماكن المضمّنة في النتائج. | |
GMSPlaceSearchByTextRankPreferences | 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.
- (BOOL) isOpenNow [read, write, assign] |
فلترة النتائج لعرض الأماكن المفتوحة حاليًا
يكون الإعداد التلقائي بالقيمة "صحيح".
- (NSArray<GMSPlaceProperty>*) placeProperties [read, assign] |
مصفوفة GMSPlaceProperty
التي يجب تضمينها في نتائج المكان.
- (NSArray<NSNumber *>*) priceLevels [read, write, assign] |
مصفوفة من قيم GMSPlacesPriceLevel
التي يجب أن تصفي الأماكن المضمّنة في النتائج.
ويمكن اختيار أي مجموعة من مستويات السعر، علمًا بأنّ الإعداد التلقائي هو جميع مستويات السعر.
- (GMSPlaceSearchByTextRankPreferences) 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] |
المنطقة المتحيزة للبحث.
هذا الموقع بمثابة تحيز، مما يعني أن هناك تفضيلاً للنتائج في موقع معين.
يجب ضبط locationRestriction أو locationBias عند تنفيذ طلب بحث.
في حال ضبط السياسة بالإضافة إلى locationRestriction، سيتم تجاهل ذلك.
- (id<GMSPlaceLocationRestriction>) locationRestriction [read, write, assign] |
المنطقة المحظورة للبحث.
يمثل هذا الموقع الجغرافي قيدًا مما يعني أنه لن يتم عرض النتائج خارج الموقع الجغرافي المحدّد.
يجب ضبط locationRestriction أو locationBias عند تنفيذ طلب بحث.
لا يمكن الاستخدام مع locationBias.
لا يدعم locationRestriction إلا للبحث النصي باستخدام GMSPlaceRectangularLocationOption فقط.