نظرة عامة
يمثل تعريف طلب البحث النصي الذي سيتم إرساله عبر 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.