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

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

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

اسم الفلتر الوصف النوع القيم المسموح بها
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 و8
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"

مثال:

["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"