مرجع الفئة GMSPlaceSearchPersonalRequest

مرجع الفئة GMSPlaceSearchPersonalRequest

وظائف الأعضاء العامة

(instancetype)- initWithLocationRestriction:placeProperties:
 إنشاء مثيل GMSPlaceSearchNearbyRequest مع فرض قيود على الموقع الجغرافي وظهور خصائص أماكن لعرضها.

المواقع

id< GMSPlaceLocationRestriction > locationRestriction
 لا يتوفّر الإدخال التلقائي.
NSArray< GMSPlaceProperty > * placeProperties
 مصفوفة GMSPlaceProperty التي يجب تضمينها في نتائج المكان.
NSArray< NSString * > * includedTypes
 مصفوفة أنواع الأماكن التي يمكن تضمينها في عملية بحث.
NSArray< NSString * > * excludedTypes
 مصفوفة أنواع الأماكن المطلوب استبعادها من عملية بحث.
NSArray< NSString * > * includedPrimaryTypes
 مصفوفة أنواع الأماكن الأساسية المراد تضمينها في بحث.
NSArray< NSString * > * excludedPrimaryTypes
 مصفوفة أنواع الأماكن الأساسية المطلوب استبعادها من عملية بحث.
عدد صحيحmaxResultCount
 الحد الأقصى لعدد النتائج المطلوب عرضها من GMSPlace.
NSString * regionCode
 تمثّل هذه السمة رمز البلد أو المنطقة بترميز يونيكود (CLDR) للموقع الجغرافي الذي يأتي منه الطلب.
GMSPlaceSearchStartRankPreferencesrankPreference
 تُستخدم دالة GMSPlaceSearchNearbyRankPreference لترتيب النتائج التي تم إرجاعها من الطلب.

وثائق وظائف الأعضاء

- (instancetype) initWithLocationRestriction: (id< GMSPlaceLocationRestriction >) locationRestriction
placeProperties: (NSArray< GMSPlaceProperty > *) placeProperties

إنشاء مثيل GMSPlaceSearchNearbyRequest مع فرض قيود على الموقع الجغرافي وظهور خصائص أماكن لعرضها.

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

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

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

لا يتوفّر الإدخال التلقائي.

يُرجى استخدام أداة الإعداد المحدّدة. المنطقة المطلوب البحث عنها كدائرة، يتم تحديدها بواسطة نقطة المركز ونصف القطر بالمتر. يجب أن يتراوح النطاق الجغرافي بين 0.0 و50000.0، بشكل شامل. سيؤدي إلغاء هذا التقييد إلى ظهور خطأ POINTS_{9}. يجب تحديد locationRestriction باستخدام GMSPlaceCircularLocationOption. سيؤدي استخدام GMSPlaceRectangularLocationOption إلى ظهور خطأ POINTS_REQUEST.

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

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

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

- (NSArray<NSString *>*) includedTypes [read, write, copy]

مصفوفة أنواع الأماكن التي يمكن تضمينها في عملية بحث.

ويمكن تحديد ما يصل إلى 50 نوعًا. إذا تم تحديد طلب بقيود متعددة على الأنواع، لن يتم عرض سوى الأماكن التي تستوفي جميع هذه القيود. إذا كانت الصفيفة فارغة، فسيتم عرض جميع الأماكن بمختلف أنواعها. راجِع الجدول "أ" للحصول على قائمة بالأنواع المتوافقة https://developers.google.com/maps/documentation/places/web-service/place-types#table-a.

- (NSArray<NSString *>*) excludedTypes [read, write, copy]

مصفوفة أنواع الأماكن المطلوب استبعادها من عملية بحث.

ويمكن تحديد ما يصل إلى 50 نوعًا. إذا تم تحديد طلب بقيود متعددة على الأنواع، لن يتم عرض سوى الأماكن التي تستوفي جميع هذه القيود. في حال تحديد أنواع متعارضة (على سبيل المثال، الأنواع التي تظهر فيincludeTypes وexcludedTypes)، يتم عرض الخطأ PROGRESS_REQUEST. راجِع الجدول "أ" للحصول على قائمة بالأنواع المتوافقة https://developers.google.com/maps/documentation/places/web-service/place-types#table-a.

- (NSArray<NSString *>*) includedPrimaryTypes [read, write, copy]

مصفوفة أنواع الأماكن الأساسية المراد تضمينها في بحث.

ويمكن تحديد ما يصل إلى 50 نوعًا. إذا تم تحديد طلب بقيود متعددة على الأنواع، لن يتم عرض سوى الأماكن التي تستوفي جميع هذه القيود. لمزيد من المعلومات حول الأنواع الأساسية، يُرجى الاطّلاع على الرابط التالي: https://developers.google.com/maps/documentation/places/web-service/nearby-search#includedtypesexcludedtypes,-includedprimarytypesexcludedprimarytypes.

- (NSArray<NSString *>*) excludedPrimaryTypes [read, write, copy]

مصفوفة أنواع الأماكن الأساسية المطلوب استبعادها من عملية بحث.

في حال تحديد أنواع متعارضة (على سبيل المثال، الأنواع التي تظهر فيincludeTypes وexcludedTypes)، يتم عرض الخطأ PROGRESS_REQUEST. ويمكن تحديد ما يصل إلى 50 نوعًا. إذا تم تحديد طلب بقيود متعددة على الأنواع، لن يتم عرض سوى الأماكن التي تستوفي جميع هذه القيود. لمزيد من المعلومات حول الأنواع الأساسية، يُرجى الاطّلاع على الرابط التالي: https://developers.google.com/maps/documentation/places/web-service/nearby-search#includedtypesexcludedtypes,-includedprimarytypesexcludedprimarytypes.

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

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

يجب أن تتراوح القيمة بين 1 و20 (الخيار التلقائي). وسيؤدي إلغاء هذا التقييد إلى عرض خطأ.

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

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

للاطّلاع على رموز المناطق، يمكنك الانتقال إلى https://www.unicode.org/cldr/charts/44/supplemental/territory_language_information.html.

- (GMSPlaceSearchPersonalRankتفضيلات) rankPreference [read, write, assign]

تُستخدم دالة GMSPlaceSearchNearbyRankPreference لترتيب النتائج التي تم إرجاعها من الطلب.

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