مَعلمات الفلترة

يمكنك تطبيق فلاتر على دوال Places Count باستخدام المَعلمات الموضّحة في الجدول أدناه. يُرجى العِلم أنّ المَعلمات المطلوبة تختلف لكل دالة:

يكون اسم الفلتر وقيمته حسّاسَين لحالة الأحرف. ويجب تحديدها تمامًا كما تظهر في الجدول. وفي حال عدم توفّرها، سيعرض الاستعلام خطأ في الوسيطة.

اسم الفلتر الوصف النوع القيم المسموح بها
geography

بالنسبة إلى PLACES_COUNT وPLACES_COUNT_PER_TYPE وPLACES_COUNT_PER_H3

تحدّد هذه السمة منطقة للبحث. يتوافق هذا الحقل مع أي نوع من GEOGRAPHY، مثل Point وLineString وPolygon.

يمكنك استخدام المَعلمة geography مع geography_radius لإضافة منطقة احتياطية إلى منطقة البحث.

يتم فرض حد أدنى لمساحة البحث يبلغ 40.0 مترًا في 40.0 مترًا (1600 متر مربع). إذا حدّدت مساحة بحث أقل من هذا الحد، ستعرض الدالة خطأ في الوسيطة غير الصالحة.

 GEOGRAPHY أي نوع من GEOGRAPHY
geographies

لـ "PLACES_COUNT_PER_GEO" فقط

تحدّد هذه السمة قائمة بالمناطق المطلوب البحث فيها. يمكن استخدام أي نوع من GEOGRAPHY، مثل Point وLineString وPolygon.

يمكنك استخدام المَعلمة geographies مع geography_radius لإضافة منطقة احتياطية إلى منطقة البحث. تتم إضافة المنطقة الاحتياطية إلى جميع المناطق الجغرافية المحدّدة.

يتم فرض حد أدنى لمساحة البحث يبلغ 40.0 مترًا في 40.0 مترًا (1600 متر مربع). إذا حدّدت مساحة بحث أقل من هذا الحد، ستعرض الدالة خطأ في الوسيطة غير الصالحة.

 ARRAY<GEOGRAPHY> أي نوع من GEOGRAPHY
geography_radius

تضيف هذه السمة نطاقًا جغرافيًا أو منطقة عازلة، بالأمتار، إلى الموقع الجغرافي المحدّد. القيمة التلقائية هي 0.

يجب أن تحدّد القيمة المحدّدة الحدّ الأدنى لمساحة البحث، أي 40.0 مترًا في 40.0 مترًا (1600 متر2). على سبيل المثال، بالنسبة إلى منطقة جغرافية Point، يبلغ الحد الأدنى لنصف القطر 23 مترًا.

 INT64 الحد الأدنى هو 0.
h3_resolution

لـ "PLACES_COUNT_PER_H3" فقط

تشير إلى دقة H3 المستخدَمة لتجميع عدد الأماكن في خلايا H3.

 INT64 بين 0 و11
types

تحدّد هذه السمة أنواع الأماكن التي يجب أخذها في الاعتبار.

يحتوي كل مكان على مجموعة من أنواع الأماكن، مثل "restaurant" و"cafe". في حال عدم تحديد أي أنواع، سيتم أخذ جميع أنواع الأماكن في الاعتبار في النتيجة.

 ARRAY<STRING>

للاطّلاع على القائمة الكاملة بالقيم المحتملة، راجِع أنواع الأماكن.

مثال:

["restaurant", "cafe", "bar"]
primary_types

تحدّد هذه السمة الأنواع الأساسية التي يجب أخذها في الاعتبار.

يمكن أن يكون للمكان نوع أساسي واحد فقط، وهو النوع الذي يصف الموقع الجغرافي على أفضل وجه.

في حال عدم تحديد أي أنواع أساسية، سيتم أخذ جميع الأنواع الأساسية للأماكن في الاعتبار ضمن النتيجة.

 ARRAY<STRING>

للاطّلاع على القائمة الكاملة بالقيم المحتملة، راجِع أنواع الأماكن.

مثال:

["restaurant", "cafe", "bar"]
min_rating تحدّد هذه السمة الحدّ الأدنى لتقييم المكان المطلوب أخذه في الاعتبار.

يستند تقييم الأماكن إلى مراجعات المستخدمين للمكان ويتراوح بين 1.0 و5.0

إذا حدّدت تقييمًا خارج هذا النطاق، ستعرض الدالة خطأ في الوسيطة غير الصالحة.

 FLOAT بين 1.0 و5.0
max_rating

تحدّد هذه السمة الحدّ الأقصى لتقييم المكان الذي يجب أخذه في الاعتبار.

يستند تقييم الأماكن إلى مراجعات المستخدمين للمكان ويتراوح بين 1.0 و5.0

إذا حدّدت تقييمًا خارج هذا النطاق، ستعرض الدالة خطأ في الوسيطة غير الصالحة.

 FLOAT بين 1.0 و5.0
min_user_rating_count

تحدّد هذه السمة الحد الأدنى لعدد تقييمات المستخدمين التي يجب أخذها في الاعتبار.

عدد تقييمات المستخدمين هو إجمالي عدد المراجعات التي حصل عليها المكان.

الحد الأدنى للقيمة هو 0. إذا حدّدت قيمة أقل من 0، ستعرض الدالة خطأ في الوسيطة غير صالحة.

 INT64 الحد الأدنى للقيمة هو 0.
max_user_rating_count

تحدّد هذه السمة الحدّ الأقصى لعدد تقييمات المستخدمين التي يجب أخذها في الاعتبار.

عدد تقييمات المستخدمين هو إجمالي عدد المراجعات التي حصل عليها المكان.

الحد الأدنى للقيمة هو 0. إذا حدّدت قيمة أقل من 0، ستعرض الدالة خطأ في الوسيطة غير صالحة.

 INT64 الحد الأدنى للقيمة هو 0.
price_level

تحدّد هذه السمة مستويات الأسعار التي يجب أخذها في الاعتبار.

يمكنك تحديد مستويات أسعار متعددة.

 ARRAY<STRING>

القيم المسموح بها:

"PRICE_LEVEL_FREE"

"PRICE_LEVEL_INEXPENSIVE"

"PRICE_LEVEL_MODERATE"

"PRICE_LEVEL_EXPENSIVE"

"PRICE_LEVEL_VERY_EXPENSIVE"

مثال:

["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status تحدّد هذه السمة حالة المؤسسة التي يجب أخذها في الاعتبار. يمكنك تحديد حالات المؤسسة المتعددة. ARRAY<STRING>

القيم المسموح بها:

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

"FUTURE_OPENING"

مثال:

["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout تأخذ في الاعتبار الأماكن التي تقدّم طعامًا سفريًا. BOOLEAN ‫TRUE، FALSE
delivery تأخذ هذه السمة في الاعتبار الأماكن التي تقدّم خدمة توصيل الطلبات. BOOLEAN ‫TRUE، FALSE
dine_in تعرض هذه الفئة الأماكن التي تتيح الجلوس في المطعم. BOOLEAN ‫TRUE، FALSE
curbside_pickup يأخذ في الاعتبار الأماكن التي توفّر خدمة استلام الطلبات من السيارة. BOOLEAN ‫TRUE، FALSE
reservable اختَر أماكن يمكن حجزها. BOOLEAN ‫TRUE، FALSE
outdoor_seating يأخذ في الاعتبار الأماكن التي توفّر مساحة جلوس في الهواء الطلق. BOOLEAN ‫TRUE، FALSE
live_music تأخذ هذه السمة في الاعتبار الأماكن التي تقدّم عروض موسيقى حية. BOOLEAN ‫TRUE، FALSE
allows_dogs ابحث عن أماكن تسمح باصطحاب الكلاب. BOOLEAN ‫TRUE، FALSE
restroom تأخذ هذه الفئة في الاعتبار الأماكن التي توفّر دورات مياه. BOOLEAN ‫TRUE، FALSE
serves_breakfast تأخذ هذه السمة في الاعتبار الأماكن التي تقدّم وجبة الفطور. BOOLEAN ‫TRUE، FALSE
serves_lunch تعرض هذه السمة الأماكن التي تقدّم الغداء. BOOLEAN ‫TRUE، FALSE
serves_dinner تعرض هذه السمة الأماكن التي تقدّم العشاء. BOOLEAN ‫TRUE، FALSE
serves_beer تعرض هذه السمة الأماكن التي تقدّم البيرة. BOOLEAN ‫TRUE، FALSE
serves_wine تأخذ هذه السمة في الاعتبار الأماكن التي تقدّم النبيذ. BOOLEAN ‫TRUE، FALSE
serves_brunch يأخذ في الاعتبار الأماكن التي تقدّم وجبات الإفطار المتأخر. BOOLEAN ‫TRUE، FALSE
serves_vegetarian_food تأخذ هذه السمة في الاعتبار الأماكن التي تقدّم مأكولات نباتية. BOOLEAN ‫TRUE، FALSE
serves_cocktails تُستخدَم للبحث عن الأماكن التي تقدّم مشروبات الكوكتيل. BOOLEAN ‫TRUE، FALSE
serves_dessert تأخذ هذه السمة في الاعتبار الأماكن التي تقدّم الحلويات. BOOLEAN ‫TRUE، FALSE
serves_coffee تعرض هذه السمة الأماكن التي تقدّم القهوة. BOOLEAN ‫TRUE، FALSE
menu_for_children تُستخدَم لتحديد الأماكن التي تقدّم قوائم طعام للأطفال. BOOLEAN ‫TRUE، FALSE
good_for_children ابحث عن أماكن مناسبة للأطفال. BOOLEAN ‫TRUE، FALSE
good_for_groups ابحث عن أماكن مناسبة للمجموعات. BOOLEAN ‫TRUE، FALSE
good_for_watching_sports ننصحك باختيار أماكن مناسبة لمشاهدة الألعاب الرياضية. BOOLEAN ‫TRUE، FALSE
accepts_credit_cards ننصحك باختيار أماكن تقبل بطاقات الائتمان. BOOLEAN ‫TRUE، FALSE
accepts_debit_cards ابحث عن الأماكن التي تقبل بطاقات السحب الآلي. BOOLEAN ‫TRUE، FALSE
accepts_cash_only ضَع في اعتبارك الأماكن التي تقبل الدفع نقدًا فقط. BOOLEAN ‫TRUE، FALSE
accepts_nfc ابحث عن الأماكن التي تقبل الدفعات من خلال الاتصال القصير المدى (NFC). BOOLEAN ‫TRUE، FALSE
free_parking_lot تعرض هذه السمة الأماكن التي توفّر موقف سيارات مجانيًا. BOOLEAN ‫TRUE، FALSE
paid_parking_lot تأخذ هذه السمة في الاعتبار الأماكن التي توفّر موقف سيارات برسوم. BOOLEAN ‫TRUE، FALSE
free_street_parking تعرض هذه السمة الأماكن التي توفّر مواقف سيارات مجانية في الشارع. BOOLEAN ‫TRUE، FALSE
paid_street_parking تعرض هذه الفئة الأماكن التي توفّر مواقف سيارات في الشارع برسوم. BOOLEAN ‫TRUE، FALSE
valet_parking تأخذ هذه السمة في الاعتبار الأماكن التي توفّر خدمة صفّ السيارات. BOOLEAN ‫TRUE، FALSE
free_garage_parking تأخذ هذه السمة في الاعتبار الأماكن التي توفّر مواقف مجانية للسيارات. BOOLEAN ‫TRUE، FALSE
paid_garage_parking تعرض هذه الفئة الأماكن التي توفّر مواقف سيارات برسوم. BOOLEAN ‫TRUE، FALSE
wheelchair_accessible_parking تأخذ هذه السمة في الاعتبار الأماكن التي تتوفّر فيها مواقف سيارات مناسبة لأصحاب الكراسي المتحرّكة. BOOLEAN ‫TRUE، FALSE
wheelchair_accessible_entrance تأخذ هذه الفئة في الاعتبار الأماكن التي تتوفّر فيها مداخل صالحة للكراسي المتحركة. BOOLEAN ‫TRUE، FALSE
wheelchair_accessible_restroom تُستخدَم لتحديد ما إذا كان المكان يوفّر دورة مياه مناسبة لأصحاب الكراسي المتحرّكة. BOOLEAN ‫TRUE، FALSE
wheelchair_accessible_seating يأخذ في الاعتبار الأماكن التي تتوفّر فيها أماكن جلوس مناسبة لأصحاب الكراسي المتحرّكة. BOOLEAN ‫TRUE، FALSE