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

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

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

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