نظرة عامة
اطلب استخدام كائن مع GMSPlacesClient لجلب الأماكن المجاورة.
الوظائف العامة | |
| (instancetype) | - initWithLocationRestriction:placeProperties: |
يضفي مثيلاً على GMSPlaceSearchNearbyRequest مع قيود الموقع الجغرافي وخصائص المكان المراد عرضها. | |
أماكن إقامة | |
| id< GMSPlaceLocationRestriction > | locationRestriction |
| الإعداد التلقائي غير متاح. | |
| NSArray< GMSPlaceProperty > * | placeProperties |
مصفوفة GMSPlaceProperty التي يجب تضمينها في نتائج المكان. | |
| NSArray< NSString * > * | includedTypes |
| مصفوفة أنواع الأماكن المطلوب تضمينها في البحث. | |
| NSArray< NSString * > * | excludedTypes |
| مصفوفة أنواع الأماكن المطلوب استبعادها من البحث. | |
| NSArray< NSString * > * | includedPrimaryTypes |
| مصفوفة أنواع الأماكن الأساسية المطلوب تضمينها في البحث. | |
| NSArray< NSString * > * | excludedPrimaryTypes |
| مصفوفة أنواع الأماكن الأساسية المطلوب استبعادها من عملية بحث. | |
| NSInteger | maxResultCount |
الحد الأقصى لعدد النتائج البالغ GMSPlace المطلوب عرضها. | |
| NSString * | regionCode |
| رمز البلد/المنطقة بترميز يونيكود (CLDR) للموقع الجغرافي الذي صدر منه الطلب. | |
| GMSPlaceSearchNearbyRankPreference | rankPreference |
تمثّل هذه السمة GMSPlaceSearchNearbyRankPreference المستخدَم لترتيب النتائج التي يعرضها الطلب. | |
المستندات الخاصة بوظائف الأعضاء
| - (instancetype) initWithLocationRestriction: | (id< GMSPlaceLocationRestriction >) | locationRestriction | |
| placeProperties: | (NSArray< GMSPlaceProperty > *) | placeProperties | |
يضفي مثيلاً على GMSPlaceSearchNearbyRequest مع قيود الموقع الجغرافي وخصائص المكان المراد عرضها.
- المَعلمات:
-
locationRestriction المنطقة المطلوب البحث عنها محددة كدائرة، ومحددة بنقطة مركزية ونصف قطرها بالمتر. placeProperties مصفوفة GMSPlacePropertyالتي يجب تضمينها في نتائج المكان. يجب ألا يكون الحقل فارغًا. ستؤدي القائمة الفارغة إلى حدوث خطأ عند محاولة إرسال الطلب.
وثائق العقارات
- (id<GMSPlaceLocationRestriction>) locationRestriction [read, write, copy] |
الإعداد التلقائي غير متاح.
يُرجى استخدام أداة الإعداد المحدّدة. المنطقة المطلوب البحث عنها محددة كدائرة، ومحددة بنقطة مركزية ونصف قطرها بالمتر. يجب أن يكون النطاق الجغرافي بين 0.0 و50000.0 بشكل شامل. سيؤدي تجاوز هذا القيد إلى حدوث خطأ INSERT_SELECTED. يجب تحديد locationRestriction مع GMSPlaceCircularLocationOption. سيؤدي استخدام GMSPlaceRectangularLocationOption إلى حدوث خطأ ضياء_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 نوعًا. إذا تم تحديد طلب مع قيود أنواع متعددة، فلن يتم عرض سوى الأماكن التي تفي بجميع القيود. في حال تحديد أنواع متعارضة (مثل الأنواع التي تظهر في partnerTypes وexcludedTypes)، سيتم عرض خطأ ضياء_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]
|
مصفوفة أنواع الأماكن الأساسية المطلوب استبعادها من عملية بحث.
في حال تحديد أنواع متعارضة (مثل الأنواع التي تظهر في partnerTypes وexcludedTypes)، سيتم عرض خطأ ضياء_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 لمعرفة رموز المناطق.
- (GMSPlaceSearch nearbyRankPreference) rankPreference [read, write, assign]
|
تمثّل هذه السمة GMSPlaceSearchNearbyRankPreference المستخدَم لترتيب النتائج التي يعرضها الطلب.
تكون القيمة التلقائية GMSPlaceSearchNearbyRankPopularity.